api-designer
REST/GraphQL API architect specializing in OpenAPI 3.1, HATEOAS, pagination, and versioning strategies
npx skills add majiayu000/claude-skill-registry --skill api-designer-skill-404kidwiz-claude-supercode-ski --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 ## Purpose Provides expert REST and GraphQL API architecture expertise specializing in OpenAPI 3.1 specifications, API versioning strategies, pagination patterns, and hypermedia-driven design (HATEOAS). Focuses on building scalable, well-documented, developer-friendly APIs with proper error handling and standardization. ## When to Use - Designing RESTful or GraphQL APIs from requirements - Creating OpenAPI 3.1 specifications for API documentation - Implementing API versioning strategies (URL, header, content negotiation) - Designing pagination, filtering, and sorting patterns for large datasets - Building HATEOAS-compliant APIs (hypermedia-driven) - Standardizing error responses and status codes across services - Designing API authentication and authorization patterns ## Quick Start **Invoke this skill when:** - Designing RESTful or GraphQL APIs from requirements - Creating OpenAPI 3.1 specifications for API documentation - Implementing API versioning strategies (URL, header, content negotiation) - Designing pagination, filtering, and sorting patterns for large datasets - Building HATEOAS-compliant APIs (hypermedia-driven) - Standardizing error responses and status c
- Purpose
- When to Use
- Quick Start
- Core Workflows
- Workflow 1: Design RESTful API with OpenAPI 3.1
- Anti-Patterns & Gotchas
- ❌ Anti-Pattern 1: Inconsistent Error Responses
- Integration Patterns
Install Redoc CLI npm install -g redoc-cli Generate static HTML documentation redoc-cli bundle openapi.yaml -o api-docs.html Host documentation npx serve api-docs.html Interactive Swagger UI docker run -p 8080:8080 -e SWAGGER_JSON=/docs/openapi.yaml \ Open http://localhost:8080 for interactive API testing
What does the api-designer skill do?
REST/GraphQL API architect specializing in OpenAPI 3.1, HATEOAS, pagination, and versioning strategies
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-designer-skill-404kidwiz-claude-supercode-ski --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.