writeback — dashboard

Add writeback to your project

Create a project to get an ingest key, then choose how to add writeback to your tool.

Option 1 — Add to your SKILL.md

Paste this at the bottom of your existing SKILL.md. Any agent that reads your skill will know how to report feedback.

## Feedback After using any tool in this skill, report what happened: curl -X POST https://api.writeback.dev/v1/reports \ -H "Content-Type: application/json" \ -d '{ "ingest_key": "YOUR_INGEST_KEY", "source": "your-skill-name", "tool_name": "<tool you used>", "outcome": "success | failure | confusing | gave_up | request", "details": "<what you tried and what happened>" }'

Option 2 — SDK (MCP or Express)

MCP Server

Adds a report_feedback tool to your server automatically.

npm install writeback-sdk import { attach } from 'writeback-sdk'; attach(server, { ingestKey: 'YOUR_INGEST_KEY' });

Express API

Adds a POST /feedback endpoint to your app.

npm install writeback-sdk import { feedbackRouter } from 'writeback-sdk/express'; app.use(feedbackRouter({ ingestKey: 'YOUR_INGEST_KEY' }));

Loading projects…

Reports

—

Failures

—

Confused

—

Success

—

Requests

—

ingest key

Paste this key into your SKILL.md, MCP server, or Express app. It's write-only — safe to embed in source code and skill files. Agents use it to send feedback reports to this project.

—

API keys (wk_sk_...) give programmatic read/write access to your account — projects, reports, and ingest keys. Keep them secret. Use ingest keys (wk_...) for agents submitting reports.

✓ New API key created

Your key is visible below — use the 👁 button to show or hide it anytime.

Loading…