frontmatter-guard
CommunityPrevent broken brain pages from entering
Software Engineering#data integrity#yaml frontmatter#auto-repair#slug consistency#brain page validation#CI linting
Authorweiping
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It prevents malformed YAML frontmatter from breaking ingestion, audit, search, and downstream brain operations by validating and (when safe) repairing common structural and data issues before pages enter the system.
Core Features & Use Cases
- Frontmatter validation across canonical classes: Detects missing delimiters, YAML parse failures, slug mismatches, null bytes, nested-quote title issues, and empty frontmatter.
- Audit and targeted validation: Runs multi-source audits with per-source counts and samples, or validates a specific file/directory for CI and pre-commit workflows.
- Safe auto-repair with backups: Applies fix mode with .bak backups for auto-fixable issues while avoiding risky repairs for cases that typically need human review.
Quick Start
Ask your agent to run a frontmatter audit and return JSON counts of any issues it finds across the brain.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: frontmatter-guard Download link: https://github.com/weiping/gbrain-cn/archive/main.zip#frontmatter-guard Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.