safe-action-validation-errors — скилл для Claude Code: установка
Скилл учит ИИ-агента обрабатывать ошибки валидации в next-safe-action. Пригодится при настройке серверных экшенов с Zod и выводе сообщений в формах.
npx skills add next-safe-action/skills --skill safe-action-validation-errors -a claude-codeЧто делает safe-action-validation-errors
Скилл содержит правила для генерации серверных экшенов в Next.js с помощью библиотеки next-safe-action. Агент узнаёт, как отдавать клиенту ошибки из двух источников: автоматической проверки схемы входных данных и ручных проверок бизнес-логики в коде сервера.
Внутри описана работа функции returnValidationErrors. Она выбрасывает внутреннее исключение ActionServerValidationError, поэтому выполнение экшена сразу прерывается и управление дальше не идёт. Код ниже этой строчки никогда не запустится.
Также руководство подсказывает структуру ответов: вложенный формат по умолчанию с массивами _errors или плоский вариант с fieldErrors и formErrors. Это помогает модели писать точный JSX-код для рендеринга ошибок формы и отдельных полей.
Какие задачи решает
- вернуть ошибку уникальности поля из серверного экшена
- сформировать общие ошибки формы на уровне корня схемы
- отрисовать вложенные ошибки валидации в React-компоненте
- переключить формат ошибок между древовидным и плоским
Примеры запросов агенту
- Сделай серверный экшен регистрации через next-safe-action с проверкой занятости email через returnValidationErrors
- Покажи разметку для вывода ошибок валидации формы в стандартном формате next-safe-action
- Как вернуть общую ошибку формы на уровне корня схемы без привязки к конкретному полю?
Как установить safe-action-validation-errors
1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-validation-errors -a claude-code2Вручную: положить файлы
~/.claude/skills/safe-action-validation-errors/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/safe-action-validation-errors/
1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-validation-errors -a codex2Вручную: положить файлы
.agents/skills/safe-action-validation-errors/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-validation-errors -a cursor2Вручную: положить файлы
.cursor/skills/safe-action-validation-errors/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install next-safe-action/skills safe-action-validation-errors2Вручную: положить файлы
.github/skills/safe-action-validation-errors/SKILL.md1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-validation-errors -a gemini-cli2Командой платформы
gemini skills install https://github.com/next-safe-action/skills --path skills/safe-action-validation-errorsВручную: положить файлы
.devin/skills/safe-action-validation-errors/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-validation-errors -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о safe-action-validation-errors
Как установить safe-action-validation-errors в Claude Code?
Выполните команду npx skills add next-safe-action/skills --skill safe-action-validation-errors -a claude-code.
Зачем нужен этот скилл?
Он даёт модели инструкции по работе с ошибками схем и кастомными проверками в next-safe-action. Ассистент перестаёт путать форматы _errors и правильно прерывает экшены.
Что происходит при вызове returnValidationErrors?
Функция всегда выбрасывает исключение ActionServerValidationError, которое перехватывает библиотека. Код после неё не выполняется, а клиент получает результат в result.validationErrors.
