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.
npx skills add https://github.com/borghei/claude-skills --skill api-design-reviewer