Api Designer
Provides API guidance and assistance for developing backend services and APIs.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add matteocervelli-api-designer npx -- -y @trustedskills/matteocervelli-api-designer
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"matteocervelli-api-designer": {
"command": "npx",
"args": [
"-y",
"@trustedskills/matteocervelli-api-designer"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill, api-designer, helps you design and document APIs. It can generate OpenAPI specifications (Swagger) from natural language descriptions or existing API documentation. The generated specifications are useful for code generation, testing, and integration with other tools.
When to use it
- You need to create an OpenAPI specification for a new API project.
- You have existing API documentation that needs to be formalized into an OpenAPI definition.
- You want to quickly prototype the structure of an API before implementation.
- You're documenting an existing API and need a standardized format.
Key capabilities
- Generates OpenAPI specifications (Swagger)
- Works from natural language descriptions
- Processes existing API documentation
Example prompts
- "Design an API endpoint for retrieving customer data, including name, email, and order history."
- "Generate an OpenAPI specification based on this document: [paste API documentation here]"
- "Create a simple API with endpoints for creating and listing products."
Tips & gotchas
The quality of the generated OpenAPI specification depends heavily on the clarity and completeness of the input description or existing documentation. Providing detailed information will yield better results.
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.