- new: incidents/2026-10-01-cliproxy-connection-auth-expired.md (HTTP 401, credential fault, cannot self-recover)
- systems/scheduled-tasks.md: 30 jobs / 27 enabled; failing 3 -> 6; streaks advanced; wiki-tree drift recorded
- systems/messaging-integrations.md: two distinct thread-failure variants (lost vs thread-less fallback)
- systems/current-profile.md: full rewrite from live config (no profiles/default/, smart-route, OmniRoute)
- current-state.md / index.md / log.md: 2026-10-02 entry
- repair: copied 5 vault-only pages referenced by index.md (ignis, nextcloud, 3 incidents) so wikilinks resolve
- include pending stocktake output: skills-index.md 2026-09-27, raw/stocktake/freshness-2026-09-2{6,7}.txt
44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
---
|
|
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
|