designing-zod-schemas

What problem does it solve?

This Skill guides the design and implementation of Zod schemas following a Zod-first development approach, enabling robust, type-safe data validation and reusable schema patterns.

Core Features & Use Cases

• Zod-First Development: Define the schema as the single source of truth, infer TS types with z.infer, and reuse the same schema for runtime validation and tests.
• Schema Patterns: Branded types, discriminated unions, transforms, and refinements for scalable validation.
• Testing & Documentation: Promote safe parsing and provide patterns for test data builders and validation tests.

Quick Start

Define a new Zod schema in your project (e.g., a user config object). Infer its TypeScript type using z.infer and validate runtime data with safeParse; add tests to verify validation behavior.