Meta Skill Validation Skill

Meta Skill Validation

Framework for validating Claude Code skills against best practices. This skill provides checklists and templates used by validation commands.

When to Use This Skill

Validating a skill before publishing
Running quality checks on existing skills
Creating GitHub issues for skill improvements
Understanding validation criteria

Quick Navigation

| Resource | Purpose | |----------|---------| | checklists/frontmatter.md | Name, description, required fields | | checklists/structure.md | Token budget, progressive disclosure | | checklists/quality.md | Content quality checks | | checklists/8-pillars.md | 8+1 Pillar coverage for lang/convert skills | | templates/issue-templates.md | GitHub issue body templates |

Validation Levels

| Level | Scope | Command | |-------|-------|---------| | Quick | Naming, frontmatter, SKILL.md exists | just validate-skill <path> | | Standard | + Token budget, structure, quality | /refine-skill --check-only | | Deep | + 8 Pillars, meta-skill compliance | /validate-lang-conversion-skill |

Quick Validation

just validate-skill content/skills/my-skill

Checks:

Skill name format (hyphen-case, lowercase)
SKILL.md exists and has frontmatter
Description present and non-empty

Standard Validation

/refine-skill content/skills/my-skill --check-only

Adds:

Token budget (< 500 lines)
Progressive disclosure patterns
Content quality checklist
Directory structure

Deep Validation (for lang--dev and convert--* skills)

/validate-lang-conversion-skill convert-python-rust

# Or for pillar coverage only:
just validate-pillars lang-rust-dev

Adds:

8 Pillars coverage scoring
Meta-skill table updates
Conversion-specific checks

Severity Classification

| Severity | Definition | Action | |----------|------------|--------| | Critical | Blocks functionality, must fix before use | Create bug issue | | Warning | Should fix, impacts quality | Create enhancement issue | | Suggestion | Nice to have, improves experience | Create docs issue |

Thresholds

| Check | Critical | Warning | Pass | |-------|----------|---------|------| | SKILL.md lines | > 800 | 500-800 | < 500 | | Description length | > 300 chars | vague/missing | < 200, trigger words | | 8 Pillars score | < 4/8 | 4-5.5/8 | >= 6/8 | | 9 Pillars score | < 5/9 | 5-6.5/9 | >= 7/9 | | Type mappings | < 5 | 5-14 | >= 15 | | Pitfalls listed | 0-2 | 3-4 | >= 5 |

Justfile Integration

This skill documents validation criteria. Automation lives in justfile:

| Recipe | Purpose | |--------|---------| | validate-skill <path> | Quick structural validation | | validate-pillars <skill> | 8 pillars coverage check | | validate-all-skills | Batch validation | | validate-all-lang-skills | Batch lang skill validation |

Running Batch Validation

# All skills
just validate-all-skills

# Lang skills only (with pillar coverage)
just validate-all-lang-skills

# Single skill with pillars
just validate-pillars lang-rust-dev

Workflow Integration

Creating a New Skill

Use /create-skill or manual creation
Run just validate-skill <path> - quick check
Iterate until quick validation passes
Run /refine-skill --check-only - full check
Address warnings and suggestions

Validating Conversion Skills

Create with /create-lang-conversion-skill
Run /validate-lang-conversion-skill - includes pillar coverage
Review generated issues
Address gaps and re-validate

Pre-commit Validation

# Add to pre-commit config
- repo: local
  hooks:
    - id: validate-skills
      name: Validate Skills
      entry: just validate-all-skills
      language: system
      pass_filenames: false

Agent Skills: Meta Skill Validation

Install this agent skill to your local

Skill Files