skill-test

Validate skill markdown files against structural and behavioral requirements.

1|Updated May 3, 2026

Search Tags:#linting #skill validation #YAML frontmatter #behavioral testing #protocol compliance #coverage audit

Ready to run

npx skills add https://github.com/imclab/xrA1-swarm --skill skill-test-imclab

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-test
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/skill-test
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill skill-test-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of broken or inconsistent skill definitions by automatically validating that each skill’s structure and documented behavior are correct before you rely on it in production.

Core Features & Use Cases

Structural linting for skill files: Ensures every .claude/skills/*/SKILL.md includes required frontmatter and follows expected formatting and handoff conventions.
Spec-driven behavioral verification: Checks whether the skill instructions satisfy assertions defined in the corresponding test spec from the IMC Skill Testing Framework.
Category rubric evaluation: Scores skills against category-specific metrics to catch missing capabilities or protocol gaps.
Audit coverage reporting: Produces a coverage view of skill specs, test history, and gaps across the repository.

Quick Start

Run the command "/skill-test static all" to structurally lint every skill and quickly surface missing required fields or protocol issues.

Frequently Asked Questions about skill-test

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

FAQPage Schema

How do I validate skill markdown files for structural correctness and YAML frontmatter?▼

Structural linting validates skill markdown files by enforcing required YAML frontmatter fields, phase formatting, verdict keywords, and protocol compliance language to ensure structural correctness before production use.

What is skill behavioral testing and how does spec-driven verification work?▼

Skill behavioral testing checks whether skill instructions satisfy assertions defined in a test spec from the IMC Skill Testing Framework, verifying documented behavior against expected outcomes and protocol compliance.

How do I audit skill coverage and identify test gaps across a repository?▼

Audit coverage reporting produces a view of skill specs, test history, and gaps across the repository, identifying missing capabilities and protocol gaps through category rubric scoring and repository-wide coverage audits.

Can I lint all skills at once to surface missing required fields and protocol issues?▼

Yes, running a static lint command across all skills structurally validates every file, quickly surfacing missing required YAML frontmatter fields, phase formatting issues, and protocol compliance gaps.

What's the best way to score skills against category-specific metrics and rubrics?▼

Category rubric evaluation scores skills against category-specific metrics to catch missing capabilities or protocol gaps, applying standardized rubric criteria to ensure skills meet expected behavioral and structural standards.

Why does skill validation fail on missing next-step handoff guidance?▼

Skill validation fails on missing handoff guidance because the linter enforces next-step handoff guidance and protocol compliance language as required structural elements within skill markdown files.