// Validates hook, skill, and agent counts are consistent across CLAUDE.md, hooks.json, manifests, and source directories. Use when counts may be stale after adding or removing components, before releases, or when CLAUDE.md Project Overview looks wrong.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | validate-counts |
| description | Validates hook, skill, and agent counts are consistent across CLAUDE.md, hooks.json, manifests, and source directories. Use when counts may be stale after adding or removing components, before releases, or when CLAUDE.md Project Overview looks wrong. |
| tags | ["validation","consistency","orchestkit"] |
| version | 2.0.0 |
| author | OrchestKit |
| user-invocable | false |
| disable-model-invocation | true |
| context | inherit |
| allowed-tools | ["Read","Bash","Grep","Glob"] |
| complexity | low |
| persuasion-type | discipline |
| effort | low |
| model | haiku |
Checks that hook, skill, and agent counts are consistent across all authoritative sources in OrchestKit. Outputs a comparison table and flags drift with precise file references.
# Full validation: counts src/ vs CLAUDE.md and manifests (run from repo root)
bash src/skills/validate-counts/scripts/validate-counts.sh
# Just get raw counts from src/
bash src/skills/validate-counts/scripts/count-all.sh
| Category | Rule | Impact | Key Pattern |
|---|---|---|---|
| Count Sources | rules/sources-authoritative.md (load ${CLAUDE_SKILL_DIR}/rules/sources-authoritative.md) | HIGH | Filesystem is authoritative; derived sources must match |
| Drift Detection | rules/drift-reporting.md (load ${CLAUDE_SKILL_DIR}/rules/drift-reporting.md) | HIGH | Comparison table + flag with file:field references |
Total: 2 rules across 2 categories
scripts/validate-counts.sh for full validation (counts + drift comparison), or scripts/count-all.sh for raw counts onlyCLAUDE.md — extract counts from Project Overview and Version sectionmanifests/ork.json — check skill/agent/hook array lengthsrules/drift-reporting.md for format)Load on demand with Read("${CLAUDE_SKILL_DIR}/references/<file>"):
| File | Content |
|---|---|
count-locations.md | Where every count lives and why drift happens |
release-checklist — Uses validate-counts as step 5 of the release gatedoctor — Broader health check that includes count validationaudit-skills — Quality audit for skill structure and completenessplugins/ instead of src/ — plugins/ may be empty after an interrupted buildmanifests/ork.json exists in v7