skilltest

name	skilltest
description	validate skill structure and metadata. Trigger when developing skills, checking CI, or debugging skill loading issues.

Skilltest Harness

Discover, validate, and test skills against the Open Agent Skills standard.

Workflow

1. Discovery

   • Search .claude/skills/ recursively.
   • Find SKILL.md files.

2. Validation

   • Structure: Skill folder must contain SKILL.md.
   • Metadata: SKILL.md frontmatter must be valid YAML.
   • Paths: Scripts and references must exist.
   • Symlinks: Validate targets.

3. Execution

   • Run test cases from tests/cases/*.cases.json.
   • Report successes and failures.

Commands

Use the bundled validator:

node .claude/skills/skilltest/scripts/validate-skills.mjs

Use the test runner:

node .claude/skills/skilltest/scripts/skilltest.mjs

Generated report path:

reports/skills/skilltest-report.json

Example

Input: "Why isn't my skill showing up?"

Action: Run validator.

Output:

[FAIL] myskill/SKILL.md: Invalid YAML frontmatter.

"The frontmatter in myskill/SKILL.md is invalid. Fix the YAML syntax."

Skill sync: compatible with React 19.2.6 / Vite 8.0.10 / Tailwind 4.2.4 baseline as of 2026-05-20.