api-design-reviewer
by alirezarezvani (GitHub) in alirezarezvani/claude-skills
What it does
Comprehensive REST API design review with automated linting, breaking-change detection, and design scorecards. Catches inconsistent conventions, missing versioning, and design smells before APIs ship. Use when reviewing a PR that adds or changes API endpoints, auditing an existing API for v2 migrati
Quoted from the skill's SKILL.md under its MIT license.
Install
git clone --depth 1 https://github.com/alirezarezvani/claude-skills.git /tmp/claude-skills mkdir -p ~/.claude/skills/ cp -r /tmp/claude-skills/engineering/skills/api-design-reviewer ~/.claude/skills/api-design-reviewer
The command copies the skill from the author's repo. SkillTrove does not host it.
Files
- SKILL.md
- references/api_antipatterns.md
- references/rest_design_rules.md
- scripts/api_linter.py
- scripts/api_scorecard.py
- scripts/breaking_change_detector.py
Source: https://github.com/alirezarezvani/claude-skills/tree/main/engineering/skills/api-design-reviewer. Checked 2026-10-13.
Similar skills
api-and-interface-design
Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when creating REST or GraphQL endpoints, def...
code-review-and-quality
Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to ...
code-simplification
Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but is harder to read, maintain, or extend ...
documentation-and-adrs
Records decisions and documentation. Use when you need to document an architecture decision (ADR) or the reasoning behind a design choice, when changing publ...
doubt-driven-development
Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when you want every assumption cross-examined before proceedi...
frontend-ui-engineering
Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages, creating components, implementing lay...