skills.rest
jonhill90
jonhill90COMMUNITY
Explore all skills by this author →
GitHub

validate-skill

Validate SKILL.md files' frontmatter and structure against the Agent Skills specification.

8|3|Updated Jun 1, 2025
Search Tags:#documentation#markdown#quality-assurance#skill#validate#lint#frontmatter
One-click install
npx skills add https://github.com/jonhill90/vibes --skill validate-skill-jonhill90
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-skill
Source: https://github.com/jonhill90/vibes/tree/main/.github/skills/validate-skill
Command: npx skills add https://github.com/jonhill90/vibes --skill validate-skill-jonhill90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates a Skill's SKILL.md against the Agent Skills specification to ensure proper structure, required fields, and safe formatting before deployment or usage.

Core Features & Use Cases

  • Validates presence of YAML frontmatter and required fields (name, description).
  • Checks that the frontmatter name matches the directory and conforms to allowed format.
  • Flags missing, mismatched, or overly long fields and content issues to prevent invalid Skill units from loading.

Quick Start

Read the SKILL.md for a Skill and run the validator to confirm it meets the specification before publishing.

Frequently Asked Questions about validate-skill

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

FAQPage Schema
How do I validate a SKILL.md file for spec compliance?▼

To validate a SKILL.md file, run the validator to check YAML frontmatter presence, required fields, directory name matching, and content structure against the Agent Skills specification.

What is SKILL.md frontmatter validation?▼

SKILL.md frontmatter validation is the process of verifying that required YAML fields like name and description exist, match the directory name, and conform to allowed formats before deployment.

Why does my Skill fail validation before activation?▼

Your Skill fails validation due to missing frontmatter fields, mismatched names not matching the directory, overly long content, or incorrect markdown structure that violates the Agent Skills specification.

How do I check if a Skill's frontmatter matches the directory name?▼

You can check frontmatter and directory name alignment by running the validator, which automatically compares the frontmatter name field against the Skill's directory name and flags mismatches.

What fields are required in SKILL.md frontmatter?▼

The required fields in SKILL.md frontmatter are name and description, which must be present, match allowed formats, and have the name field correspond exactly to the enclosing directory.

Can I lint markdown content structure in SKILL.md files?▼

Yes, you can lint markdown content structure in SKILL.md files by running the validator, which inspects the content layout and flags structural issues to prevent invalid Skill units from loading.

Related Skills

Explore More Software Engineering Skills→
92Bilal2692Bilal26

canonical-format-checker

Validate lesson content against canonical SKILL.md structure and YAML frontmatter.

Community
Basic
Leonardo-CorteLeonardo-Corte
1

maestro-skill-author

Create or repair Maestro built-in skill definitions with validated SKILL.md frontmatter and registry rebuilding.

Community
Intermediate
HomericIntelligenceHomericIntelligence
18

quality-run-linters

Run Mojo format, markdownlint, and pre-commit hooks for code quality checks.

Official
Intermediate
bmorphismbmorphism

skill

Validate agent skills against the agentskills specification with skills-ref.

Community
Basic