frontmatter-validation

Validate and fix YAML frontmatter in Markdown documentation files.

13|3|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/Everyone-Needs-A-Copilot/claude-copilot --skill frontmatter-validation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontmatter-validation
Source: https://github.com/Everyone-Needs-A-Copilot/claude-copilot/tree/main/templates/skills/frontmatter-validation
Command: npx skills add https://github.com/Everyone-Needs-A-Copilot/claude-copilot --skill frontmatter-validation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Frontmatter metadata is essential for AI-assisted navigation and tooling. This skill ensures every Markdown file includes valid, complete YAML frontmatter and fixes common issues automatically.

Core Features & Use Cases

  • Validate required fields and types (name, description, token_estimate, last_updated).
  • Auto-fix missing fields and stale values across an entire repository.
  • Infer metadata from file paths and apply consistent schemas to SKILL.md and documentation files.

Quick Start

Run the frontmatter-validation skill on a Markdown repository to scan and auto-fix frontmatter across all *.md files.

Frequently Asked Questions about frontmatter-validation

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

FAQPage Schema
How do I validate YAML frontmatter across multiple Markdown files in a repository?

YAML frontmatter validation scans an entire Markdown repository to check required fields like name, description, and last_updated. It performs batch validation on all files, enforcing consistent schemas and generating a report of any inconsistencies found.

Can I automatically fix missing or stale metadata in Markdown documentation?

Yes, you can automatically fix missing metadata and stale values in Markdown documentation. The validation process auto-fixes common frontmatter issues by inferring correct metadata from file paths and applying a consistent schema across the repository.

What fields are required for valid YAML frontmatter in documentation?

Valid YAML frontmatter requires specific fields: name, description, token_estimate, last_updated, and status. The validator checks that these required fields are present, validates their data types, and ensures the values match the expected schema.

What's the best way to ensure consistent metadata across a large documentation repository?

The best way to ensure consistent metadata across a large documentation repository is batch validation. This process scans multiple Markdown files, enforces required frontmatter fields, validates data types, and automatically applies standardized schemas to maintain consistency.

Does frontmatter validation work with SKILL.md entries and standard docs?

Frontmatter validation works with both standard Markdown documentation files and SKILL.md entries. It targets large repositories containing multiple documentation formats, applying consistent schemas and validating required metadata fields across all file types.