SKILL.md
Zod v3 Documentation
Zod is a TypeScript-first schema declaration and validation library designed to be developer-friendly. With Zod, you declare a validator once and Zod automatically infers the static TypeScript type. It eliminates duplicative type declarations and makes it easy to compose simpler types into complex data structures.
Quick Reference
| File | Title | Description |
|---|---|---|
contents/README.md |
Main Documentation | Comprehensive API reference covering primitives, objects, arrays, unions, refinements, transformers, and all Zod features |
contents/ERROR_HANDLING.md |
Error Handling Guide | Explains ZodError and ZodIssue types, error formatting, and customization with error maps |
contents/MIGRATION.md |
Migration Guide | Steps for upgrading from Zod 1→2 and Zod 2→3, including breaking changes and new features |
contents/README_KO.md |
Korean Documentation | Korean translation of the main README |
contents/README_ZH.md |
Chinese Documentation | Chinese translation of the main README |
contents/blog/clerk-fellowship.md |
Zod 4 Development | Blog post about Zod 4 development plans and funding |
When to use
Use this skill when the user asks about:
- Zod schema validation and type inference
- Creating and composing Zod schemas (strings, objects, arrays, unions, etc.)
- Validation methods (.parse, .safeParse, .refine, .transform)
- Error handling with ZodError
- Migrating from Zod 1 or Zod 2 to Zod 3
- TypeScript integration with Zod
- Custom validation logic and refinements
How to find information
- Check Quick Reference above for relevant file
- Read
TOC.mdfor complete listing - Read specific files from
contents/{filename}
For API reference and usage examples, start with contents/README.md. For error handling details, see contents/ERROR_HANDLING.md. For version migration, see contents/MIGRATION.md.