canonical-format-checker

Validate lesson content against canonical SKILL.md structure and YAML frontmatter.

Updated Dec 7, 2025

Search Tags:#documentation #validation #patterns #canonical #frontmatter #format

Ready to run

npx skills add https://github.com/92Bilal26/TaskPilotAI --skill canonical-format-checker-92bilal26

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: canonical-format-checker
Source: https://github.com/92Bilal26/TaskPilotAI/tree/main/.claude/skills/canonical-format-checker
Command: npx skills add https://github.com/92Bilal26/TaskPilotAI --skill canonical-format-checker-92bilal26

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures content adheres to canonical sources by validating that instructional material follows the official skill format, YAML frontmatter, and canonical references. It prevents format drift when teaching platform patterns and ensures consistency with proven standards.

Core Features & Use Cases

Validates directory structure and filenames match canonical sources (e.g., .claude/skills/<name>/SKILL.md).
Verifies YAML frontmatter contains required fields (name, description) and aligns with canonical definitions.
Detects and reports format drift, providing concrete remediation guidance to restore canonical compliance.
Supports manual review triggers for content audits before publication.

Quick Start

Run the canonical-format-checker against a lesson folder to identify any structural or frontmatter drift.

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 lesson content?▼

You validate YAML frontmatter by checking that instructional material contains required fields like name and description, aligning with canonical definitions to prevent format drift across lessons.

What is canonical format drift in documentation and how do I detect it?▼

Canonical format drift occurs when lesson content deviates from the official skill structure, and you detect it by evaluating directory layouts and YAML frontmatter against authoritative reference sources during content review.

How do I ensure my SKILL.md frontmatter matches official skill patterns?▼

You ensure SKILL.md frontmatter matches official patterns by validating that required fields like name and description are present and align with canonical definitions during your manual content audit before publication.

Can I check .claude/skills directory layout compliance before publishing a lesson?▼

Yes, you can check .claude/skills directory layout compliance by running a format validation check against the lesson folder to ensure filenames and structures match canonical sources before publication.

Does canonical format validation work without external dependencies?▼

Canonical format validation works without external dependencies, evaluating directory structure, YAML frontmatter, and required fields internally to provide concrete remediation guidance for any detected drift.