Fix Missing Schema Definitions

Fix Missing Schema Definitions

Overview

This skill helps diagnose and fix issues caused by steps that lack explicit inputSchema or outputSchema definitions. Schemas are essential for type safety, validation, and proper data serialization between steps.

When to Use This Skill

You're seeing:

• Type errors at step boundaries
• Undefined properties in step inputs/outputs
• Validation failures when passing data between steps
• TypeScript errors about incompatible types
• Runtime errors about unexpected data shapes

Root Cause

Steps without explicit schemas:

• Don't validate input data at runtime
• Don't provide TypeScript type inference
• May serialize/deserialize data incorrectly
• Can pass undefined or malformed data silently

Symptoms

Missing Input Schema

// WRONG: No input validation
export const processData = step( {
  name: 'processData',
  // inputSchema: missing!
  outputSchema: z.object( { result: z.string() } ),
  fn: async input => {
    return { result: input.value };  // input.value might be undefined!
  }
} );

Missing Output Schema