skills.rest
SkillsCatalog
SkillsCatalogOFFICIAL
Explore all skills by this author →
GitHub

skill-validator

Validate agent skill directories against the SKILL.md specification.

1|1|Updated Jan 3, 2026
Search Tags:#validation#tooling#compliance#yaml#quality#ci
One-click install
npx skills add https://github.com/SkillsCatalog/registry --skill skill-validator-skillscatalog
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
MiniMax-AIMiniMax-AI
2.9k

skill-creator

Generate Skill Units with YAML frontmatter, Markdown body, and bundled resources.

Official
Intermediate
agentxmagentxm
5

e2e-publish-check

Validate skill directory metadata, packaging, and dry-run publish readiness.

Official
Intermediate
JasonLoJasonLo

ss-validate-skills

Validate Claude Code skills for frontmatter, naming, and structural rules.

Community
Intermediate
tneztnez
3

skill-tester

Validate agent skills against the Agent Skills Specification v1.0 and generate structured reports.

Community
Basic