audit-skills Skill | Agent Skills

audit-skills

Scans all src/skills/*/SKILL.md files and reports compliance with OrchestKit authoring standards. Each category has individual files in rules/ and references/ loaded on-demand.

Quick Reference

| Category | File | Impact | When to Use | |----------|------|--------|-------------| | Audit Checks | ${CLAUDE_SKILL_DIR}/rules/audit-checks.md | HIGH | What to validate per skill | | Status Rules | ${CLAUDE_SKILL_DIR}/rules/audit-status.md | MEDIUM | PASS/WARN/FAIL classification | | Output Format | ${CLAUDE_SKILL_DIR}/references/output-format.md | MEDIUM | Table layout and column definitions | | Edge Cases | ${CLAUDE_SKILL_DIR}/references/edge-cases.md | LOW | Manifest "all", orchestration skills |

Total: 2 rules across 2 categories

CRITICAL: Task Management is MANDATORY (CC 2.1.16)

BEFORE doing ANYTHING else, create tasks to track progress:

# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Audit Skills: full scan",
  description="Auditing all OrchestKit skills for quality and compliance",
  activeForm="Auditing skill quality"
)

# 2. Create subtasks for each audit phase
TaskCreate(subject="Discover skills", activeForm="Globbing SKILL.md files")
TaskCreate(subject="Run audit checks", activeForm="Checking each skill")
TaskCreate(subject="Classify & render", activeForm="Classifying results and rendering report")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Before starting each task, verify it's unblocked
task = TaskGet(taskId="2")  # Verify blockedBy is empty

# 5. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done

Workflow

Discover — Glob src/skills/*/SKILL.md to get full skill list
Check each skill — Run all checks from Read("${CLAUDE_SKILL_DIR}/rules/audit-checks.md") in parallel
Classify — Apply status rules from Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md")
Render — Output table using format from Read("${CLAUDE_SKILL_DIR}/references/output-format.md")
Totals — Show X pass, Y warn, Z fail at bottom

Quick Start

bash src/skills/audit-skills/scripts/run-audit.sh

Or invoke manually — Claude scans src/skills/, applies checks, and renders the summary table.

CC 2.1.152+: After fixing SKILL.md files surfaced by the audit, run /reload-skills to re-scan skill directories and pick up the changes in-session (no restart). For plugin-packaged skills, rebuild + /reload-plugins instead.

Key Decisions

| Decision | Recommendation | |----------|----------------| | Manifest check | "skills": "all" in ork.json means ALL skills qualify — mark YES | | 0 rules + refs | WARN only — some orchestration skills are legitimately rules-free | | Broken refs | WARN (not FAIL) — file may exist under a different path |

Related Skills

ork:skill-evolution — Guidance on iterating and improving skills
ork:quality-gates — Broader codebase quality checks

Agent Skills: audit-skills

Install this agent skill to your local