payload — скилл для Claude Code: что делает и как установить
Помогает настраивать коллекции, хуки и права доступа в проектах на Payload CMS. Пригодится при отладке запросов, транзакций и валидации.
npx skills add payloadcms/skills --skill payload -a claude-codeЧто делает payload
Скилл даёт ассистенту справочные правила по архитектуре Payload CMS для Next.js. Он ориентирован на работу с payload.config.ts, связями между коллекциями, контролем доступа на уровне строк и вызовами через локальный API.
Внутри собраны рецепты под типовые сценарии: черновики через versions: { drafts: true }, виртуальные поля с hooks.afterRead и каскадное удаление в beforeDelete. Для предотвращения бесконечных циклов в хуках используется проверка req.context. Если передать транзакции без проброса req через операции, изоляция данных сломается.
Также скилл подсказывает синтаксис геозапросов для полей point, настройку очередей фоновых задач и структуру плагинов с компиляцией через SWC.
Какие задачи решает
- настроить контроль доступа на уровне строк через запросы
- предотвратить зацикливание хуков с помощью проверки
req.context - добавить версионирование и черновики в коллекцию
- пробросить
reqв операции локального API для сохранения транзакций
Примеры запросов агенту
- Покажи, как настроить черновики и публикации для коллекции статей в payload.config.ts
- Как предотвратить зацикливание хука afterChange при ревалидации Next.js?
- Напиши хук beforeDelete для каскадного удаления связанных записей
Как установить payload
1Через Skills CLI (Vercel)
npx skills add payloadcms/skills --skill payload -a claude-code2Вручную: положить файлы
~/.claude/skills/payload/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/payload/
1Через Skills CLI (Vercel)
npx skills add payloadcms/skills --skill payload -a codex2Вручную: положить файлы
.agents/skills/payload/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add payloadcms/skills --skill payload -a cursor2Вручную: положить файлы
.cursor/skills/payload/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install payloadcms/skills payload2Вручную: положить файлы
.github/skills/payload/SKILL.md1Через Skills CLI (Vercel)
npx skills add payloadcms/skills --skill payload -a gemini-cli2Командой платформы
gemini skills install https://github.com/payloadcms/skills --path skills/payloadВручную: положить файлы
.devin/skills/payload/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add payloadcms/skills --skill payload -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора2
Похожие
Рядом в теме «Бэкенд и API»
Всё по теме «Бэкенд и API» →Вопросы о payload
Как установить payload в Claude Code?
Для установки выполните команду npx skills add payloadcms/skills --skill payload -a claude-code.
Что делает скилл payload?
Он обучает ИИ-ассистента архитектуре Payload CMS в связке с Next.js и TypeScript. Скилл помогает писать конфигурации коллекций, настраивать хуки жизненного цикла и отлаживать запросы к базе данных.
Как избежать бесконечных циклов при вызове хуков?
Потребуется проверять контекст внутри объекта req.context. Это позволяет хуку распознать повторный вызов и вовремя прервать выполнение операции.