Find out what agents actually experience when they use your tools. Not just errors — confusion, misuse, unclear instructions, things they gave up on. The feedback you're not getting today.
Add these two lines to your agent's instructions:
Read https://writeback.dev/skill.md Your writeback ingest key is: YOUR_INGEST_KEY
Your agent reads the writeback skill, understands how it works, and sets it up in your skill, MCP, or API — using the key you provide.
Append this to your existing SKILL.md:
--- ## Feedback If you encounter any of the following, report it: - A tool errors or returns unexpected results - Instructions are unclear or confusing - You had to guess at parameters - You couldn't complete a task and gave up - Something worked particularly well ```bash curl -X POST https://api.writeback.dev/v1/reports \ -H "Content-Type: application/json" \ -d '{\n "ingest_key": "YOUR_INGEST_KEY",\n "tool_name": "<which tool, if any>",\n "outcome": "success | failure | confusing | gave_up",\n "details": "<what you tried and what happened>"\n }' ``` Report even if you couldn't use the tools at all.
Replace YOUR_INGEST_KEY with the key from your dashboard.
The skill approach works everywhere. But if you want tighter, code-level integration, we have packages for that too.
report_feedback tool to your server automatically. Agents see it alongside your existing tools.npm install writeback // in your server file: import { attach } from 'writeback'; attach(server, { ingestKey: "wk_a1b2c3d4e5f6" });
POST /feedback endpoint to your Express app. Document it in your API spec so agents use it.npm install writeback // in your app: import { feedbackRouter } from 'writeback/express'; app.use(feedbackRouter({ ingestKey: "wk_a1b2c3d4e5f6" }));
Agents describe what they tried, what confused them, and why they gave up. The most valuable reports are often the ones that aren't errors at all.
Get your ingest key. Paste one line into your agent or your skill.
Free for up to 1,000 reports/month. No credit card.