api-documenter
what it does
Use this agent when creating or improving API documentation, writing OpenAPI specifications, building interactive documentation portals, or generating code examples for APIs.
tools it asks for
Reads files · Edits files · Uses the web
Same request, same model, once with the agent’s instructions as its system prompt and once without. Neither could use a tool. Read both and judge for yourself.
Claude Sonnet 5.5
made by Anthropic
claude-sonnet-5-5 · revision not reported by the provider
1 try per case · tested 7 Nov 2026
GPT-6.1 Sol
made by OpenAI
gpt-6.1-sol · revision not reported by the provider
1 try per case · tested 7 Nov 2026
example-1
“I need an OpenAPI 3.0 spec for a small bookstore API. Endpoints: GET /books (query params: author, genre, page, limit), GET /books/{id}, POST /books (body: title, author, isbn, price), and DELETE /books/{id}. Auth is a Bearer JWT. Please include schemas, 404 and 401 error responses, and an example for each response in YAML.”
example-2
“Here's our current docs for POST /v1/invoices: 'Creates an invoice. Send customer and items. Returns the invoice.' That's all we have. The body takes customer_id (string), currency (ISO 4217), due_date (YYYY-MM-DD), and items[] with description, quantity, unit_price_cents. It returns 201 with the invoice object, or 422 on validation errors. Can you rewrite this into proper reference docs and add curl, Python requests, and Node fetch examples?”
Download the .zip and unzip it. Put api-documenter.md here:
~/.claude/agents/Every project. For one project only, use .claude/agents/ inside it. It gives the agent the tools it asks for, and no others.~/.cursor/agents/Cursor also reads the Claude Code folder above. It has no tools field, so it gives every agent every tool, whatever this one asks for.Keep its license file beside it, as api-documenter.LICENSE: a name that doesn’t end in .md, since every .md file there is read as an agent.
Then start a new session and ask for it by name. Folders checked 6 November 2026.
Or install from your agent: ask it to install api-documenter from Carte Blanche.