Design REST and GraphQL API contracts with OpenAPI specifications and RFC 7807 errors.
npx skills add https://github.com/dotBeeps/hoard --skill api-design-dotbeeps
Please help me install this Agent Skill. Skill: api-design Source: https://github.com/dotBeeps/hoard/tree/main/morsels/skills/api-design Command: npx skills add https://github.com/dotBeeps/hoard --skill api-design-dotbeeps
Designing APIs often becomes inconsistent, brittle, and hard to evolve; this guide helps teams define clear contracts, predictable error handling, and scalable pagination and versioning so clients and servers can be developed in parallel.
Use the api-design skill to produce an OpenAPI v3 specification for an orders service that includes resource paths, RFC 7807 error responses, cursor pagination, bearer authentication, and a clear versioning scheme.
High-intent search queries and answers about installing and using this skill.
Designing a REST API requires standardizing HTTP semantics, applying RFC 7807 problem details for errors, and implementing cursor or offset pagination to ensure predictable client behavior and scalable data retrieval.
Generating an OpenAPI v3 specification involves defining resource paths, security schemes, and OpenAPI components using a spec-first workflow, producing actionable contracts suitable for automated client generation and parallel development.
RFC 7807 problem details provide a standardized error shape for APIs, ensuring stable error codes and consistent logging practices that prevent leaking internal details while maintaining debuggability for clients.
API versioning strategies like URL and header versioning allow teams to evolve contracts without breaking clients; choosing between them depends on your specific routing requirements and client caching needs.
Resolving N+1 query problems in GraphQL schemas involves applying specific schema patterns, utilizing connection pagination, and integrating DataLoader guidance to batch data fetching efficiently.
This approach applies to both internal and public APIs, covering authentication practices like bearer or JWT tokens, API key management, rate limiting, and CORS rules to secure and control access.
shafibabarStandardize Go unit tests with table-driven structures and classical mocking.
Dokkabei97Design API contracts with OpenAPI and GraphQL schemas.
felvieiraDefine API contracts and data models for Node.js backend applications.
copyleftdevDesign event-driven architectures with AsyncAPI specifications and channel-centric contracts.
