zod

Zod schema validation best practices for type safety, parsing, and error handling. This skill should be used when defining z.object schemas, using z.string validations, safeParse, or z.infer. This skill does NOT cover React Hook Form integration patterns (use react-hook-form skill) or OpenAPI client generation (use orval skill).

pedronauck official Разработка

Что делает навык

Навык предоставляет 43 правила лучших практик валидации схем Zod в TypeScript, охватывающие определение схем, парсинг, вывод типов и обработку ошибок. Он предназначен для обеспечения типобезопасности, оптимизации производительности и корректной обработки пользовательского ввода.

Когда применять

  • Написание новых схем Zod и выбор между методами parse() и safeParse().
  • Реализация вывода типов с использованием z.infer и z.input.
  • Обработка ошибок валидации для обратной связи пользователю.
  • Составление сложных объектных схем и использование рефинментов (refinements).
  • Оптимизация размера бандла и производительности валидации.

Как работает

  1. Определите категорию и приоритет (от CRITICAL до LOW-MEDIUM) для применяемого правила.
  2. Примените соответствующие префиксы правил (schema-, parse-, type-, error-, object-, compose-, refine-, perf-) при рефакторинге или генерации кода.
  3. Используйте safeParse() для пользовательского ввода и parseAsync() для асинхронных рефинментов.
  4. Настройте обработку ошибок с помощью flatten() и issue.path для отображения в формах.
  5. Кэшируйте экземпляры схем и используйте Zod Mini для чувствительных к размеру бандла приложений.

Примеры запросов агенту

Примени лучшие практики Zod для валидации входных данных API с использованием safeParse.
Оптимизируй схему Zod для уменьшения размера бандла, следуя правилам категории perf-.
Настрой вывод типов из схемы Zod, используя z.infer и обеспечив строгий режим TypeScript.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «zod» из репозитория: # https://github.com/pedronauck/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r zod/ ~/.claude/skills/zod/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.