canonical-model-validator

Validate canonical model JSON files against the schema and report structural issues.

3|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill canonical-model-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: canonical-model-validator
Source: https://github.com/SteveGJones/jack-tar-deckhand/tree/main/.claude/skills/canonical-model-validator
Command: npx skills add https://github.com/SteveGJones/jack-tar-deckhand --skill canonical-model-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill validates canonical model JSON files against the schema to detect structural issues and broken references, helping teams catch configuration errors before they affect diagrams, documentation, or governance reviews.

Core Features & Use Cases

  • Structural validation of core entities such as modelMetadata, services, aiPersonas, humanActors, systemActors, interactions, and externalInteractions.
  • Referential integrity checks across the model with clear errors and warnings.
  • Generates a structured validation report suitable for CI gates, reviews, and governance workflows.
  • Integrates with canonical-model-manager to support end-to-end model governance and diagram generation.

Quick Start

Validate a canonical model JSON using the canonical-model-manager workflow to produce a validation report for the target model file.

Frequently Asked Questions about canonical-model-validator

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

FAQPage Schema
How do I validate a canonical model JSON file for structural issues?

The validator integrates with canonical-model-manager to support end-to-end model governance and diagram generation. Together they validate structural integrity and manage the canonical model lifecycle within governance workflows.

How does referential integrity validation work for canonical models?

Referential integrity checks ensure that cross-references between entities like services, aiPersonas, and interactions remain valid. The validator detects broken references during model creation, modification, import, or merging to prevent configuration errors.

What structural entities are checked during canonical model validation?

The canonical model validator enforces structural rules for modelMetadata, services, aiPersonas, humanActors, systemActors, interactions, and externalInteractions. It checks these core entities against the schema to ensure governance-ready models.

Can I use canonical model validation in CI-CD pipelines?

Yes, the validator generates a structured validation report suitable for CI gates. You can integrate canonical model validation into CI-CD pipelines to catch configuration errors before they affect downstream diagrams or governance reviews.

When do I need to validate a canonical model?

Use canonical model validation when creating, modifying, importing, or merging model JSON files. It safeguards models by detecting structural issues and broken references before they affect diagrams, documentation, or governance workflows.

Does the canonical model validator work with model management tools?

The validator integrates with canonical-model-manager to support end-to-end model governance and diagram generation. Together they validate structural integrity and manage the canonical model lifecycle within governance workflows.