Back to Skills
Skill

audit-skills

From ork
128
Install
1
Install the plugin
$
npx claudepluginhub yonatangross/orchestkit --plugin ork

Want just this skill?

Add to a custom plugin, then install with one command.

Description

Audits all OrchestKit skills for quality, completeness, and compliance with authoring standards. Use when checking skill health, before releases, or after bulk skill edits to surface SKILL.md files that are too long, have missing frontmatter, lack rules/references, or are unregistered in manifests.

Tool Access

This skill is limited to using the following tools:

ReadGlobGrepBashWriteEditTaskCreateTaskUpdateTaskList
Supporting Assets
View in Repository
references/edge-cases.md
references/output-format.md
rules/_sections.md
rules/_template.md
rules/audit-checks.md
rules/audit-status.md
scripts/run-audit.sh
test-cases.json
Skill Content

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

CategoryFileImpactWhen to Use
Audit Checks${CLAUDE_SKILL_DIR}/rules/audit-checks.mdHIGHWhat to validate per skill
Status Rules${CLAUDE_SKILL_DIR}/rules/audit-status.mdMEDIUMPASS/WARN/FAIL classification
Output Format${CLAUDE_SKILL_DIR}/references/output-format.mdMEDIUMTable layout and column definitions
Edge Cases${CLAUDE_SKILL_DIR}/references/edge-cases.mdLOWManifest "all", orchestration skills

Total: 2 rules across 2 categories

Workflow

  1. Discover — Glob src/skills/*/SKILL.md to get full skill list
  2. Check each skill — Run all checks from Read("${CLAUDE_SKILL_DIR}/rules/audit-checks.md") in parallel
  3. Classify — Apply status rules from Read("${CLAUDE_SKILL_DIR}/rules/audit-status.md")
  4. Render — Output table using format from Read("${CLAUDE_SKILL_DIR}/references/output-format.md")
  5. 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.

Key Decisions

DecisionRecommendation
Manifest check"skills": "all" in ork.json means ALL skills qualify — mark YES
0 rules + refsWARN only — some orchestration skills are legitimately rules-free
Broken refsWARN (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
Stats
Stars128
Forks14
Last CommitMar 10, 2026
Actions

Similar Skills