from agent-skills-standard488
Opinionated REST API design conventions: HTTP verbs, status codes, URL patterns, versioning, pagination, and OpenAPI requirements for reliable, versioned APIs.
Provides a concise set of REST API design standards and anti-patterns for teams building HTTP APIs. It covers correct HTTP verb usage, status codes, URL design, versioning strategies, pagination best practices, OpenAPI contract expectations, and baseline security headers.
Use this skill when designing or reviewing REST endpoints, preparing OpenAPI specs, implementing pagination, choosing versioning approach, or auditing API security and response semantics. Especially useful during PR reviews and API contract drafting.
{}
A well-organized REST API design reference skill covering HTTP verbs, status codes, URL conventions, versioning, pagination, and OpenAPI contracts. No scripts included — purely a documentation/checklist skill. Frontmatter triggers are specific and well-crafted. Anti-patterns section adds practical value.
Clean skill with no security concerns. Pure documentation/reference. Would benefit from a references/ directory with example OpenAPI specs or error response templates as mentioned in SKILL.md.
