Common REST API Design
Enforces standardized REST API conventions including HTTP semantics, status codes, versioning, and OpenAPI documentation patterns.
Common REST API Design is a specialized skill for Claude Code that ensures all backend development follows industry-standard best practices. It provides rigorous guidance on HTTP verb semantics, predictable URL structuring using kebab-case and plural nouns, and correct status code implementation to reduce integration friction. By mandating OpenAPI 3.1 specifications and promoting cursor-based pagination and robust versioning strategies, this skill helps developers build scalable, secure, and maintainable API contracts that prevent breaking changes and common anti-patterns like GET mutations.
主な機能
01Strict HTTP verb semantics for CRUD and non-CRUD actions
02381 GitHub stars
03Comprehensive versioning and deprecation header strategies
04Standardized URL design using kebab-case and plural nouns
05Cursor-based pagination patterns for large datasets
06Mandatory OpenAPI 3.1 contract generation and validation
ユースケース
01Generating and reviewing OpenAPI documentation for existing routes
02Refactoring legacy controllers to follow modern API standards
03Architecting new microservice endpoints with consistent REST patterns