skill-validator

Name: skill-validator
Availability: InStock
Author: SkillsCatalog

Validate agent skill directories against the SKILL.md specification.

1|1|Updated Jan 3, 2026

Search Tags:#validation #tooling #compliance #yaml #quality #ci

Ready to run

npx skills add https://github.com/SkillsCatalog/registry --skill skill-validator-skillscatalog

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-validator
Source: https://github.com/SkillsCatalog/registry/tree/main/skills/skill-validator
Command: npx skills add https://github.com/SkillsCatalog/registry --skill skill-validator-skillscatalog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) components.

What problem does it solve?

Validates agent skill directories to ensure SKILL.md frontmatter, naming conventions, and structural compliance align with the SkillsCatalog specification, preventing publishing errors and inconsistencies.

Core Features & Use Cases

Checks for presence of SKILL.md and valid YAML frontmatter (name, description)
Verifies that the directory name matches the name field
Validates structural depth and allowed top-level directories
Produces a clear validation report suitable for CI or manual review

Quick Start

Validate a skill directory to ensure compliance with the catalog standards.

Frequently Asked Questions about skill-validator

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

FAQPage Schema

How do I validate SKILL.md frontmatter and naming conventions for CI checks?▼

To validate SKILL.md frontmatter and naming conventions in CI, run the validator against your skill directories to check YAML correctness, directory name alignment, and structural depth compliance.

What is the best way to ensure a new skill submission complies with the catalog specification?▼

The best way to ensure new skill compliance is to validate the agent skill directory against the specification, verifying required frontmatter fields, directory naming alignment, and allowed top-level directories.

Does the skill validator check structural depth and allowed top-level directories?▼

Yes, the skill validator checks structural depth and allowed top-level directories to ensure your skill definitions align with the SkillsCatalog specification and reports issues and warnings consistently.

Why does my skill submission fail validation when the directory name does not match the frontmatter?▼

Skill validation fails because the directory name must exactly match the name field defined in the SKILL.md YAML frontmatter to maintain catalog consistency and prevent publishing errors.

Can I use PyYAML to validate agent skill definitions locally before submitting?▼

Yes, you can use the PyYAML-dependent validator locally to parse frontmatter and generate a clear validation report covering presence of SKILL.md, field correctness, and structural compliance.

What limitations exist when validating structural depth in skill directories?▼

Validation of structural depth is limited to checking allowed top-level directories and reporting inconsistencies; it does not modify or fix non-compliant directories automatically during the CI or manual review process.