К основному содержанию
скилл CX Codex

api-design-reviewer · borghei — скилл для Claude Code: обзор и установка

Скилл api-design-reviewer для Claude Code проверяет спецификации OpenAPI, находит несовместимые изменения между версиями и оценивает зрелость контракта REST API.

LicenseRef-MIT-Commons-Clause 167 установок ★ 1 183 обновлён 2026-11-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add borghei/Claude-Skills --skill api-design-reviewer -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/api-design-reviewer/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/api-design-reviewer/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

api-design-reviewer Alireza Rezvani Скилл api-design-reviewer проверяет REST API по спецификациям OpenAPI, находит ломающие изменения и выставляет оценку дизайну. Пригодится при ревью пуллреквестов с новыми эндпоинтами. CX Codex +1 768установок public-api-design-review Samuel Berthe Скилл public-api-design-review проводит REST API, готовый или ещё на бумаге, по чек-листу из восьми разделов и делит находки на обязательные правки и улучшения. CX Codex +1 10 200установок rest-api-design aj-geddes Скилл rest-api-design задаёт правила именования ресурсов, HTTP-методов, кодов ответа и версионирования, когда вы проектируете новые эндпоинты или переделываете старые. CX Codex +1 2 100установок api-design Agent Skills Team Скилл api-design для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — проектирует или рефакторит контракты REST и GraphQL. Запускается, когда нужно зафиксировать форму API до начала реализации. CX Codex +1 390установок design-rest-api davila7 Команда design-rest-api проектирует архитектуру REST API с эндпоинтами, аутентификацией и документацией OpenAPI с учётом текущего кода проекта. CX Codex +1 559установок openapi-expert personamanagmentlayer Скилл openapi-expert проектирует спецификации OpenAPI 3.0 и 3.1, настраивает полиморфизм схем и генерирует код клиентов или серверов. CX Codex +1 282установок openapi-spec-writer curiositech Скилл openapi-spec-writer проектирует спецификации OpenAPI 3.0 и 3.1 для REST API. Помогает составить схемы данных и настроить документацию ещё до написания серверного кода. CX Codex +1 175установок

Из того же набора120

Весь набор →
ml-ops-engineer Скилл ml-ops-engineer для Claude Code автоматизирует MLOps: развёртывание моделей, оркестрацию тренировочных конвейеров, мониторинг дрифта и настройку feature stores. Помогает закрывать разрывы в CI/CD. CX Codex +1 180установок ma-playbook Скилл ma-playbook для Claude Code задаёт порядок оценки активов, аудита due diligence, проверки рисков и планирования интеграции в M&A-сделках. CX Codex +1 179установок cto-advisor Скилл cto-advisor для технологической стратегии, найма и оценки архитектуры. Помогает спланировать рост команды, разобраться с техдолгом и выбрать технологии. CX Codex +1 177установок database-designer Скилл database-designer для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode проверяет SQL-схемы, подбирает индексы и создаёт миграции. Используйте его при ревью DDL, настройке индексов или сравнении версий схемы. CX Codex +1 176установок information-security-manager-iso27001 Скилл information-security-manager-iso27001 для Claude Code проектирует и проверяет ISMS по ISO 27001:2022, включая оценку рисков, контроли Annex A и подготовку к сертификации. CX Codex +1 166установок agent-designer Скилл agent-designer для Claude Code, Codex и Cursor, проектирующий архитектуру мультиагентных систем. Составляет схемы инструментов, выбирает топологию взаимодействия и находит узкие места по логам. CX Codex +1 161установок marketing-psychology Скилл marketing-psychology разбирает маркетинговые барьеры через поведенческую психологию и ментальные модели. Он пригодится для лендингов, цен, писем, рекламы и конверсии. CX Codex +1 151установок aws-solution-architect Скилл aws-solution-architect для Claude Code, Codex, Cursor и других платформ проектирует архитектуру AWS и генерирует IaC-шаблоны. Помогает подобрать стек под нагрузки и рассчитать примерные расходы. CX Codex +1 150установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой