Skill Quality Auditor
Self-audit tool that scores every implemented skill against a 12-point quality checklist.
Usage
node skill-quality-auditor/scripts/audit.cjs [options]
Options
| Flag | Alias | Type | Required | Description |
|---|---|---|---|---|
--dir | -d | string | No | Project root directory (default: cwd) |
--skill | -s | string | No | Audit a single skill by name |
--min-score | number | No | Minimum passing score 0-12 (default: 0) |
Quality Checks (12 total)
- •SKILL.md has valid frontmatter (name, description, status)
- •SKILL.md has Troubleshooting section
- •SKILL.md has Usage section
- •Has package.json
- •Has executable script in scripts/
- •Uses skill-wrapper (runSkill/runSkillAsync)
- •Uses yargs for CLI arguments
- •Uses validators.cjs for input validation
- •Has TypeScript type definitions
- •Has unit test coverage
- •Has integration test coverage
- •Has proper error handling
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
SKILL.md not found | Running from wrong directory | Ensure --dir points to monorepo root |
No implemented skills found | No skills with status: implemented | Check SKILL.md frontmatter in skill directories |
Knowledge Protocol
- •This skill adheres to the
knowledge/orchestration/knowledge-protocol.md. It automatically integrates Public, Confidential (Company/Client), and Personal knowledge tiers, prioritizing the most specific secrets while ensuring no leaks to public outputs.