skill-test

Run the static validation mode, which checks that SKILL.md has YAML frontmatter with exactly name and description, that the directory name matches in lowercase hyphen-case, and that relative links resolve. It also runs the official skill validator when available and reports the exit status.

Use forward testing, which spawns isolated subagents with the raw skill instructions. It covers explicit invocation, natural-language routing, near-miss prompts that should route elsewhere, and unsafe requests that must preserve approval gates.

It confirms the file has a useful display name, a short description between 25 and 64 characters, and a default prompt that explicitly names the skill. Mutating or destructive workflows must also disable implicit invocation.

No, testing is read-only by default. The validator reports a test matrix and improvement proposal, and only edits the tested skill after the user separately approves that change.

The scan flags hardcoded secrets, absolute developer paths, path escapes, unsupported model pins, product-specific tool declarations, and platform-only assumptions such as requiring a Unix compatibility layer on Windows.