api-documentor

Automated API documentation generation extracts endpoint details, schemas, and authentication from your codebase to produce OpenAPI/Swagger specifications and human-readable docs without manual writing. This Skill analyzes REST API and GraphQL code to generate OpenAPI 3.0 specs, GraphQL documentation, and HTML or Markdown reference guides in a single command.

Yes. This Skill generates multi-language client SDKs—Python, JavaScript/TypeScript, Go, and Java—directly from your OpenAPI specification or GraphQL schema, eliminating manual SDK maintenance and keeping all clients synchronized with your API implementation.

Regenerating documentation from your codebase ensures specs and SDKs reflect current implementation automatically. Run this Skill after API updates to produce fresh OpenAPI specs, GraphQL schemas, and client libraries without manual reconciliation, preventing documentation drift.

Yes. This Skill handles both REST APIs—generating OpenAPI/Swagger specifications and client SDKs—and GraphQL services by extracting schema definitions from resolvers and producing GraphQL documentation alongside multi-language client libraries.

You need Python 3, PyYAML for processing, and your API source code (Flask, Express, GraphQL resolvers, etc.). The Skill analyzes your code structure to extract endpoints, request/response schemas, authentication details, and error definitions for spec generation.

This Skill produces OpenAPI 3.0 specifications and outputs documentation in formats like HTML and Markdown. You can then transform or customize these standard formats using additional tools in your documentation pipeline or developer portal.