API Documentation

Use this skill when the work is publishing docs that developers will consume after an API contract exists.

The job is not to redesign the API or implement the backend. The job is to:

• choose the right documentation surface for the audience
• explain auth, requests, responses, errors, and limits clearly
• give developers copy-pasteable examples
• document migration and compatibility notes where they matter
• hand off contract design, auth implementation, and test strategy to sibling skills instead of blurring boundaries

Read references/doc-surface-selection.md when the request is broad and you need to choose between reference docs, guides, webhooks, or SDK coverage. Read references/publishing-and-examples.md when the task needs examples, docs portal structure, or release and migration guidance.