Agent skill · writing content · sundial-org
swagger-gen
Generate OpenAPI specs from Express routes. Use when documenting APIs.
Why this skill is useful
Generates OpenAPI specs from Express routes, providing specific domain knowledge for API documentation that the AI wouldn't reliably generate on its own.
What it needs
Requires openai account access. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Swagger Generator Your API has no documentation. This reads your Express routes and generates a complete OpenAPI 3.0 spec. One command. Zero config. Just works. Quick Start What It Does Reads your Express route files Generates OpenAPI 3.0 specification Documents request/response shapes Ready for Swagger UI Usage Examples Best Practices Keep it updated - regenerate when routes change Add descriptions - explain what endpoints do Include examples - show sample requests Document errors - not just happy paths When to Use This Creating API documentation Setting up Swagger UI Onboarding API consumers API-first design Part of the LXGIC Dev Toolkit This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work. Find more: GitHub: https://github.com/LXGIC-Studios Twitter: https://x.com/lxgicstudios Substack: https://lxgicstudios.substack.com Website: https://lxgic.dev Requirements No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAIAPIKEY environment variable. How It Works Parses your Express route definitions to extract endpoints, methods, and handler code. Then generates OpenAPI spec with proper types and descriptions. License MIT. Free forever. Use it however you want.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/swagger-gen