--- title: "Skills Index Drift — 4x Undercount" type: incident status: resolved created: 2026-08-15 updated: 2026-08-15 resolved_on: 2026-08-15 confidence: high tags: [skills, wiki, drift, auto-regeneration] sources: [session-investigation, agent-estate-wiki] --- # Skills Index Drift — 4x Undercount ## Summary The `systems/skills-index.md` page in both wikis claimed **66 skills** when **330 were actually installed** — a 4x undercount. The page had been hand-written once on 2026-07-22/25 and never regenerated as the estate grew. ## Root Cause Static documentation for a mutable inventory. The skills tree at `~/.hermes/skills/` grew from ~66 to 330 skills over three weeks, but the wiki page was never updated because there was no automation to keep it in sync. ## Impact - Wiki page was 4x out of date - Any inventory-based decisions (skill loading, capacity planning) would have been based on wrong numbers - No functional impact — skills still loaded correctly via Tool Search ## Resolution 1. Regenerated `systems/skills-index.md` from the live skill tree (all 330 skills, 26 categories) 2. Created `regenerate-skills-index.sh` script for automated regeneration 3. Set up cron job `1a8e90ea2271` to run daily at 03:00 AWST 4. Script auto-commits and pushes to Gitea (`Anthony/agent-estate-wiki`) 5. Quartz site at `http://100.118.5.51:9120/systems/skills-index` rebuilt and redeployed ## Lesson Static wiki pages that reflect **mutable inventory** (skills, services, cron jobs) **MUST be auto-regenerated on a schedule**, not hand-maintained. The moment the estate grows, a hand-written page becomes stale. ## Prevention - Daily cron job regenerates skills-index.md from live tree - Page includes "auto-regenerated, do not hand-edit" warning - Same script pattern is reusable for other inventory pages (cron jobs, services, agents) ## Related - [[systems/skills-index]] — The updated page - [[systems/scheduled-tasks]] — The new cron job