Design REST or GraphQL APIs and produce OpenAPI 3.1 specifications.
npx skills add https://github.com/Jeffallan/claude-skills --skill api-designer-jeffallan
Please help me install this Agent Skill. Skill: api-designer Source: https://github.com/Jeffallan/claude-skills/tree/main/skills/api-designer Command: npx skills add https://github.com/Jeffallan/claude-skills --skill api-designer-jeffallan
This Skill guides API design, modeling, pagination, and error handling with OpenAPI specs.
Create a minimal OpenAPI spec for a Users API with pagination.
High-intent search queries and answers about installing and using this skill.
Design REST APIs by modeling resources, defining clear endpoints, and implementing standardized error handling using RFC 7807 format. Add pagination parameters to enable scalable data retrieval, version your API explicitly, and document everything in an OpenAPI 3.1 specification for developer clarity.
Structure GraphQL APIs by modeling relationships between resources, enforcing consistent naming conventions, and implementing robust pagination strategies. Generate OpenAPI 3.1 specifications and define clear versioning approaches to support API evolution while maintaining developer-friendly interfaces.
Use OpenAPI 3.1 specifications when designing new REST or GraphQL APIs to enforce REST principles, ensure consistent naming, document pagination and versioning strategies, and standardize error handling. OpenAPI serves as the source of truth for scalable, developer-friendly API contracts.
Yes. Apply API design principles to evolving contracts by modeling updated resources and relationships, defining versioning strategies that maintain backward compatibility, and updating your OpenAPI specification to reflect changes while ensuring authentication schemes and error handling remain consistent.
REST and GraphQL API design accommodates multiple authentication schemes—document your chosen approach (OAuth, API keys, JWT) in your OpenAPI 3.1 specification. Define authentication requirements consistently across endpoints and resources to establish secure, developer-friendly interfaces.
wfukatsuExtract entities, relationships, and domain rules from codebase data models.
mgd34msuGenerate TypeScript types and client SDKs from OpenAPI 3.1 specifications.
JEO-tech-aiDesign, document, and version RESTful or GraphQL APIs with OpenAPI standards.
p-o-ke-naeDesign REST and GraphQL API structures with versioning, pagination, and error handling.
