faf-format-validator

Validate SKILL.md frontmatter and project.faf YAML formats for FAF compliance.

4|1|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/Wolfe-Jam/faf-skills --skill faf-format-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: faf-format-validator
Source: https://github.com/Wolfe-Jam/faf-skills/tree/main/skills/faf-format-validator
Command: npx skills add https://github.com/Wolfe-Jam/faf-skills --skill faf-format-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates two distinct YAML formats in the FAF ecosystem: SKILL.md frontmatter for Claude Code skills and project.faf YAML for universal project DNA, ensuring format integrity and preventing mixed-format errors.

Core Features & Use Cases

  • Validate YAML frontmatter in SKILL.md (name, description, allowed-tools) and its Markdown body to ensure activation instructions are properly structured.
  • Validate project.faf structure (format, project, architecture) for IANA compliance and reliable AI context.
  • Detect and report mixed-format errors, guiding users to correct the format choice and migrate if needed.

Quick Start

Validate SKILL.md and project.faf formats, then run the appropriate checks to confirm compliance.

Frequently Asked Questions about faf-format-validator

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

FAQPage Schema
How do I validate SKILL.md frontmatter format for Claude Code skills?

This skill checks that the SKILL.md frontmatter contains required YAML fields like name, description, and allowed-tools, and verifies the Markdown body has properly structured activation instructions.

What is the correct project.faf YAML structure for universal project DNA?

The correct project.faf YAML structure requires the format, project, and architecture fields to ensure IANA compliance and reliable AI context. This validation skill checks that your project.faf file contains these mandatory structural sections.

Why does mixing SKILL.md and project.faf formats cause validation errors?

Mixing SKILL.md and project.faf formats causes errors because each YAML format has distinct structural requirements for its specific use case. This skill detects mixed-format errors and guides you to correct the format choice and migrate properly.

How do I check if my YAML frontmatter meets activation instruction requirements?

You can check your YAML frontmatter by validating the SKILL.md file structure, ensuring the name, description, and allowed-tools fields are correctly formatted and the Markdown body contains properly structured activation instructions.

What happens when project.faf format validation fails IANA compliance checks?

When project.faf validation fails IANA compliance, this skill identifies the missing or malformed format, project, or architecture sections and reports the errors so you can fix the YAML structure for reliable AI context.

Can I use one validator for both SKILL.md and project.faf YAML formats?

Yes, this skill validates both distinct YAML formats in the FAF ecosystem. It checks SKILL.md frontmatter for Claude Code skills and project.faf for universal project DNA, while detecting and reporting any mixed-format errors.