Prompt Engineering with Weaver
Good prompt ⇒ Great agent
Weaver will try its best with whatever you throw at it, but the clearer the ask, the cleaner the wiring.
Think tasks, not code ... your job is to explain specifically what you want and let Weaver do the rest.
Mind-set Shift: Describe Jobs, Not Code
Bad habit (thinking like a developer):
“Call the
summarise()
function with the weekly_sales dataset.”
Better habit (thinking like a PM):
“Summarise weekly sales data for Monday stand-up.”
More examples:
- “Translate this blog post to Spanish.”
- “Email the summary to the team every Friday at 4 PM.”
- “Resize all images in
/uploads
to 1024 px wide.”
The Universal Prompt Framework
Goal: [What you want to achieve]
Skills:
- [Skill 1]
- [Skill 2]
- …
Constraints:
- [Any mandatory formats, limits, sources]
Use Goal → Skills → Constraints every time.
Good vs Poor Prompts (Kyoto Edition)
The first prompt gives Weaver four precise blocks to assemble. The second leaves enough ambiguity to fill a Zen garden.
Advanced Examples
Weekly Sales Digest
Goal: Deliver a Monday-morning sales digest email.
Skills:
- Fetch weekly_sales.csv from S3
- Summarise trends into 5 bullet points
- Generate chart PNG
- Email to sales-team@acme.com
Constraints:
- Use “Sales Digest” as subject
- Skip weeks with less than 100 rows
Multilingual Blog Pipeline
Goal: Publish each post in EN → ES → FR.
Skills:
- Detect new post published to WordPress
- Translate Markdown to Spanish
- Translate Spanish to French
- Post translations under /es/ and /fr/
Constraints:
- Preserve Markdown formatting
- Keep code blocks untouched
Airtable → Slack Snapshot
Goal: Send daily Airtable summary to Slack.
Skills:
- Query “Tasks” base, get today’s records
- Count tasks by status
- Format a Slack message
- Post to #daily-ops
Constraints:
- Run at 17:00 UTC
- Use Slack block-kit
Prompt Debugging 101
- Locate the misbehaving component (red border).
- Click on the component and ask Weaver to fix it and explain what changed (or click Fix with AI button on the componenet):
Output missed the bullet list. Ensure summary is bullet-pointed.
- Re-run just that block with debug mode enabled and step through it, not the whole agent.
- Rinse, repeat, ship.
Still wrong? Break the skill in two. Smaller skills fail more loudly.
Cheatsheet
If you want… | Add this to Skills |
---|---|
Ranking or classification | “Classify text sentiment” |
Extraction | “Extract company names” |
Transformation | “Convert JSON to CSV” |
Messaging | “Send message to Teams channel” |
Next Up
- Practice in the playground → Build your first agent