$ skilldirectory
— zsh — registry.skilldirectory.dev
skill library blog

home / API & Integrations / API Design Reviewer Skill by @alirezarezvani

API Design Reviewer Skill by @alirezarezvani

FREE
github stars★ 29,369updatedOct 2026repo@alirezarezvani
$git clone https://github.com/alirezarezvani/claude-skills

The skill is the engineering/skills/api-design-reviewer folder inside that repository. Copy it into the folder your agent loads skills from; check your agent's documentation for where that is.

Read the opening of the original SKILL.md
# API Design Reviewer

**Tier:** POWERFUL  
**Category:** Engineering / Architecture  
**Maintainer:** Claude Skills Team  

## Overview

The API Design Reviewer skill provides comprehensive analysis and review of API designs, focusing on REST conventions, best practices, and industry standards. This skill helps engineering teams build consistent, maintainable, and well-designed APIs through automated linting, breaking change detection, and design scorecards.

## Quick Start — run the tools first

```bash
# 1. Lint an OpenAPI/Swagger spec for convention violations
python3 scripts/api_linter.py openapi.json --format json -o lint.json

# 2. Detect breaking changes between two spec versions (gate: exits non-zero with --exit-on-breaking)
python3 scripts/breaking_change_detector.py openapi-v1.json openapi-v2.json --format json --exit-on-breaking -o breaking.json

# 3. Score overall design quality (gate: --min-grade fails below threshold)
…

Excerpt only, quoted from the author's repository. Open the repository for the complete file.