name: skillcheck description: Validates SKILL.md files for spec-facing structure, sizing, references, cross-agent compatibility, and agent-authored critique or graph diagnostics. version: "1.2.0" author: "Brad Kinnard (moonrunnerkc), Aftermath Technologies Ltd"
Use this skill when validating a SKILL.md file or a directory of skill files with the skillcheck CLI.
Validate
Run the default symbolic checks:
skillcheck SKILL.md
skillcheck skills/ --format json
The report includes errors, warnings, and info diagnostics. Exit code 0 means no errors. Exit code 1 means at least one error, or warnings with --warnings-as-errors. Exit code 2 means input or argument error. Exit code 3 means symbolic validation passed but ingested agent critique found semantic errors.
Agent workflows
For semantic self-critique, emit a prompt and ingest the returned JSON:
skillcheck SKILL.md --emit-critique-prompt > prompt.txt
skillcheck SKILL.md --ingest-critique response.json
For capability graph work, use:
skillcheck SKILL.md --analyze-graph
skillcheck SKILL.md --emit-graph --format json
Configuration
skillcheck.toml can set CLI defaults and frontmatter extension fields:
[frontmatter]
extension_fields = ["my-org-tag", "internal-id"]