Name: API Docs Writer
Availability: InStock
Author: Agensi

See it in action

You say

Generate documentation for this Express route: router.post('/v1/billing/subscribe', auth, validate(schema), (req, res) => { ... }); The schema requires a plan_id string and email.

Your agent does

POST /v1/billing/subscribe

Creates a new subscription for a customer.

Authentication Bearer token required.

Request body | Field | Type | Required | Description | | --- | --- | --- | --- | | plan_id | string | yes | ID of the plan to subscribe to | | email | string | yes | Customer email address |

Example:

{ "plan_id": "pro_monthly", "email": "jane@example.com" }

Responses

201 Created: Subscription initialized.

{ "id": "sub_8f2", "plan_id": "pro_monthly", "status": "active" }

400 Bad Request: Validation failed for plan_id or email.
401 Unauthorized: Missing or invalid bearer token.

Example request

curl -X POST https://api.example.com/v1/billing/subscribe \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "plan_id": "pro_monthly", "email": "jane@example.com" }'

About this skill

API reference is the documentation developers most need and most hate writing, so it ends up missing, stale, or written for the person who built the API instead of the person calling it. API Docs Writer generates reference docs the consumer can actually use. Point it at route or controller code, an OpenAPI/Swagger spec, or schema definitions, and it documents each endpoint the same way — method and path, required auth, path and query parameters, the request body with a realistic example, the response shape with a real example and status code, the error codes it actually returns and what triggers each, and a copy-pasteable curl call. It opens with the base URL, auth model, and shared conventions so they are not repeated per endpoint, writes for the caller rather than the author, and never invents endpoints or behavior that are not in your source — marking unknowns as TODO. Content-only, no install. Works with Claude Code, Cursor, Codex CLI, Gemini CLI, and any SKILL.md agent.