api-design-reviewer · borghei — скилл для Claude Code: обзор и установка
Скилл api-design-reviewer для Claude Code проверяет спецификации OpenAPI, находит несовместимые изменения между версиями и оценивает зрелость контракта REST API.
LicenseRef-MIT-Commons-Clause 167 установок ★ 1 183 обновлён 2026-11-08
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a claude-codeЧто делает api-design-reviewer
Набор из трёх Python-скриптов работает в Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Утилита api_linter.py проверяет URL, методы HTTP, структуру ошибок и правила именования (kebab-case для путей и camelCase для полей).
Скрипт breaking_change_detector.py сравнивает два файла спецификаций, отслеживая удалённые эндпоинты, смену типов полей и добавление обязательных параметров. Для интеграции в пайплайны предусмотрен флаг --exit-on-breaking, возвращающий код 1 при несовместимости контрактов.
Для запуска скриптов в окружении нужен Python, а спецификации должны быть валидным JSON в формате OpenAPI или Swagger, иначе утилиты завершаются с кодом 2. Третий инструмент, api_scorecard.py, выставляет оценку от A до F по пяти категориям от безопасности до производительности.
Какие задачи решает
- найти несовместимые изменения между двумя версиями OpenAPI
- проверить URL и методы на соответствие соглашениям REST
- выявить отсутствие схем ошибок и примеров в документации
- заблокировать сборку в CI при нарушении контракта API
Примеры запросов агенту
- Проверь файл openapi.json через api_linter.py
- Сравни спецификации v1.json и v2.json на критические изменения
- Оцени качество API в swagger.json скриптом api_scorecard.py
Как установить api-design-reviewer
1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a claude-code2Вручную: положить файлы
~/.claude/skills/api-design-reviewer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-design-reviewer/
1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a codex2Вручную: положить файлы
.agents/skills/api-design-reviewer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a cursor2Вручную: положить файлы
.cursor/skills/api-design-reviewer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install borghei/Claude-Skills engineering/api-design-reviewer/SKILL.md2Вручную: положить файлы
.github/skills/api-design-reviewer/SKILL.md1Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a gemini-cli2Командой платформы
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/api-design-reviewerВручную: положить файлы
.devin/skills/api-design-reviewer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об api-design-reviewer
Как установить api-design-reviewer в Claude Code?
Выполните команду npx skills add borghei/Claude-Skills --skill api-design-reviewer -a claude-code.
Что делает api-design-reviewer?
Он запускает анализ REST-спецификаций через три Python-скрипта: проверяет соглашения по путям и методам, ищет критические изменения между версиями схемы и рассчитывает взвешенную оценку зрелости API.
Чем отличаются проверки линтера от скоркарта?
Линтер вычитает штрафы из 100 баллов за конкретные ошибки вроде глаголов в путях, а скоркарт оценивает полноту API (документацию, безопасность, пагинацию) и выставляет буквенную оценку от A до F.
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — api-design-reviewer от других авторов.