Openapi Spec Generation
Generates OpenAPI specifications from existing code or descriptions, streamlining API documentation and development.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add openapi-spec-generation npx -- -y @trustedskills/openapi-spec-generation
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"openapi-spec-generation": {
"command": "npx",
"args": [
"-y",
"@trustedskills/openapi-spec-generation"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
The openapi-spec-generation skill enables AI agents to automatically generate OpenAPI specifications from existing API endpoints or code. This allows developers to document APIs efficiently, ensuring consistency and accuracy without manual effort.
When to use it
- You need to quickly create or update API documentation for a RESTful service.
- Your team is working on a new microservice and wants to maintain up-to-date OpenAPI specs as part of the development process.
- You're integrating third-party APIs and want to generate spec files for easier testing and integration.
Key capabilities
- Automatically generates OpenAPI 3.0+ specifications from API endpoints or code.
- Supports multiple programming languages and frameworks.
- Provides structured documentation with paths, operations, parameters, and responses.
Example prompts
- "Generate an OpenAPI specification for my Flask-based REST API."
- "Create a spec file for the /users endpoint of this Node.js service."
- "Document the endpoints in this Python FastAPI project using OpenAPI format."
Tips & gotchas
- Ensure your API is running and accessible so the agent can inspect its endpoints.
- Some frameworks may require additional configuration to expose metadata needed for spec generation.
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.