af-frontmatter

Create or correct YAML frontmatter metadata in documentation files.

Updated Feb 8, 2026

Search Tags:#documentation #validation #yaml #metadata #linking #frontmatter

Ready to run

npx skills add https://github.com/GainInsightDev/websites --skill af-frontmatter

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: af-frontmatter
Source: https://github.com/GainInsightDev/websites/tree/main/.claude/skills/af-frontmatter
Command: npx skills add https://github.com/GainInsightDev/websites --skill af-frontmatter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses issues with YAML frontmatter in documentation files, ensuring metadata is correctly formatted and linked.

Core Features & Use Cases

Create or Fix Frontmatter: Adds or corrects name, description, and other required fields.
Reference Management: Fixes parent, children, and related links between documentation files.
Use Case: When a documentation file fails validation due to missing or incorrect frontmatter, this Skill can automatically correct it, ensuring proper linking within the documentation system.

Quick Start

Use the af-frontmatter skill to fix the frontmatter in the file '/docs/new-feature.md'.

Frequently Asked Questions about af-frontmatter

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

FAQPage Schema

How do I fix YAML frontmatter validation errors in documentation files?▼

To fix YAML frontmatter validation errors, you need to ensure required metadata fields like `name`, `description`, `parent`, and `related` are correctly formatted. This process automatically corrects missing or invalid fields to resolve validation failures.

What is YAML frontmatter metadata used for in documentation?▼

YAML frontmatter metadata provides essential document attributes for discovery and navigation. It uses fields like `name`, `description`, `parent`, and `related` to establish structure and ensure proper bidirectional linking within a documentation system.

How do I resolve broken parent and related links between documentation files?▼

Resolving broken parent and related links requires correcting the reference fields in your YAML frontmatter. This process fixes `parent`, `children`, and `related` links to establish proper bidirectional navigation across your documentation files.

Do I need existing frontmatter fields before adding metadata to a documentation file?▼

You do not need existing frontmatter fields to add metadata to a documentation file. This process can create YAML frontmatter from scratch, adding the accurate `name`, `description`, `parent`, and `related` fields required for system validation.

What's the best way to ensure documentation metadata adheres to established standards?▼

The best way to ensure documentation metadata adheres to established standards is to validate and correct YAML frontmatter fields. This process enforces required `name`, `description`, `parent`, and `related` attributes for proper linking and compliance.