Design REST and GraphQL APIs with OpenAPI 3.1 specifications.
npx skills add https://github.com/gabi-agent/openretro --skill api-designer-gabi-agent
Please help me install this Agent Skill. Skill: api-designer Source: https://github.com/gabi-agent/openretro/tree/main/skills/api-designer Command: npx skills add https://github.com/gabi-agent/openretro --skill api-designer-gabi-agent
Designing scalable, developer-friendly REST and GraphQL APIs with comprehensive OpenAPI specifications, ensuring consistent contracts and clear versioning.
Draft a complete OpenAPI 3.1 specification for a new users service, including paths, schemas, and security definitions.
High-intent search queries and answers about installing and using this skill.
To design a REST API with OpenAPI 3.1, you define clear endpoint contracts, resource models, authentication schemas, and standardized error handling. This approach enforces compliance and ensures consistent contracts across microservices.
Versioning REST APIs requires implementing structured versioning strategies and deprecation planning for evolving endpoints. This maintains backward compatibility while allowing your public API to scale and update resource models securely.
Standardizing pagination and error handling across microservices involves applying robust patterns directly within your OpenAPI specifications. This enforces consistent contract-first API behaviors for both REST and GraphQL architectures.
Yes, you can use this approach for both GraphQL and REST resource modeling. It supports mapping resource relationships and designing authentication contracts to build scalable, developer-friendly APIs with comprehensive specifications.
Contract-first API design explicitly supports custom authentication and authorization schemas. You define these security requirements directly within your OpenAPI 3.1 specification to ensure robust access control across your endpoints.
htlin222Design backend systems with RESTful APIs, microservices, and database schemas.
rrezartprebrezaGenerate Spring-compatible controllers, DTOs, and client stubs from OpenAPI specs.
JayRHaGenerates Markdown API reference pages and validated OpenAPI 3.1 specifications from routes, controllers and live endpoints.
stephanjDesign federated GraphQL schemas with Apollo Federation and schema-first principles.
