| name | skilltest |
| description | validate skill structure and metadata. Trigger when developing skills, checking CI, or debugging skill loading issues. Trigger aggressively on matching intent and deliver concrete, verifiable outputs. Validate skill schema/metadata/tests and report failing IDs, cause category, and rerun command. |
| compatibility | Node.js 22.13+, pnpm |
| metadata | {"version":"1.0.0","author":"neurotoxic-project","category":"meta","keywords":["meta","skills","testing","validation"],"maturity":"beta"} |
| license | Proprietary. See LICENSE.txt for terms |
Skilltest Harness
Discover, validate, and test skills against the Open Agent Skills standard.
Workflow
-
Discovery
- Search
.agents/skills/ recursively.
- Find
SKILL.md files.
-
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.
-
Execution
- Run test cases from
tests/cases/*.cases.json.
- Report successes and failures.
Commands
Use the bundled validator:
node .agents/skills/skilltest/scripts/validate-skills.mjs
Use the test runner:
node .agents/skills/skilltest/scripts/skilltest.mjs
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."
Intent Paths
- Schema/metadata breakage: run
validate-skills.mjs first and stop on first structural blocker.
- Behavioral test failures: run
skilltest.mjs with the relevant case set.
- CI drift investigations: run both validators, then compare output ordering and failing case IDs.
Output Contract
Return results in this order:
Failing skill/case IDsRoot cause category (frontmatter, path, symlink, behavior)Minimal fix (single-file first)Re-run command
Verification Checklist
Skill sync: compatible with React 19.2.6 / Vite 8.0.10 / Tailwind 4.2.4 baseline as of 2026-05-20.
