canonical-format-checker

Validate lesson content against canonical formats for skills, subagents, ADRs, and PHRs.

1|1|Updated Dec 23, 2025

Search Tags:#documentation #validation #patterns #quality #drift-detection #canonical #format

Ready to run

npx skills add https://github.com/NaveedTechLab/Sir-Junaid-Agents-Skills --skill canonical-format-checker-naveedtechlab

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: canonical-format-checker
Source: https://github.com/NaveedTechLab/Sir-Junaid-Agents-Skills/tree/main/skills/canonical-format-checker
Command: npx skills add https://github.com/NaveedTechLab/Sir-Junaid-Agents-Skills --skill canonical-format-checker-naveedtechlab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures content that teaches platform patterns adheres to authoritative canonical sources, preventing format drift and misalignment across Skills, Subagents, ADRs, PHRs, and specifications. It provides a standardized guardrails workflow to verify structure, frontmatter, and formatting before content is finalized.

Core Features & Use Cases

Canonical Source Alignment: Checks and references to canonical locations (.claude/skills/..), ensuring directory structure and YAML frontmatter match the canonical model.
Drift Detection Before Implementation: Validates that content follows the standard format and flags deviations for correction.
Review & Compliance Support: Assists lesson planners and content developers to verify consistency when teaching platform patterns or writing new canonical content.

Quick Start

Run the canonical-format-checker against your lesson draft to verify compliance with the canonical sources. If drift is detected, apply the recommended fixes to align with the canonical .claude/skills/, .claude/agents/, and specs structure.

Frequently Asked Questions about canonical-format-checker

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

FAQPage Schema

How do I validate YAML frontmatter and directory structure for documentation?▼

To validate YAML frontmatter and directory structure, the checker verifies that name and description fields match the canonical model and flags deviations for correction before content is finalized.

What is format drift detection in platform patterns?▼

Format drift detection is the process of ensuring content teaching platform patterns adheres to authoritative canonical sources, preventing misalignment across Skills, Subagents, ADRs, PHRs, and specifications.

How do I check SKILL.md naming conventions during lesson planning?▼

You check SKILL.md naming conventions by running the format checker against your lesson draft to verify compliance with canonical .claude/skills/ locations and apply recommended fixes.

Can I use canonical format validation for content review of ADRs and PHRs?▼

Yes, you can use canonical format validation during content review to verify alignment of ADRs, PHRs, and specifications with canonical formats and enforce the required directory layout.

What are the limitations of automated canonical source alignment?▼

Automated canonical source alignment focuses strictly on directory layout, YAML frontmatter, and SKILL.md naming conventions, meaning it validates structural compliance rather than verifying the semantic accuracy of the content itself.