validate-counts

Original：🇺🇸 English
Translated
2 scripts

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.

15installs
Sourceyonatangross/orchestkit
Added on

NPX Install

npx skill4agent add yonatangross/orchestkit validate-counts

Tags

Translated version includes tags in frontmatter
count-validationagent-componentsskill-managementorchestkit-toolsrelease-readiness

SKILL.md Content

View Translation Comparison →

Validate Counts

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.

Quick Start

bash
# 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

Rules

CategoryRuleImpactKey Pattern
Count Sources
rules/sources-authoritative.md
(load 
${CLAUDE_SKILL_DIR}/rules/sources-authoritative.md
)		HIGHFilesystem is authoritative; derived sources must match
Drift Detection
rules/drift-reporting.md
(load 
${CLAUDE_SKILL_DIR}/rules/drift-reporting.md
)		HIGHComparison table + flag with file:field references
Total: 2 rules across 2 categories

Workflow

  1. Run 
    scripts/validate-counts.sh
    for full validation (counts + drift comparison), or 
    scripts/count-all.sh
    for raw counts only
  2. Read 
    CLAUDE.md
    — extract counts from Project Overview and Version section
  3. Read 
    manifests/ork.json
    — check skill/agent/hook array lengths
  4. Build the comparison table (see 
    rules/drift-reporting.md
    for format)
  5. Flag any mismatches with file + field references; otherwise output "All counts consistent."

References

Load on demand with 
Read("${CLAUDE_SKILL_DIR}/references/<file>")
:
FileContent
count-locations.md
Where every count lives and why drift happens

Related Skills

  • release-checklist
    — Uses validate-counts as step 5 of the release gate
  • doctor
    — Broader health check that includes count validation
  • audit-skills
    — Quality audit for skill structure and completeness

Common Mistakes

  1. Counting from 
    plugins/
    instead of 
    src/
    — plugins/ may be empty after an interrupted build
  2. Comparing against deleted alias manifests — only 
    manifests/ork.json
    exists in v7
  3. Forgetting the hook breakdown: global + agent-scoped + skill-scoped must sum to total