Fix Schema
Fix Schema resolves session log validation failures by updating Zod schemas to handle new data formats without breaking existing JSONL files. It guides you through locating the relevant schema, updating type definitions, adding tests, and creating a pull request with all changes verified.
Fix Schema updates Zod schemas to resolve session log validation errors while preserving backward compatibility.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-05-10
Fix Schema updates Zod schemas to resolve session log validation errors while preserving backward compatibility. Fix Schema resolves session log validation failures by updating Zod schemas to handle new data formats without breaking existing JSONL files. It guides you through locating the relevant schema, updating type definitions, adding tests, and creating a pull request with all changes verified.
Use it when
- Yes.
- Fix Schema resolves TypeScript type errors by updating conversation schemas, fixing parse errors in type definitions.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Install
d-kimuson/claude-code-viewer/fix-schema · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does Fix Schema handle zod schema parse errors?
Fix Schema resolves Zod schema parse errors by identifying validation failures in session logs, updating the schema definitions to accommodate new data formats, and ensuring backward compatibility with existing JSONL files. The tool guides you through locating the relevant schema, modifying type definitions, and verifying changes before creating a pull request.
Can Fix Schema update JSON schema while maintaining backward compatibility?
Yes. Fix Schema is designed to update JSON schemas for backward compatibility by supporting new data formats in session logs without breaking existing format support. It automates the process of identifying incompatible changes, updating TypeScript types, and running validation tests to confirm that schema modifications don't corrupt or reject previously valid data.
What does Fix Schema do to fix type errors in schema?
Fix Schema resolves TypeScript type errors by updating conversation schemas, fixing parse errors in type definitions, and ensuring type safety across your codebase. It automates schema fixes and creates pull requests with comprehensive type safety verification, allowing you to address validation failures systematically.
How can Fix Schema help with session log schema validation?
Fix Schema addresses session log schema validation by detecting Zod validation failures, updating schemas to handle new JSON data formats, and running tests to ensure changes don't break existing data. It provides automated guidance for locating schemas, updating types, adding tests, and creating verified pull requests with all modifications.
Does Fix Schema automate schema fixes and create pull requests?
Yes. Fix Schema automates schema fixes by identifying validation errors, updating type definitions, and creating pull requests with type safety verification included. The tool streamlines the entire process from error detection through schema updates to PR creation, ensuring all changes are tested and validated before submission.
What license does Fix Schema use?
Fix Schema is released under the MIT license, allowing free use, modification, and distribution of the tool for both commercial and personal projects.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
<role> Fix schema parse errors in session logs by updating Zod schemas to support new data formats while maintaining backward compatibility. Create PR after verification. </role>
<input> User provides failing JSON data from session logs. The data structure indicates what needs to be supported. </input>
<workflow>
1. Locate and update schema:
- Identify schema file in src/lib/conversation-schema/ based on JSON type field
- Update schema to support new data format
- Maintain backward compatibility with existing JSONL files
2. Fix type errors:
- Update affected components to handle new schema types
- Follow project type safety rules (no
ascasting)
3. Add tests:
- Create or update test files for modified schemas
- Verify both old and new formats parse successfully
4. Verify and commit:
- Run
pnpm typecheck(must pass) - Run
pnpm test(must pass) - Run
pnpm fix - Commit changes
5. Create PR:
- Push branch
- Create draft PR with summary of schema changes </workflow>
<principles> - **Backward
(truncated - see the full file via the links below)
File tree — 1 file
.agents/skills/fix-schema/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Fix Zod schema validation errors in session logs while maintaining backward compatibility”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Manage translations across multiple locales in Lingui catalogs without altering source keys or compiled outputs. The skill enforces preservation of placeholders, ICU syntax, and technical terminology while providing verification scripts to catch missing translations and ensure consistency.
This skill orchestrates the complete release process for claude-code-viewer, from version specification through signed commit creation, tag management, and GitHub Actions workflow monitoring. It handles version bumps (patch, minor, major, beta, or explicit semver), validates preconditions like SSH signing config, and guides you through GitHub Release note cleanup and publishing.
Master monorepo organization with AI-powered codebase analysis that identifies structural patterns and project conventions. This skill helps you maintain consistency across multi-package projects while preserving architectural decisions between work sessions. Works as an MCP server for your IDE or as an offline CLI tool.
This skill enables agents to inspect and verify schema modifications within XcodeBuildMCP, the Model Context Protocol server designed for iOS and macOS development workflows. Use it to ensure output structure integrity and catch breaking changes before they affect your build pipeline.
Prowler-ui equips you with the component patterns and design principles that power Prowler's cloud security platform. Learn the established conventions for building cohesive user interfaces and maintaining design consistency across the ecosystem. This skill bridges the gap between raw components and production-ready UI architecture.
This skill configures GitLeaks within Husky pre-commit hooks to catch secrets before they're committed, then runs a security audit on your code. It can optionally scan git history for previously leaked secrets and provides remediation guidance.