Overview
api-design-reviewer is an open-source backend skill for Claude Code and compatible agents, published by alirezarezvani. Its author describes it as: “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 reviewi…”. The project has 25k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add alirezarezvani/claude-skills`.
What api-design-reviewer does
**Tier:** POWERFUL **Category:** Engineering / Architecture **Maintainer:** Claude Skills Team
Best for
What’s inside
The SKILL.md for api-design-reviewer is organised into these sections:
- Overview
- Quick Start — run the tools first
- Core Capabilities
- 1. API Linting and Convention Analysis
- 2. Breaking Change Detection
- 3. API Design Scoring and Assessment
- REST Design Principles
- Resource Naming Conventions
- HTTP Method Usage
- URL Structure Best Practices
- Versioning Strategies
- 1. URL Versioning (Recommended)
Installation
Add api-design-reviewer to your agent with:
/plugin marketplace add alirezarezvani/claude-skillsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- Gemini CLI — declared in the repository topics
License
api-design-reviewer is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in alirezarezvani/claude-skills, an established project with 24,617 GitHub stars
- Works with Claude Code, Codex, Cursor, Gemini CLI
- Actively maintained — repository updated in the last 90 days
Author
Topics
Alternatives to api-design-reviewer
Similar skills from other repositories:
Frequently asked questions
- What does api-design-reviewer do?
- 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 migration, or establishing API standards for a team.
- How do I install api-design-reviewer?
- Run /plugin marketplace add alirezarezvani/claude-skills in your agent, then reload your skills. Review the source at https://github.com/alirezarezvani/claude-skills before installing.
- Is api-design-reviewer free to use?
- Yes. api-design-reviewer is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does api-design-reviewer work with?
- api-design-reviewer lists Claude Code, Codex, Cursor, and Gemini CLI — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does api-design-reviewer come from?
- api-design-reviewer ships inside alirezarezvani/claude-skills, a repository that contains 41 catalogued skills in total. The repository's 24,617 GitHub stars apply to that whole collection, not to this skill on its own.
