/tools

Skill Validation Tools

validate-skill.py

Validate SKILL.md metadata before submitting a PR.

Usage

# Validate a single skill
python tools/validate-skill.py skills/my-new-skill/

# Validate all skills
python tools/validate-skill.py --all

What it checks

• SKILL.md exists in the skill directory
• Valid YAML frontmatter (between --- markers)
• Required fields present: name, description, domain, subdomain, tags
• Name is kebab-case, 1–64 characters
• Description is at least 50 characters (no upper limit; multi-line folded scalars are valid)
• Domain is cybersecurity
• Subdomain is from the allowed list
• Tags is a list with at least 2 items

Requirements

Python 3.8+ (stdlib only, no external dependencies)