Malston Openapi Docs Generator
malston-openapi-docs-generator is a Claude Code plugin for the Build phase that generates OpenAPI/Swagger documentation from your codebase.
by malston · github.com/malston/openapi-docs-generator
Generate OpenAPI or Swagger documentation from existing code so API contracts stay accurate without hand-maintaining spec files.
Add it to Claude Code
Install the plugin in Claude Code. One command, paste-ready.
/plugin install malston-openapi-docs-generator@malston/openapi-docs-generatorBuilt to be called by your agent
Skillselion is itself an MCP server. Your agent can pull this entry and a paste-ready install config straight from the API - no copy-paste.
Retrieve this entry with skillselion.get_details("plugin:malston/openapi-docs-generator") and the paste-ready config with skillselion.get_install_config("plugin:malston/openapi-docs-generator").
What it does
malston-openapi-docs-generator is a Claude Code plugin that helps solo builders produce OpenAPI or Swagger documentation from code instead of maintaining parallel spec documents by hand. When you ship REST or HTTP APIs, stale docs break client integrations and slow validation; this plugin targets the gap between your handlers and a contract you can share with frontend work, partners, or AI agents that call your API. It is a task-oriented development tool—run generation against the codebase you are actively changing—rather than a journey-wide methodology. Typical use is mid-build after routes stabilize, before Ship-phase contract tests or Launch-phase developer portals. Pair the output with review skills or manual pass for auth, examples, and error models the generator might omit. The catalog lists one community plugin with explicit generate-openapi-from-code positioning, so expect repo-specific configuration for framework annotations or scan paths. Intermediate complexity reflects need to understand your stack’s OpenAPI export paths and where generated YAML or JSON should land in CI or docs sites.
Highlights
- Generates OpenAPI/Swagger documentation directly from application code
- Community plugin with documentation, generate, openapi, and openapiswagger keywords
- Single-plugin bundle under malston/openapi-docs-generator
- Reduces drift between implemented endpoints and published API reference
- Fits backend-heavy SaaS and CLI services exposing HTTP APIs
Why builders use it
Hand-written API specs fall behind the code, so integrators and your own agents work from wrong endpoint definitions.
After install, you can regenerate OpenAPI or Swagger artifacts from source so docs track the API you actually ship.
At a glance
- Type - Plugin in Development Tools.
- Adoption - 0 installs, 0 stars, 0 votes.
FAQ
Who is malston-openapi-docs-generator for?
Backend-focused solo builders who expose HTTP APIs and need OpenAPI or Swagger output aligned with the current code.
When should I use malston-openapi-docs-generator?
Use it during Build when endpoints change and before Ship or partner onboarding when you need an updated contract file.
How do I add malston-openapi-docs-generator to my agent?
Add the malston/openapi-docs-generator plugin in Claude Code and follow the repository README to point generation at your project’s routes or annotations.
Comments
Share how you use malston-openapi-docs-generator, gotchas, or tips for other indie builders.
No comments yet - be the first to share how you use it.