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.