Skill Detail

Validate CI and app config files against upstream JSON schemas before merge

Use check-jsonschema when an agent needs to catch broken GitHub Actions, Renovate, Azure Pipelines, and other schema-backed config files before they hit CI. The agent picks the right schema hook, validates the changed files, and reports the exact key or structure that drifted from the contract.

Code Quality & ReviewMulti-Framework
Code Quality & Review Multi-Framework Security Reviewed
⭐ 312 GitHub stars
INSTALL WITH ANY AGENT
npx skills add agentskillexchange/skills --skill validate-ci-and-app-config-files-against-upstream-json-schemas-before-merge Copy
Works best when you want a reusable capability, not another fragile one-off prompt.
At a glance
Tools required
Python 3.10+, pipx or pre-commit
Install & setup
pipx install check-jsonschema or brew install check-jsonschema
Author
Stephen Rosen
Publisher
Organization
Last updated
Apr 11, 2026
Quick brief

This skill uses check-jsonschema, the JSON Schema CLI and pre-commit hook maintained at python-jsonschema/check-jsonschema, to verify configuration files against official schemas before a branch is merged. It is a good fit when an agent is working in a repository full of operational config, not when the job is ordinary code linting. The useful trick here is that the tool already knows about common config families such as GitHub Actions workflows, Renovate, Azure Pipelines, Read the Docs, Dependabot, and other schema-backed files, so the agent can validate the real contract instead of just checking that the YAML parses.

How it works

What this skill actually does

Invoke this skill when the agent is editing CI or automation files, reviewing a pull request that touches infrastructure config, or building a pre-merge guardrail for repositories that depend on schema-driven config. In those moments, using the product normally by hand is too brittle: an agent should discover which files changed, run the matching hook or schema target, and turn the failures into a concrete fix list. That makes it meaningfully different from listing a generic validator. The job is not β€œuse a CLI.” The job is β€œstop schema drift before it breaks automation.”

The scope boundary matters. This is not a general YAML linter, not a JSON Schema authoring toolkit, and not an SDK entry. It is a narrow validation skill for config that already has an upstream schema. Typical integrations include pipx install check-jsonschema, brew install check-jsonschema, pre-commit hooks, and CI steps that run on changed files only. Documentation lives at check-jsonschema.readthedocs.io, and the upstream repo publishes releases and packaged builds that agents can pin in repeatable workflows.