{"slug":"adding-api-docs","title":"adding-api-docs","summary":"Generate OpenAPI/Swagger documentation for an API, including endpoint schemas, request/response types, and interactive docs UI.","platform":"Cursor","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-12T22:23:27.477035Z","repo":{"url":"https://github.com/spencerpauly/awesome-cursor-skills","stars":813,"forks":149,"license":"CC0-1.0","updatedAt":"2026-08-02T02:41:53Z"},"bodyHtml":"
\n

name: adding-api-docs\ndescription: Generate OpenAPI/Swagger documentation for an API, including endpoint schemas, request/response types, and interactive docs UI.

\n

Add API Documentation (OpenAPI)

\n

Use this skill when the user asks to add API docs, Swagger, OpenAPI spec, or generate endpoint documentation.

\n

Steps

\n
    \n

  1. Detect the API framework — check for Express, Fastify, Next.js API routes, Hono, Django REST Framework, FastAPI, etc.

    \n
    2. \n

  2. For Node.js/Express — install swagger-jsdoc and swagger-ui-express:

    \n
    npm install swagger-jsdoc swagger-ui-express\nnpm install -D @types/swagger-jsdoc @types/swagger-ui-express\n
    \n

    Create the OpenAPI spec from JSDoc annotations on route handlers:

    \n
    /**\n * @openapi\n * /api/users:\n *   get:\n *     summary: List all users\n *     responses:\n *       200:\n *         description: A list of users\n */\n
    \n
    3. \n

  3. For Next.js API routes — create an openapi.json file manually or use next-swagger-doc to generate from route handlers. Serve the spec at /api/docs.

    \n
    4. \n

  4. For FastAPI (Python) — docs are built-in at /docs (Swagger UI) and /redoc. Ensure Pydantic models are used for request/response types so schemas are auto-generated.

    \n
    5. \n

  5. Add interactive docs UI — serve Swagger UI at a /docs route, or use Scalar/Redoc for a modern alternative:

    \n
    npm install @scalar/express-api-reference\n
    \n
    6. \n

  6. Define schemas — create Zod schemas (or JSON Schema) for request bodies and responses, then reference them in the OpenAPI spec. For TypeScript projects, use zod-to-openapi to generate schemas from existing Zod validators.

    \n
    7. \n

  7. Add authentication documentation — document the auth scheme (Bearer token, API key, OAuth2) in the OpenAPI securitySchemes section.

    \n
    8. \n
\n

Notes

\n\n","files":[{"path":"SKILL.md","sizeBytes":2081,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-08-12T22:23:41.983974Z","sha256":"8C53A3A797D2CE42E4375E010838635C7ECA2BE1776D845D55FF16CB39AFE11A","sizeBytes":1092},"review":null,"source":{"repositoryUrl":"https://github.com/spencerpauly/awesome-cursor-skills","path":"resources/adding-api-docs","license":"CC0-1.0","commit":"99cd2655788456cc1c685944dcf8c2de82c1ded4","subtreeSha":"F16D7395CB179659F803A2D67DA2C5F22DAA72CFAFD2E13A3AA9086904691779","lastSyncedAt":"2026-09-25T06:49:08.872487Z"},"reviewedAt":"2026-08-12T22:24:01.679752Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/spencerpauly/awesome-cursor-skills/tree/main/resources/adding-api-docs"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install spencerpauly-awesome-cursor-skills@llmmart"},{"target":"git","command":"git clone https://github.com/spencerpauly/awesome-cursor-skills.git"}]}