skill:api-design — RESTful and RPC API Design Patterns

Version: 1.0.0

Purpose

Design production-grade APIs that are consistent, discoverable, and evolvable. This skill guides the creation and review of RESTful and RPC API surfaces — from resource modeling and URL structure to versioning, error contracts, pagination, and security. It produces structured API design documents and OpenAPI-compatible specifications.

Use when:

• Designing a new API from scratch
• Reviewing an existing API for consistency and best practices
• Migrating between API styles (REST, RPC, hybrid)
• Establishing organization-wide API design standards
• Generating OpenAPI/Swagger specifications from design decisions

File Structure