rest-api-design-patterns — скилл для Claude Code: проектирование REST
Скилл-справочник по проектированию REST API: моделирование ресурсов, версионирование, пагинация, HATEOAS и работа с HTTP-методами.
npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a claude-codeЧто делает rest-api-design-patterns
Скилл даёт агенту набор правил и примеров, по которым он проектирует и правит REST API. Внутри — именование ресурсов, вложенные эндпоинты, фильтрация через query-параметры, массовые операции, разбор HTTP-методов с примерами на FastAPI и Express.js. Есть модель зрелости Ричардсона: от одного URI с POST до гипермедиа-контролов.
Пригодится, когда начинаешь API с нуля или приводишь к единому виду уже существующее. Агент подскажет, где коллекция, где элемент, почему GET /getUsers — плохая идея и как не уйти в пять уровней вложенности. Отдельные разделы про версионирование, обработку ошибок и документацию в OpenAPI.
Скилл текстовый: это инструкция для агента, а не библиотека. Ставится в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — в каждом своя команда и свой путь к SKILL.md. Для GitHub Copilot нужен установленный gh с поддержкой скиллов, иначе команда установки не сработает.
Какие задачи решает
- спроектировать ресурсы и эндпоинты нового REST API
- переписать существующие ручки под нормальные HTTP-методы
- добавить версионирование, не ломая текущих клиентов
- настроить пагинацию, фильтрацию и сортировку в коллекциях
- описать API в OpenAPI и разложить ошибки по статус-кодам
Примеры запросов агенту
- Спроектируй REST API для заказов: ресурсы, эндпоинты, коды ответов
- Проверь мои роуты на соответствие REST — где нейминг и методы неверные
- Добавь версионирование и пагинацию к текущему API на FastAPI
Как установить rest-api-design-patterns
1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a claude-code2Вручную: положить файлы
~/.claude/skills/rest-api-design-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rest-api-design-patterns/
1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a codex2Вручную: положить файлы
.agents/skills/rest-api-design-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a cursor2Вручную: положить файлы
.cursor/skills/rest-api-design-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install manutej/luxor-claude-marketplace rest-api-design-patterns2Вручную: положить файлы
.github/skills/rest-api-design-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-backend-toolkit/skills/rest-api-design-patternsВручную: положить файлы
.devin/skills/rest-api-design-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора31
Похожие
Рядом в теме «Бэкенд и API»
Всё по теме «Бэкенд и API» →Вопросы о rest-api-design-patterns
Как установить rest-api-design-patterns в Claude?
Выполни npx skills add manutej/luxor-claude-marketplace --skill rest-api-design-patterns -a claude-code. Скилл появится в ~/.claude/skills/rest-api-design-patterns/SKILL.md.
Что делает rest-api-design-patterns?
Даёт агенту правила проектирования REST API: моделирование ресурсов, HTTP-методы, версионирование, пагинация, фильтрация, HATEOAS и обработка ошибок. С примерами на FastAPI и Express.js.
Для каких платформ подходит этот скилл?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Команда установки у каждой платформы своя, путь к SKILL.md тоже отличается.