from agent-skills-standard488
Opinionated REST API design guidelines: HTTP semantics, status codes, URL design, versioning, pagination, and OpenAPI contract best-practices.
This skill codifies REST API conventions and best practices: correct HTTP verb usage, status codes, URL naming, versioning strategy, pagination envelopes, OpenAPI generation, and basic security headers. It guides engineers and agents to design consistent, discoverable, and versionable APIs.
Use during API design, writing controllers/routes, creating OpenAPI specs, reviewing PRs for breaking changes, or implementing pagination/versioning policies. It triggers when you touch controllers, routes, or API contract files.
Useful for developer-assistant agents (code review bots, PR linters, documentation generators) and any agent that helps with backend code (nestjs, express, spring, nextjs routing conventions).
Pure documentation skill providing opinionated REST API design guidelines covering HTTP verbs, status codes, URL design, versioning, pagination, and OpenAPI contracts. No scripts bundled. Well-structured with clear examples and anti-patterns. Broadly applicable to any backend developer.
No security concerns — no scripts, no shell commands, no network calls. Clean documentation-only skill. References link points to references/REFERENCE.md but content not fetched (not bundled in scripts).
