Api Design
Helps with API, design as part of developing backend services and APIs workflows.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add majiayu000-api-design npx -- -y @trustedskills/majiayu000-api-design
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"majiayu000-api-design": {
"command": "npx",
"args": [
"-y",
"@trustedskills/majiayu000-api-design"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill assists in designing APIs, focusing on clarity and usability. It can generate API specifications (like OpenAPI), suggest improvements to existing designs, and translate between different API description formats. The tool aims to streamline the API development process by automating repetitive tasks and ensuring consistency.
When to use it
- You need to create an OpenAPI specification for a new backend service.
- You want to refactor an existing API design for better maintainability.
- You're migrating an API from one description format (e.g., Swagger) to another (e.g., RAML).
- You’re looking for feedback on the clarity and consistency of your current API documentation.
Key capabilities
- Generates OpenAPI specifications
- Refines existing API designs
- Translates between API description formats
- Provides suggestions for improved usability
Example prompts
- "Generate an OpenAPI specification for a simple to-do list API with endpoints for creating, reading, updating, and deleting tasks."
- "Review this API design and suggest improvements to the endpoint naming conventions."
- "Convert this Swagger definition into RAML format."
Tips & gotchas
The quality of the generated output depends heavily on the clarity and completeness of your input. Providing detailed requirements or existing documentation 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.