Design REST and GraphQL APIs with OpenAPI 3.x specifications.
npx skills add https://github.com/SalesTeamToolbox/frood --skill api-design-salesteamtoolbox
Please help me install this Agent Skill. Skill: api-design Source: https://github.com/SalesTeamToolbox/frood/tree/main/skills/builtins/api-design Command: npx skills add https://github.com/SalesTeamToolbox/frood --skill api-design-salesteamtoolbox
It helps you avoid inconsistent endpoints, ambiguous schemas, and brittle error handling by providing a practical, standards-based approach to API design.
Ask: Design a REST v1 API for managing orders with cursor pagination, filtering by status and date, JWT auth, and a consistent error schema with request_id.
High-intent search queries and answers about installing and using this skill.
Design clean REST APIs by standardizing resource naming, HTTP method semantics, and structured machine-readable error responses. Implement cursor pagination, filtering, and sorting strategies to ensure your API remains predictable and scales reliably as usage grows.
Structure API versioning by defining clear behavior contracts for stable client compatibility. Standardize JWT authentication, map correct HTTP status codes, and maintain consistent naming conventions to secure public or internal service contracts.
Generate an OpenAPI 3.x specification by defining your REST endpoints, schemas, and error responses. Produce this machine-readable documentation to enable consistent interface discovery and validate it within your CI pipeline for reliable client compatibility.
Yes, this approach works for both REST and GraphQL API design. It standardizes endpoint schemas, versioning, authentication, and rate limiting across both paradigms, ensuring clean, reliable interfaces for CRUD resources and internal service contracts.
Ambiguous schemas and brittle error codes occur when API design lacks standards-based endpoint naming and structured error responses. Fix this by applying consistent HTTP method mapping, machine-readable error structures with request_id, and OpenAPI 3.x documentation.
Awais68Design RESTful API endpoints with Pydantic validation and OpenAPI schemas.
ccfGenerate and validate OpenAPI 3.1 specifications from design or code sources.
vertivolatamImplement API Gateways with Kong and Nginx rate limiting strategies.
zinohomeMigrate REST APIs to GraphQL incrementally using schema stitching and Apollo RESTDataSource.
