frontmatter-guard

Validate and repair YAML frontmatter on brain pages for knowledge graph ingestion.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents and repairs structural corruption in brain pages, such as malformed YAML frontmatter, null bytes, or missing delimiters, which can cause search and synchronization failures.

Core Features & Use Cases

  • Automated Validation: Scans brain pages against seven canonical validation classes to detect structural errors.
  • Safe Auto-Repair: Automatically fixes common issues like nested quotes or missing closing delimiters while creating backups for safety.
  • Use Case: Use this skill to audit your entire knowledge base for corrupted files or to verify that new pages meet structural standards before committing them to your repository.

Quick Start

Ask the agent to audit the frontmatter of your brain pages and fix any detected errors.

Frequently Asked Questions about frontmatter-guard

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

FAQPage Schema
How do I fix malformed YAML frontmatter in my knowledge base pages?

YAML frontmatter validation scans brain pages against seven canonical validation classes to detect structural errors like null bytes, slug mismatches, and missing delimiters, ensuring proper knowledge graph ingestion and search synchronization.

How do I validate YAML frontmatter before committing new pages to my repository?

You validate YAML frontmatter by running an automated audit across your registered brain sources to detect structural corruption, verifying that new pages meet standards before committing them to your repository.

What causes brain pages to fail search and synchronization due to YAML syntax errors?

Brain pages fail search and synchronization due to structural corruption such as malformed YAML frontmatter, nested quotes, null bytes, or missing closing delimiters, which disrupt knowledge graph ingestion and must be repaired.

Can I safely auto-repair missing closing delimiters and slug mismatches in YAML files?

Yes, you can safely auto-repair missing closing delimiters, slug mismatches, and nested quotes because the repair workflow creates safety backups before modifying files, ensuring data integrity is preserved during structural fixes.

What is the best way to audit an entire knowledge base for corrupted page metadata?

The best way to audit an entire knowledge base for corrupted metadata is running a multi-phase workflow that scans registered brain sources to detect and resolve structural issues like null bytes and YAML syntax errors across all files.

Does frontmatter validation work across multiple registered brain sources at once?

Yes, frontmatter validation operates across multiple registered brain sources simultaneously, scanning all pages to detect and resolve structural integrity issues like null bytes, slug mismatches, and syntax errors for knowledge graph ingestion.