af-frontmatter

Create or correct YAML frontmatter metadata in documentation files.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/GainInsightDev/websites --skill af-frontmatter
Or copy as Structured Prompt for Agent
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.