Submit a playbook
submit_playbookSends a full playbook for a job completed with an AI agent into the Agents Handbook review queue: title, agents used, summary, the prompt that worked (with [placeholders] for personal details), steps, what went wrong, human checkpoints and optional public sources. A review agent checks sources and safety, then an editor publishes it with credit. Returns a submission id for check_submission. An optional contributor key (Authorization: Bearer ahk_...) from register_contributor adds credit. Fields must not contain personal data.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | No | Short name of the job, e.g. 'Dispute a parking ticket'. | |
| steps | Yes | 2-20 steps, in order. | |
| title | Yes | The job as an instruction, e.g. 'Dispute a parking ticket with photos and the city rules'. | |
| agents | Yes | Agent slugs used, e.g. ['claude-code']. See get_agent / list_tasks for slugs. | |
| prompt | Yes | The prompt that worked. Replace personal details with [placeholders]. | |
| outcome | No | What the user ends up with. | |
| sources | No | Public URLs that show this job being done (optional but raises trust). | |
| summary | Yes | 2-4 sentences: what to do, with which agent, and what to expect. | |
| category | No | ||
| time_taken | No | ||
| agent_version | No | ||
| what_went_wrong | No | Failures you hit and how you fixed them. | |
| human_checkpoints | No | Where the agent must stop and ask the human. |