safe-action-client — скилл для Claude Code: что делает и установка
Помогает агенту объявлять и настраивать серверные действия next-safe-action с валидацией через Zod или Valibot. Пригодится при типизации Server Actions в Next.js.
npx skills add next-safe-action/skills --skill safe-action-client -a claude-codeЧто делает safe-action-client
Скилл обучает ассистента правилам создания клиента через createSafeActionClient и цепочке методов валидации. Он задаёт строгий порядок вызова .use(), .metadata(), .inputSchema(), .outputSchema() и .action(). Цепочка неизменяема: каждый шаг возвращает новый экземпляр.
Агент перестанет забывать директиву "use server" во главе файлов с действиями. Если в клиенте настроена defineMetadataSchema, пропуск вызова .metadata() вызовет ошибку компиляции TypeScript прямо при сборке.
Инструкция разграничивает ошибки форм и сбои бизнес-логики. Для неверных полей используется returnValidationErrors, а для ожидаемых проблем вроде отсутствия товара на складе — метод returnServerError.
Какие задачи решает
- настроить клиент
createSafeActionClientс промежуточными слоями middleware - валидировать входные и выходные параметры через схемы Standard Schema
- возвращать типизированные ошибки полей через
returnValidationErrors - создавать серверные действия с сохранением предыдущего состояния через
stateAction
Примеры запросов агенту
- Создай базовый клиент
actionClientв файлеsrc/lib/safe-action.tsс валидацией схемы метаданных. - Напиши серверное действие с валидацией через Zod и обработкой дубликата email с помощью
returnValidationErrors. - Опиши стейт-экшен через
stateActionдля счётчика кликов в React.
Как установить safe-action-client
1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-client -a claude-code2Вручную: положить файлы
~/.claude/skills/safe-action-client/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/safe-action-client/
1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-client -a codex2Вручную: положить файлы
.agents/skills/safe-action-client/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-client -a cursor2Вручную: положить файлы
.cursor/skills/safe-action-client/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install next-safe-action/skills safe-action-client2Вручную: положить файлы
.github/skills/safe-action-client/SKILL.md1Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-client -a gemini-cli2Командой платформы
gemini skills install https://github.com/next-safe-action/skills --path skills/safe-action-clientВручную: положить файлы
.devin/skills/safe-action-client/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add next-safe-action/skills --skill safe-action-client -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о safe-action-client
Как установить safe-action-client в Claude Code?
Выполните в терминале команду npx skills add next-safe-action/skills --skill safe-action-client -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/safe-action-client/SKILL.md.
Что делает safe-action-client?
Навык обучает ассистента правилам работы с библиотекой next-safe-action. Агент применяет правильный порядок цепочки методов, типизирует аргументы и избегает частых антипаттернов.
Как в действиях обрабатываются ошибки валидации?
Для передачи ошибок конкретных полей вызывается returnValidationErrors со схемой и текстом. Для ожидаемых сбоев логики без валидации применяется функция returnServerError.
