Schema Guardian

Validate weekly report payloads against a fixed JSON schema.

3|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/vtran5290/0-VN-Agent-System --skill schema-guardian-vtran5290
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Schema Guardian
Source: https://github.com/vtran5290/0-VN-Agent-System/tree/main/.cursor/skills/schema_guardian
Command: npx skills add https://github.com/vtran5290/0-VN-Agent-System --skill schema-guardian-vtran5290

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Schema drift between runtime outputs and their schemas undermines data integrity. Schema Guardian helps protect schema consistency by validating reports against the defined schema and guiding safe evolution.

Core Features & Use Cases

  • Validate weekly report payloads against schemas to detect drift and misalignment.
  • Provide clear guidance for updating schemas, docs, and normalizers when new fields are added.
  • Integrate into CI pipelines to ensure every weekly report conforms to the schema before deployment.

Quick Start

Validate a sample weekly report using the included validation tools.

Frequently Asked Questions about Schema Guardian

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

FAQPage Schema
How do I validate a weekly report payload against a JSON schema?

To validate a weekly report payload against a JSON schema, you need to check that required fields like metadata.asof_date and schema_version exist. This ensures data consistency and detects schema drift in reporting workflows.

What is schema drift and how does it affect data pipelines?

Schema drift occurs when runtime outputs misalign with defined schemas, undermining data integrity in data pipelines. It happens when fields evolve without coordinated updates to schemas, docs, normalizers, and dashboards.

How do I prevent schema drift when adding new fields to reporting workflows?

To prevent schema drift when adding fields, validate weekly report payloads against a fixed JSON schema and coordinate updates to schemas, docs, normalizers, and dashboards. This guided evolution protects downstream systems from misalignment.

Can I use JSON schema validation in CI pipelines for weekly reports?

Yes, you can integrate JSON schema validation into CI pipelines to ensure every weekly report conforms to the schema before deployment. This prevents schema drift and verifies required fields like metadata.asof_date exist.

Does this schema validation approach work for downstream data quality checks?

Yes, schema validation works for downstream data quality checks by ensuring weekly reports produced and consumed by downstream systems conform to the fixed JSON schema. This prevents drift and maintains data integrity across pipelines.

What are the limitations of fixing schema drift after deployment?

Fixing schema drift after deployment is limited because downstream systems have already consumed misaligned payloads. Validating weekly reports against a fixed JSON schema before deployment prevents this data integrity issue proactively.