Api Design Reviewer

This is your comprehensive API design reviewer that lints OpenAPI specs, detects breaking changes between versions, and generates design scorecards across five dimensions: consistency, documentation, security, usability, and performance. It enforces REST conventions like kebab-case resources and proper HTTP method usage, flags breaking changes like removed endpoints or field type modifications, and includes detailed guidance on versioning strategies, pagination patterns, and error response formats. The scoring system is opinionated but well-reasoned, weighing consistency at 30% and giving equal weight to security and documentation. Use it during API design reviews, before releasing new versions, or when establishing API standards for your team. The real value is in catching breaking changes before they hit production.

Install to Claude Code

npx -y skills add borghei/claude-skills --skill api-design-reviewer --agent claude-code