# Pillar #4 — Skills Audit Overview

# Pillar #4 — Skills Audit Overview

**Date:** 2026-05-04  
**MC:** #99131  
**Phase:** DESIGN + PoC (Phase 2)  
**Spec:** `agentic-os-pillar4-skills-audit-2026-05-04.md`

---

## Executive Summary

This audit covers the ALAI skill system progressive-disclosure refactor: 79 skills inventoried, top-20 refactor priorities identified, L0-L3 rubric established, and PoC analysis completed for `task-postflight` skill.

### Key Findings

- 79 active skill directories on disk; 94 rows in skill-registry.db (32 phantoms, 17 unregistered)
- Only 15 skills have any log invocations in the 19-day measurement window
- `mehanik` (186 hits) and `update-config` (1 hit) appear in logs but have no disk directory — ghost invocations
- 9 skills with references/ dir; 70 are monolithic (L0/L1)
- 12 TOB skills have nested structure — invisible to Claude Code flat-discovery loader
- Highest-priority refactor target: `task-postflight` (5,367 tokens × 21 measured invocations = priority\_score 82.05)
- **Reality anchor:** At current ALAI scale (Claude Max flat-rate subscription), context-bloat incremental cost is approximately $0-2/month. The value of this audit is **context window capacity management**, not dollar cost reduction.

---

## Inventory Summary

<table id="bkmrk-metricvaluesource-ac"><thead><tr><th>Metric</th><th>Value</th><th>Source</th></tr></thead><tbody><tr><td>Active skill dirs on disk</td><td>79</td><td>`ls ~/.claude/skills/ | grep -v _archived | wc -l`</td></tr><tr><td>Archived skills</td><td>32</td><td>`ls ~/.claude/skills/_archived/ | wc -l`</td></tr><tr><td>skill-registry.db rows</td><td>94</td><td>`sqlite3 skill-registry.db 'SELECT COUNT(*) FROM skills;'`</td></tr><tr><td>DB-only phantoms</td><td>32</td><td>comm comparison</td></tr><tr><td>Disk-only unregistered</td><td>17</td><td>comm comparison</td></tr><tr><td>Skills with references/ dir</td><td>9</td><td>find query</td></tr><tr><td>Skills with invocations in window</td><td>15</td><td>log grep</td></tr><tr><td>Measurement window</td><td>19 days</td><td>2026-04-16 to 2026-05-05</td></tr><tr><td>Total invocations in window</td><td>267</td><td>awk filter</td></tr><tr><td>Ghost invocations (mehanik)</td><td>186</td><td>log grep — mehanik not on disk</td></tr></tbody></table>

---

## Aggregate Savings Projection

<table id="bkmrk-skills-loaded-per-tu"><thead><tr><th>Skills loaded per turn</th><th>Tokens saved vs. baseline</th><th>% context window recovered (128K window)</th></tr></thead><tbody><tr><td>Only task-postflight (PASS path)</td><td>3,500 tokens</td><td>2.7%</td></tr><tr><td>task-postflight + prompt-forge</td><td>4,700 tokens</td><td>3.7%</td></tr><tr><td>Top-5 hot-path skills (ranks 1-5)</td><td>7,300 tokens</td><td>5.7%</td></tr><tr><td>All top-20 (max benefit, full session)</td><td>19,500 tokens</td><td>15.2%</td></tr><tr><td>All 79 skills at L3 (theoretical max)</td><td>~35,000 tokens</td><td>27.3%</td></tr></tbody></table>

*Assumes 40-50% body-token reduction per skill post-refactor. These are per-turn estimates derived from body-token reduction; monthly projections without measured session counts would be phantom claims.*

---

## Related Documentation

- **Skills Inventory:** Top 20 Priority table with per-skill triage
- **L0-L3 Design Pattern:** Progressive-disclosure rubric and anti-pattern catalog
- **PoC Analysis:** task-postflight refactor demonstration (541 → 194 LOC, 64.7% reduction)

**Source spec:** `~/system/specs/agentic-os-pillar4-skills-audit-2026-05-04.md` (479 lines)  
**HiveMind record:** TBD  
**MC:** #99131 (ready\_for\_review)