Defame1297
6a94ccc270
- Add bats-core, bats-support, bats-assert as git submodules under tests/ - Add tests/run-bats.sh — discovers and runs all *.bats files in the repo - 17 tests for skill-audit/scripts/validate.sh: valid skill, --help, optional dirs, backtick-quoted placeholder exclusion, boundary checks (500 lines / 1024 chars), and failure cases (missing SKILL.md, name mismatch, placeholders, non-executable scripts, interactive prompts, invalid name formats, no args) - 16 tests for skill-write/scripts/new-skill.sh: scaffold structure, name substitution, numbers in name, /skill-audit reference in next-steps, and failure cases (uppercase, consecutive/leading/trailing hyphens, missing dest, existing target, no args) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
skill-audit
Audit a skill directory against the agentskills.io specification. Runs structural validation then a qualitative review across description quality, body discipline, formatting, file structure, and internal consistency.
What it does
- Runs
scripts/validate.shfor structural checks (name format, description length, line count, placeholder detection, script rules) - Reads all files in the skill directory
- Applies qualitative checks across seven dimensions
- Outputs a PASS/FAIL/SUGGESTION punch list with a specific fix proposal for every FAIL
Usage
/skill-audit
Provide the path to the skill directory to audit when invoking.
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents |
scripts/validate.sh |
Structural validator — checks name format, name matches directory, description length, line count, placeholder detection, script executable bit, and interactive-prompt detection |
README.md |
This file |