Define RESTful and gRPC API design guidelines for resource naming, versioning, and validation.
npx skills add https://github.com/ep0ll/bons-ci --skill golang-api-design
Please help me install this Agent Skill. Skill: golang-api-design Source: https://github.com/ep0ll/bons-ci/tree/main/.agents/skills/api-design Command: npx skills add https://github.com/ep0ll/bons-ci --skill golang-api-design
This Skill provides comprehensive guidelines for designing effective and maintainable API surfaces for HTTP and gRPC protocols.
Use the guidelines to structure your API endpoints, validate requests, and implement versioned, secure, and scalable services.
High-intent search queries and answers about installing and using this skill.
RESTful API resource naming and versioning best practices involve defining clear endpoint conventions for resource structures and implementing version control. This ensures maintainable API surfaces for HTTP protocols while standardizing request and response interactions.
Cursor-based pagination and ETag mechanisms are implemented by incorporating conditional request handling. This approach manages large datasets efficiently and supports client-side caching validation for scalable backend development.
API validation and error responses are standardized through consistent request decoding and defined response envelopes. Establishing these best practices ensures reliable parsing, structured validation feedback, and uniform error handling across HTTP and gRPC protocols.
OpenAPI specs and gRPC protocol buffers serve API definition by structuring endpoint contracts. OpenAPI supports RESTful HTTP design, while protocol buffers define gRPC services, allowing teams to standardize scalable and versioned API surfaces effectively.
gRPC API design differs from RESTful structuring by utilizing protocol buffers for service definitions rather than HTTP endpoint conventions. Both require standardized validation, pagination, and error handling to build scalable, versioned backend services.
GeneralJerelInitialize a standardized .chalk folder and chalk.json with PROFILE docs.
FaysilAlshareefEnrich OpenAPI specifications with summaries, descriptions, and examples.
dpieterszDesign RESTful API endpoints, controllers, and middleware for scalable web services.
Camilo8902Migrate REST APIs to GraphQL incrementally using schema stitching and REST data source wrappers.
