validator-gen

What This Skill Does

The validator-gen skill is an intelligent developer tool designed to bridge the gap between static TypeScript definitions and runtime data validation. By parsing your existing TypeScript interfaces and types, this tool automatically generates robust validation schemas using popular libraries like Zod or Yup. It eliminates the manual, error-prone process of writing redundant validation logic that frequently gets out of sync with your application types.

Whether you are handling complex API request bodies, nested JSON configurations, or intricate form data, validator-gen identifies the structure of your data—including arrays, unions, and optional fields—and maps them to appropriate runtime constraints. It goes beyond basic structure by intelligently adding validation patterns for email addresses, URLs, and date formats, ensuring your runtime checks are as strict as your type system.

Installation

To integrate this skill into your environment, use the OpenClaw CLI to fetch it from the official registry. Run the following command in your terminal:

clawhub install openclaw/skills/skills/lxgicstudios/validator-gen

Ensure you have Node.js 18 or higher installed on your machine. Because this tool leverages AI to analyze your type definitions, you must have a valid OPENAI_API_KEY environment variable configured in your terminal session before execution.

Use Cases

1. API Development: Automatically generate validation schemas for Express, Fastify, or Next.js API routes to ensure incoming request bodies match your expected TypeScript interfaces.
2. Form Validation: Seamlessly sync front-end forms with back-end data structures by generating schemas that define exactly what is valid input.
3. Legacy Migration: Quickly wrap existing loose JavaScript or unvalidated TypeScript codebases with strong runtime contracts to prevent bugs from reaching production.
4. Configuration Handling: Validate complex JSON config files against internal types during build time or app startup to catch errors early.

Example Prompts

1. "Analyze my types/user.ts file and generate a Zod schema that includes custom error messages for every field."
2. "Convert the interface in src/models/order.ts into a Yup validation schema and output the result to src/validators/order.ts."
3. "Parse the TypeScript types in the current directory and generate validation schemas using the Zod library, ensuring all fields are strict."

Tips & Limitations

• Single Source of Truth: While the tool generates excellent boilerplate, the best practice is to define your types first and use the generator as a starting point. Once generated, you can use z.infer<typeof schema> to maintain the relationship between the validator and the type definition.
• Refinements: AI-generated code is structurally accurate, but business logic (e.g., "password must contain a special character") often requires manual refinement. Treat the output as a high-quality foundation.
• Environment Safety: Always review the generated code before committing it to your version control, especially when dealing with sensitive data handling or complex unions that might require manual adjustments for specific edge cases.