Files
agent-estate-wiki/incidents/2026-08-15-skills-index-drift.md
T
Tony0410 0c4ed3350b wiki audit 2026-10-02: 2 new cron failures, cliprox/terra connection auth incident, delivery-failure semantics corrected, profile rewrite, broken wikilinks repaired
- 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
2026-10-02 00:17:15 +08:00

1.9 KiB

title, type, status, created, updated, resolved_on, confidence, tags, sources
title type status created updated resolved_on confidence tags sources
Skills Index Drift — 4x Undercount incident resolved 2026-08-15 2026-08-15 2026-08-15 high
skills
wiki
drift
auto-regeneration
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)