skills.rest
FrancisVarga
FrancisVargaCOMMUNITY
Explore all skills by this author →
GitHub

skill-test

Validate Claude Skill directories for required SKILL.md structure and compliance.

Updated May 13, 2026
Search Tags:#static analysis#Claude Code#skill validation#behavioral testing#coverage audit#frontmatter compliance
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill skill-test-francisvarga
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-test
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/skill-test
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill skill-test-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken or inconsistent Claude Code skills by verifying that each skill’s SKILL.md has the required structure, documented modes, and operational guidance.

Core Features & Use Cases

  • Structural linting: Detects missing frontmatter fields, missing phase structure, missing verdict keywords, and weak handoff guidance across one skill or all skills.
  • Behavioral verification (spec mode): Validates that the skill’s written instructions satisfy assertions defined in an associated test spec.
  • Category rubric checks: Scores skills against category-specific quality metrics from the CCGS Skill Testing Framework rubric.
  • Coverage audits: Reports which skills/agents have specs, last test dates/results, and priority gaps.

Quick Start

Run /skill-test static skill-test to lint the skill’s SKILL.md for structural compliance.

Frequently Asked Questions about skill-test

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

FAQPage Schema
How do I validate Claude Code skill frontmatter and phase structure?▼

Run a static analysis linting check on the skill directory to validate SKILL.md frontmatter, phase structure, verdict keywords, and handoff guidance. This enforces structural compliance and prevents broken Claude Code skills.

How do I check if a Claude Code skill passes behavioral test specs?▼

Run spec mode validation to verify that the skill's written instructions satisfy assertions defined in an associated test spec. This provides behavioral verification for Claude Code skills to ensure deterministic execution.

What is the best way to audit test coverage for a repository of Claude Code skills?▼

Run a coverage audit to report which skills and agents have associated test specs, last test dates, and results. This identifies priority gaps across the entire repository to ensure comprehensive skill testing.

Can I score Claude Code skills against category-specific quality metrics?▼

Run category rubric checks to score Claude Code skills against category-specific quality metrics from the CCGS Skill Testing Framework. This provides deterministic structural and behavioral quality scoring for skill evaluation.

Does Claude Code skill validation work without external dependencies?▼

Yes, Claude Code skill validation uses a deterministic, tool-restricted workflow relying only on the existing skill, hook, and template architecture. It requires no external dependencies to enforce static checks and audits.

Related Skills

Explore More Software Engineering Skills→
NickCrewNickCrew
29

skill-creator

Create or update Claude skills with structured SKILL.md files.

Community
Basic
johnatas-henriquejohnatas-henrique

skill-test

Validate AI skill files for structural compliance and behavioral correctness.

Community
Intermediate
OshanKHZOshanKHZ
5

hook-development

Create and implement Claude Code plugin hooks for lifecycle events.

Community
Advanced
imclabimclab
1

skill-test

Validate skill markdown files against structural and behavioral requirements.

Official
Advanced