Can I use this for errors found during npm test or CI?

Yes, it is specifically designed to reproduce and fix failures reported by npm run compile, npm test, or automated CI pipelines.

What happens if the doctor finds zero files?

You should check your --schemas glob pattern. The default is 'schemas/**/*.json', but you can customize this or use the --cwd flag to point to your schema directory.

What does the AJV Strict Schema Doctor actually do?

It identifies why AJV is failing to compile your JSON schemas in strict mode, classifies the specific error type, and provides specific code patches to fix the underlying issues.

Which versions of JSON Schema are supported?

It is optimized for modern versions, specifically targeting Draft 2020-12, but it works for any schema being compiled via AJV.

Does this skill disable AJV strict mode to fix errors?

No, its primary goal is to help you keep strict mode enabled. It favors schema-local fixes over global relaxations to ensure your data validation remains high-quality.

AJV Strict Schema Doctor

Name: AJV Strict Schema Doctor
Author: hesreallyhim

byhesreallyhim

•

安全与测试

Diagnoses and repairs AJV strict-mode JSON Schema compilation failures by identifying error classes and applying localized patches.

AJV Strict Schema Doctor is a specialized utility designed to handle the complexities of AJV's strict mode, particularly for Draft 2020-12 schemas. It provides an automated diagnostic workflow that classifies common errors—such as type-specific keyword issues, unresolved references, and invalid JSON structures—and offers schema-local fixes to maintain high validation standards without disabling strict mode. This tool is essential for developers struggling with CI/CD failures or complex schema migrations who need to ensure their JSON schemas are robust, standards-compliant, and secure.

主要功能

01Localized patching strategy to maintain strict mode enforcement

02Automated diagnostic script for classifying AJV strict-mode failures

03Detailed reporting with actionable triage instructions and fixes

04Detection of issues like strictTypes, strictRequired, and unresolved-ref

053 GitHub stars

06Comprehensive support for Draft 2020-12 and modern JSON Schema specs

使用场景

01Resolving complex $ref and $id conflicts in multi-file schema repositories

02Migrating legacy JSON schemas to modern AJV strict mode requirements

03Fixing 'schema won't compile' errors in CI/CD pipelines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hesreallyhim/claude-code-json-schema ajv-strict-schema-doctor

For use in Claude.ai and ChatGPT

Download Skill