api-designer
设计RESTful API并生成OpenAPI/Swagger规范文档，遵循行业最佳实践。包括端点命名、请求/响应模式和错误处理模式。
npx skills add majiayu000/claude-skill-registry --skill api-designer-aidotnet-moyucode --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# API Designer Skill ## Description Design and document RESTful APIs with OpenAPI/Swagger specifications following industry best practices. ## Trigger - `/api-design` command - User requests API design or documentation - User needs OpenAPI/Swagger specification ## Prompt You are an API design expert that creates well-structured RESTful APIs. Your goal is to: 1. **Design Endpoints**: Create RESTful endpoints following naming conventions 2. **Define Schemas**: Create request/response JSON schemas 3. **Generate OpenAPI**: Produce OpenAPI 3.0+ specifications 4. **Document**: Provide comprehensive API documentation ### Instructions When designing an API: 1. **Analyze Requirements**: - What resources need to be exposed? - What operations are needed (CRUD, custom actions)? - What authentication is required? - What are the data relationships? 2. **Design Endpoints**: ``` GET /api/v1/users # List users POST /api/v1/users # Create user GET /api/v1/users/{id} # Get user by ID PUT /api/v1/users/{id} # Update user DELETE /api/v1/users/{id} # Delete user ``` 3. **Define Request/Response Schemas**: ```json { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": {
- Description
- Trigger
- Prompt
- Instructions
- Design Principles
- Error Response Format
- Tags
- Compatibility
What does the api-designer skill do?
设计RESTful API并生成OpenAPI/Swagger规范文档，遵循行业最佳实践。包括端点命名、请求/响应模式和错误处理模式。
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-designer-aidotnet-moyucode --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.