frontmatter-guard

Validate and repair YAML frontmatter in markdown files with gbrain CLI.

45|11|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/beyonai/ByClaw --skill frontmatter-guard-beyonai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontmatter-guard
Source: https://github.com/beyonai/ByClaw/tree/main/middleware/openclaw/skills/gbrain/references/frontmatter-guard
Command: npx skills add https://github.com/beyonai/ByClaw --skill frontmatter-guard-beyonai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill resolves the accumulation of malformed YAML frontmatter in brain pages, which often leads to search failures, ingestion errors, and broken synchronization in knowledge management systems.

Core Features & Use Cases

  • Automated Validation: Scans brain pages for seven canonical error classes including missing closing markers, null bytes, and nested quote issues.
  • Safe Auto-Repair: Provides a non-destructive fix mechanism that creates .bak files before applying corrections to ensure data safety.
  • Use Case: Before performing a major brain sync, use this skill to audit your entire repository for structural integrity and automatically fix common formatting errors that would otherwise block the process.

Quick Start

Run the frontmatter audit command to scan your current directory and identify any malformed pages that require attention.

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 markdown files?

YAML frontmatter validation scans markdown files to detect and repair structural metadata errors like missing closing markers, null bytes, and nested quote issues, preventing search failures and ingestion errors in knowledge management systems.

Can I automatically repair YAML syntax errors without losing original markdown data?

Yes, you can automatically repair YAML syntax errors without losing data by using a non-destructive fix mechanism that creates .bak backup files before applying corrections to the markdown frontmatter.

What is the best way to audit a local brain repository for structural integrity?

The best way to audit a local brain repository for structural integrity is to run a frontmatter validation command that scans the entire directory to identify malformed pages and automatically fixes common formatting errors before a major sync.

How do I detect slug mismatches and missing delimiters in markdown frontmatter?

You can detect slug mismatches and missing delimiters in markdown frontmatter by running an automated validation scan across your local brain repositories to identify structural syntax errors that require attention.