Agents meta-skill-validation-dev

Validate Claude Code skills against best practices. Use when checking skill quality, running validation, or creating improvement issues.

install

source · Clone the upstream repo

git clone https://github.com/aRustyDev/agents

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/aRustyDev/agents "$T" && mkdir -p ~/.claude/skills && cp -r "$T/content/skills/meta-skill-validation-dev" ~/.claude/skills/arustydev-agents-meta-skill-validation-dev && rm -rf "$T"

manifest: content/skills/meta-skill-validation-dev/SKILL.md

source content

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