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 phrazzld-api-design npx -- -y @trustedskills/phrazzld-api-design
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"phrazzld-api-design": {
"command": "npx",
"args": [
"-y",
"@trustedskills/phrazzld-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 based on high-level descriptions, suggest improvements to existing designs, and help ensure consistency across multiple endpoints. The goal is to produce well-documented and maintainable APIs that are easy for developers to understand and use.
When to use it
- You need to design an API from scratch and want a starting point or suggestions for best practices.
- An existing API is difficult to understand, and you'd like the skill to suggest improvements for clarity.
- You have multiple APIs and need to ensure they follow consistent naming conventions and data structures.
- You are documenting an API and require assistance in generating comprehensive specifications.
Key capabilities
- API specification generation
- Design improvement suggestions
- Consistency checks across endpoints
- Documentation assistance
Example prompts
- "Generate an OpenAPI spec for a simple weather API that provides current temperature and conditions."
- "Review this existing API endpoint description and suggest ways to improve its clarity: [paste endpoint description here]"
- “I have two APIs, one for users and one for products. Ensure they use consistent naming conventions.”
Tips & gotchas
The skill's output is best when provided with clear and concise descriptions of the desired API functionality. Be prepared to iterate on the generated specifications based on feedback from developers or stakeholders.
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.