# output-error-zod-import

> Claude/Codex skill by [@growthxai](https://omgskills.com/library/growthxai/index.md) · 443 stars · Updated 2026-10-22

Fix Zod schema import issues in Output SDK workflows. Use when seeing "incompatible schema" errors, type errors at step boundaries, schema validation failures, or when schemas don't match between steps.

Tags: agents, ai, ai-agents, ai-sdk, claude, claude-code, javascript, llm, nodejs, open-source, reliability, temporal, typescript, workflow-engine, workflows

## Install

```sh
git clone https://github.com/growthxai/output /tmp/output && ln -s /tmp/output/coding_assistants/claude/plugins/outputai/skills/output-error-zod-import ~/.claude/skills/output-error-zod-import
```

## From README

Fix Zod Import Source Issues Overview This skill helps diagnose and fix a common issue where Zod schemas are imported from the wrong source. Output SDK requires schemas to be imported from @outputai/core, not directly from zod. When to Use This Skill You're seeing: "incompatible schema" errors Type errors at step boundaries Schema validation failures when passing data between steps Errors mentioning Zod types not matching "Expected ZodObject but received..." errors Root Cause The issue occurs when you import z from zod instead of @outputai/core. While both provide Zod schemas, they create different schema instances that aren't compatible with each other within the Output SDK context. Why this matters: Output SDK uses a specific version of Zod internally for serialization and validation. When you use a different Zod instance, the schemas are technically different objects even if they define the same shape.

## Links

- HTML page: https://omgskills.com/library/growthxai/output/coding_assistants/claude/plugins/outputai/skills/output-error-zod-import/
- GitHub: https://github.com/growthxai/output
- Author: [@growthxai](https://omgskills.com/library/growthxai/index.md)

## More from this repo

- [output-build-workflow](https://omgskills.com/library/growthxai/output/coding_assistants/claude/plugins/outputai/skills/output-build-workflow/index.md) — Implement an Output SDK workflow from a plan document.
   - [@growthxai](https://omgskills.com/library/growthxai/index.md) · 443 stars
- [output-credentials-edit](https://omgskills.com/library/growthxai/output/coding_assistants/claude/plugins/outputai/skills/output-credentials-edit/index.md) — View, edit, and set encrypted credentials in an Output.ai project.
   - [@growthxai](https://omgskills.com/library/growthxai/index.md) · 443 stars
- [output-credentials-env-vars](https://omgskills.com/library/growthxai/output/coding_assistants/claude/plugins/outputai/skills/output-credentials-env-vars/index.md) — Wire encrypted credentials to environment variables using the credential: convention.
   - [@growthxai](https://omgskills.com/library/growthxai/index.md) · 443 stars