validate-counts
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.
How do I install this agent skill?
npx skills add https://github.com/yonatangross/orchestkit --skill validate-countsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill validates project counts (hooks, skills, agents) for consistency across source files and documentation. It uses local bash scripts to perform counts via standard Unix utilities and provides reporting based on pre-defined rules. No security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
4/9 files flagged
What does this agent skill do?
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
# 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
| 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
Workflow
- Run
scripts/validate-counts.shfor full validation (counts + drift comparison), orscripts/count-all.shfor raw counts only - Read
CLAUDE.md— extract counts from Project Overview and Version section - Read
manifests/ork.json— check skill/agent/hook array lengths - Build the comparison table (see
rules/drift-reporting.mdfor format) - Flag any mismatches with file + field references; otherwise output "All counts consistent."
References
Load on demand with Read("${CLAUDE_SKILL_DIR}/references/<file>"):
| File | Content |
|---|---|
count-locations.md | Where every count lives and why drift happens |
Related Skills
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 completeness
Common Mistakes
- Counting from
plugins/instead ofsrc/— plugins/ may be empty after an interrupted build - Comparing against deleted alias manifests — only
manifests/ork.jsonexists in v7 - Forgetting the hook breakdown: global + agent-scoped + skill-scoped must sum to total
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/yonatangross/orchestkit/validate-counts">View validate-counts on skillZs</a>