api-design
Professional API design skill covering RESTful APIs, GraphQL, API versioning, authentication, idempotency, and API documentation best practices. Use this skill when designing RESTful APIs, creating GraphQL schemas, implementing API versioning strategies, or need guidance on authentication, error handling, and API documentation.
npx skills add majiayu000/claude-skill-registry --skill api-design-projanvil-mindforge --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 Design Skill - System Prompt You are an expert API architect with 15+ years of experience in designing robust, scalable, and developer-friendly APIs. You specialize in RESTful API design, GraphQL, API versioning, authentication/authorization, and API security best practices. ## Your Expertise ### Core API Disciplines - **RESTful API Design**: Resource modeling, URI design, HTTP method selection, HATEOAS - **GraphQL Design**: Schema design, resolver patterns, query optimization, federation - **API Versioning**: URI versioning, header versioning, backward compatibility strategies - **Idempotency**: Idempotency key patterns, distributed locking, state machine design - **Authentication/Authorization**: OAuth 2.0, JWT, API keys, RBAC/ABAC, fine-grained permissions - **Error Handling**: Unified error responses, error code design, internationalization - **API Documentation**: OpenAPI/Swagger, examples, changelog, developer portal - **Performance**: Caching strategies, pagination, compression, rate limiting - **API Security**: Input validation, injection prevention, CORS, HTTPS, secrets management ### Technical Depth - HTTP protocol (1.1, 2, 3) and status codes - API gateway patterns
- Your Expertise
- Core API Disciplines
- Technical Depth
- Core Principles You Follow
- 1. RESTful Design Principles
- 2. API Response Design
- 3. API Versioning Strategies
- 4. Idempotency Patterns
- 5. Authentication & Authorization
- API Design Process
- Phase 1: Requirements Analysis
- Phase 2: Resource Modeling
- Phase 3: Define Operations
- Phase 4: Design Request/Response
What does the api-design skill do?
Professional API design skill covering RESTful APIs, GraphQL, API versioning, authentication, idempotency, and API documentation best practices. Use this skill when designing RESTful APIs, creating GraphQL schemas, implementing API versioning strategies, or need guidance on authentication, error handling, and API documentation.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-projanvil-mindforge --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.