Design REST API endpoints, versioning, error handling, and OpenAPI specs.
npx skills add https://github.com/diendh/Ferro-VPN --skill rest-api-expert-diendh
Please help me install this Agent Skill. Skill: rest-api-expert Source: https://github.com/diendh/Ferro-VPN/tree/main/.agent/skills/rest-api-expert Command: npx skills add https://github.com/diendh/Ferro-VPN --skill rest-api-expert-diendh
REST API design and development can be error-prone without a structured approach. This skill provides expert guidance on HTTP semantics, resource modeling, versioning, error handling, pagination, and OpenAPI documentation to ensure scalable, maintainable APIs across teams.
Provide a baseline REST API design for a new service by outlining endpoints, versioning strategy, error handling, and OpenAPI documentation.
High-intent search queries and answers about installing and using this skill.
Designing a REST API with correct HTTP semantics involves mapping noun-based resources to appropriate methods and status codes. This skill enforces practical constraints like versioned routes, correct status codes, and consistent error formats to ensure scalable, maintainable services across teams.
Structuring REST API versioning uses versioned routes with clear deprecation plans and change previews. This skill applies practical versioning strategies to endpoint design, ensuring smooth transitions and governance across multiple services.
To generate OpenAPI documentation for REST API endpoints, create and maintain specs that align routes, errors, and docs for stakeholders. This skill handles OpenAPI spec generation alongside endpoint design, versioning, and error handling to keep documentation accurate and consistent.
You need a standard error envelope for REST API error handling to build client resilience and maintain consistency. This skill applies a standard error format alongside correct status codes and HTTP semantics to ensure clients can parse and handle failures predictably.
Yes, this REST API design approach works for services requiring pagination. This skill covers endpoint design, HTTP semantics, versioning, error handling, and pagination to create robust REST API designs for scalable services across multiple use cases.
michaelsvanbeekDefine REST API design patterns and contract standards for endpoints and OpenAPI documentation.
ccfGenerate and validate OpenAPI 3.1 specifications from design or code sources.
AcczdyDetect undocumented API endpoints by comparing observed traffic against OpenAPI specifications.
erichowensDesign and validate REST, GraphQL, and gRPC API contracts and architectures.
