Individual skill

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).

skills/.curated/zod/SKILL.md

Read pinned source

Source commit cf93c57cac89d6fc3e4194686000411567f5caf3

What was checked

Matches the observed repository HEAD: Yes
Scanner rules are current: No
Repository scan complete: No
Skill scan complete: Yes
Observed behavior: Not checked yet
Last checked: Nov 5, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings): 222
Repository last updated: Aug 15, 2026
License: MIT

Observed agent integration: codex

engineering Derived category
docs Derived category
docs-api Derived category
engineering-web Derived category

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files

AGENTS.mddoc · 11,508 bytes
README.mddoc · 3,091 bytes
SKILL.mdcore · 5,458 bytes
assets/templates/_template.mddoc · 726 bytes
metadata.jsonasset · 1,906 bytes
references/_sections.mddoc · 2,222 bytes
references/compose-intersection.mddoc · 3,463 bytes
references/compose-lazy-recursive.mddoc · 3,281 bytes
references/compose-pipe.mddoc · 3,404 bytes
references/compose-preprocess.mddoc · 3,707 bytes
references/compose-shared-schemas.mddoc · 3,334 bytes
references/error-avoid-throwing-in-refine.mddoc · 3,434 bytes
references/error-custom-messages.mddoc · 3,521 bytes
references/error-i18n.mddoc · 4,008 bytes
references/error-path-for-nested.mddoc · 3,679 bytes
references/error-use-flatten.mddoc · 3,319 bytes
references/object-discriminated-unions.mddoc · 4,016 bytes
references/object-extend-for-composition.mddoc · 3,438 bytes
references/object-optional-vs-nullable.mddoc · 3,693 bytes
references/object-partial-for-updates.mddoc · 3,562 bytes
references/object-pick-omit.mddoc · 3,871 bytes
references/object-strict-vs-strip.mddoc · 3,014 bytes
references/parse-async-for-async-refinements.mddoc · 3,084 bytes
references/parse-avoid-double-validation.mddoc · 3,356 bytes
references/parse-handle-all-issues.mddoc · 3,350 bytes
references/parse-never-trust-json.mddoc · 3,140 bytes
references/parse-use-safeparse.mddoc · 2,782 bytes
references/parse-validate-early.mddoc · 3,354 bytes
references/perf-arrays.mddoc · 3,991 bytes
references/perf-avoid-dynamic-creation.mddoc · 3,259 bytes
references/perf-cache-schemas.mddoc · 3,114 bytes
references/perf-lazy-loading.mddoc · 3,543 bytes
references/perf-zod-mini.mddoc · 3,098 bytes
references/refine-add-path.mddoc · 3,771 bytes
references/refine-catch.mddoc · 3,746 bytes
references/refine-defaults.mddoc · 3,645 bytes
references/refine-transform-coerce.mddoc · 3,446 bytes
references/refine-vs-superrefine.mddoc · 4,176 bytes
references/schema-avoid-optional-abuse.mddoc · 2,654 bytes
references/schema-coercion-for-form-data.mddoc · 2,981 bytes
references/schema-string-validations.mddoc · 2,766 bytes
references/schema-use-enums.mddoc · 2,737 bytes
references/schema-use-primitives-correctly.mddoc · 2,105 bytes
references/schema-use-unknown-not-any.mddoc · 2,220 bytes
references/type-branded-types.mddoc · 3,181 bytes
references/type-enable-strict-mode.mddoc · 2,975 bytes
references/type-export-schemas-and-types.mddoc · 3,060 bytes
references/type-input-vs-output.mddoc · 3,224 bytes
references/type-use-z-infer.mddoc · 3,029 bytes

Read excerpt


# Zod Best Practices

Comprehensive schema validation guide for Zod in TypeScript applications. Contains 43 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.

## When to Apply

Reference these guidelines when:
- Writing new Zod schemas
- Choosing between parse() and safeParse()
- Implementing type inference with z.infer
- Handling validation errors for user feedback
- Composing complex object schemas
- Using refinements and transforms
- Optimizing bundle size and validation performance