schema.linter

Validate YAML, JSON, and TOML files against schemas with file:line reports.

Updated Aug 9, 2025
One-click install
npx skills add https://github.com/chrislyons/carbon-acx --skill schema-linter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema.linter
Source: https://github.com/chrislyons/carbon-acx/tree/main/.claude/skills/shared/schema-linter
Command: npx skills add https://github.com/chrislyons/carbon-acx --skill schema-linter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, jsonschema, toml, yamllint, prettier.

What problem does it solve?

Configuration files (YAML, JSON, TOML) are prone to syntax errors, missing fields, or type mismatches, leading to runtime failures. This skill automates the validation process, catching these issues before they impact your operations.

Core Features & Use Cases

  • Syntax & Schema Validation: Automatically checks YAML, JSON, and TOML files against defined schemas and rules.
  • Error Reporting: Provides detailed reports with file:line references for issues, including missing fields or invalid types.
  • Use Case: Integrate into your CI/CD pipeline or pre-commit hooks to ensure all configuration files are valid before deployment, preventing costly runtime errors and ensuring "AI works, you rest."

Quick Start

Example: Validate a TOML file

User: "Verify wrangler.toml is valid"

Output:

✅ wrangler.toml - Valid

Summary: 1 file valid

Frequently Asked Questions about schema.linter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate YAML, JSON, and TOML configuration files automatically?

Schema linting validates YAML, JSON, and TOML files against defined schemas and rules, checking for syntax errors, missing fields, and type mismatches. It produces detailed reports with file:line references so you catch issues before deployment.

Can I integrate configuration file validation into my CI/CD pipeline?

Yes. Validation can integrate into CI pipelines and pre-commit hooks to automatically check all config files—including wrangler.toml and embedded schemas—before they're deployed, preventing runtime failures.

What does a schema validation report include?

Reports provide comprehensive error and warning categorization with file:line references, missing field identification, type mismatch details, and suggested fixes for each issue found.

Does schema validation work with wrangler.toml and custom configuration formats?

Yes. It supports YAML, JSON, and TOML file validation across all config file types, including wrangler.toml and files with embedded schemas, applicable throughout your workflow.

Why should I validate configuration files before deployment?

Configuration errors—syntax mistakes, missing fields, type mismatches—cause runtime failures. Validation catches these issues early, preventing costly operational problems and ensuring reliable deployments.

What Python version and dependencies does schema validation require?

Schema validation requires Python 3.11+ with PyYAML, jsonschema, toml, yamllint, and prettier. These dependencies enable syntax checking, schema conformance validation, and comprehensive error reporting.