Audit REST API design and documentation for consistent endpoints, schemas, and errors.
npx skills add https://github.com/calcosmic/Aether --skill rest-api-calcosmic
Please help me install this Agent Skill. Skill: rest-api Source: https://github.com/calcosmic/Aether/tree/main/.aether/skills-codex/domain/rest-api Command: npx skills add https://github.com/calcosmic/Aether --skill rest-api-calcosmic
Designing consistent, scalable REST APIs and ensuring reliable consumption by clients can be error-prone without clear guidelines, leading to brittle endpoints, inconsistent status handling, and confusing docs.
Audit your API design and documentation to apply the recommended REST practices in every endpoint.
High-intent search queries and answers about installing and using this skill.
REST API design uses nouns for endpoints, versioned paths, and consistent nesting to reduce inconsistency. Apply standardized JSON request and response schemas with unified field naming like camelCase or snake_case to ensure reliable client consumption.
REST APIs should use standard HTTP status code mappings and a consistent error response structure. Maintaining a unified error format across all endpoints prevents brittle client behavior and confusing documentation.
Implement cursor-based pagination and bearer token authentication to manage REST API resources effectively. Apply response rate limits and maintain an OpenAPI specification with sample requests to document these constraints.
OpenAPI or Swagger detection is required for REST API projects to maintain accurate documentation and sample requests. This ensures endpoint discoverability and reliable integration when clients consume your public API.
Auditing REST API documentation involves checking endpoint naming, versioning, and error structures against recommended practices. This process streamlines API design and reduces brittleness across resources, responses, and authentication methods.
SambaliciousStandardize REST API resource naming, HTTP methods, status codes, and versioning.
NickChristensenLocate and explain Paperless-ngx API endpoints from the OpenAPI spec.
ColdBoxBuilds ColdBox REST APIs with RestHandler, JWT auth, and pagination.
chidekinaDefine and enforce scalable REST and GraphQL API design patterns.
