frontmatter-guard

Validate and repair YAML frontmatter in Markdown brain pages.

2|1|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/bish-x/bx-gbrain --skill frontmatter-guard-bish-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontmatter-guard
Source: https://github.com/bish-x/bx-gbrain/tree/main/skills/frontmatter-guard
Command: npx skills add https://github.com/bish-x/bx-gbrain --skill frontmatter-guard-bish-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures the integrity of YAML frontmatter in brain pages, preventing common errors and improving data quality.

Core Features & Use Cases

  • Validation: Automatically scans and validates frontmatter across all brain pages.
  • Auto-repair: Corrects mechanical errors in frontmatter without user intervention.
  • Audit Reporting: Provides detailed reports on frontmatter issues for analysis.
  • Pre-commit Hook: Integrates with Git repositories to prevent commit of malformed frontmatter.

Quick Start

Run the frontmatter audit with the command: gbrain frontmatter audit --json

Frequently Asked Questions about frontmatter-guard

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

FAQPage Schema
How do I validate YAML frontmatter in Markdown files automatically?

To validate YAML frontmatter automatically, run an audit command that scans all brain pages to ensure data integrity and prevent common formatting errors. It provides detailed audit reports for analysis.

Can I auto-repair malformed YAML frontmatter without manual intervention?

Yes, you can auto-repair malformed YAML frontmatter by running a validation script that corrects mechanical errors automatically. This enhances data integrity and system reliability without requiring user intervention.

How do I prevent committing invalid frontmatter using a pre-commit hook?

To prevent committing invalid frontmatter, integrate a pre-commit hook into your Git repository. This mechanism blocks malformed YAML frontmatter from being committed, ensuring data quality.

Does YAML frontmatter validation work for brain pages in content management systems?

Yes, YAML frontmatter validation works for brain pages in YAML-based content management systems. It is specifically designed for environments using Markdown for document storage and processing to enhance data reliability.

What is the best way to audit YAML frontmatter issues across all brain pages?

The best way to audit YAML frontmatter issues is to run an audit command that generates a JSON report. This provides detailed analysis of frontmatter problems across all brain pages to improve data quality.