refactor(skills): fold 11 language/shell/k8s husk skills into umbrella references (M2)

README.md

@@ -11,7 +11,7 @@ AI agents skip steps.
 Harnesses have a second problem: given only a skill list, they do not route eagerly enough, or correctly enough. Good skills sit unused. So this toolkit connects the skills, agents, and workflows we want directly into the harness, automatically. You don't have to understand what is here. Say what you want in plain English and you get all the value we have put into it: the right specialist with the right methodology, behind gates that demand exit codes, not assertions.
 
 <!-- Counts here must match the Four Layers table (~line 143). Verify both: python3 scripts/validate-doc-counts.py -->
-44 domain agents, 131 workflow skills, 86 hooks, 129 scripts. Agents carry knowledge, skills enforce methodology, hooks block incomplete work, scripts handle determinism.
+44 domain agents, 120 workflow skills, 86 hooks, 129 scripts. Agents carry knowledge, skills enforce methodology, hooks block incomplete work, scripts handle determinism.
 
 Works across Claude Code (`/do`), Codex (`$do`), Factory (`/do`), Reasonix (`/do`).
 
@@ -148,7 +148,7 @@ Strips built-in tool-use instructions. The toolkit's agents, skills, hooks, and
 | Layer | Count | Does |
 |---|---|---|
 | Agents | 44 | Domain knowledge: idiom tables, failure mode catalogs, error-to-fix mappings |
-| Skills | 131 | Phased methodology with gates. Can't skip steps. Each phase has exit criteria requiring evidence. |
+| Skills | 120 | Phased methodology with gates. Can't skip steps. Each phase has exit criteria requiring evidence. |
 | Hooks | 88 | Fire on lifecycle events. Block incomplete work. Zero LLM cost. |
 | Scripts | 129 | Determinism: test runners, linters, validators. No LLM judgment. |
 

docs/docs-audit.md

@@ -16,7 +16,7 @@ Work order for follow-up PRs. Covers every `docs/` file outside the value-clarit
 | `what-didnt-work.md` | Future sessions, maintainers | Negative-results registry: failed experiments with evidence and decisions | None. Load-bearing for evidence-gated evolution; format is enforced and queryable. | keep |
 | `QUICKSTART.md` | New users | 30-second start: install, `/do`, mental model | Duplicates start-here.md (install, entry-point table, first commands, verify steps). No inbound links from README or any other doc; orphaned. Two starts confuse the funnel. | merge-into-start-here.md, then retire |
 | `REFERENCE.md` | Users wanting the full command list | "Everything in one place. Scan in 2 minutes." | Hand-maintained catalog; drifts from `INDEX.json` truth as components land. Only inbound link is QUICKSTART.md (itself a retire candidate). | rewrite: generate from `scripts/routing-manifest.py`; absorb QUICKSTART's "want the full list" pointer |
-| `skills.md` | Users browsing the skill catalog | Full catalog of 131 skills by category | Hand-maintained; same drift risk as REFERENCE.md. README links it, so it must stay accurate. | rewrite: generate via `scripts/generate-skill-index.py` output (script, not prose pass) |
+| `skills.md` | Users browsing the skill catalog | Full catalog of 120 skills by category | Hand-maintained; same drift risk as REFERENCE.md. README links it, so it must stay accurate. | rewrite: generate via `scripts/generate-skill-index.py` output (script, not prose pass) |
 | `for-claude-code.md` | LLMs operating in the repo | Machine-dense inventory: paths, schemas, conventions | Fit for purpose; value framing would be wasted on a machine audience. Minor: repo map lists `~/private-skills/` inside the repo tree, which misstates its location. | keep (fix the one map line in a follow-up) |
 | `for-linkedin.md` | Humans who enjoy the joke | Parody of AI-influencer launch posts | The AI patterns are the content. De-AI editing or value rewriting would destroy the parody. Counts (44/124/83) currently match validator truth. | keep |
 | `CITATIONS.md` | Maintainers | Provenance of patterns and prior art | None. Low traffic but cheap to keep and useful for "why is it built this way". | keep |

docs/for-knowledge-workers.md

@@ -8,7 +8,7 @@ read_when:
 
 ## What This Gives You
 
-You describe work in plain English. The system routes it to the right pipeline, with quality checks built in. 131 skills behind a single command, and you never need to know which one fired.
+You describe work in plain English. The system routes it to the right pipeline, with quality checks built in. 120 skills behind a single command, and you never need to know which one fired.
 
 ## Interface
 

docs/for-linkedin.md

@@ -75,7 +75,7 @@ A year of daily use on real work. Finding gaps, filling them, watching the syste
 The result:
 
 - 44 domain specialist agents across languages, infrastructure, review, research, content
-- 131 workflow skills covering everything from TDD to article writing to Reddit moderation
+- 120 workflow skills covering everything from TDD to article writing to Reddit moderation
 - 83 lifecycle hooks that fire at session boundaries to inject context, capture learnings, enforce gates
 - A learning database that tracks patterns and graduates them into agent behavior
 - Parallel review pipelines that catch issues before they reach production

docs/injected-context-contracts.md

@@ -104,11 +104,11 @@ Source: `hooks/sapcc-go-detector.py`.
 Meaning: A SAP Commerce Cloud Go project was detected in the current directory.
 Action: Apply SAP CC Go conventions for the session. The `go-patterns` and `sapcc-review` skills are in scope.
 
-### `[fish-shell] Detected Fish shell user` plus `[auto-skill] fish-shell-config`
+### `[fish-shell] Detected Fish shell user` plus `[auto-skill] shell-config`
 
 Source: `hooks/fish-shell-detector.py`.
 Meaning: The user runs Fish as their interactive shell.
-Action: When the user asks for shell config edits, prefer Fish syntax (`set -gx`, `function`, `~/.config/fish/config.fish`) over Bash/Zsh idioms. The `fish-shell-config` skill carries the full reference.
+Action: When the user asks for shell config edits, prefer Fish syntax (`set -gx`, `function`, `~/.config/fish/config.fish`) over Bash/Zsh idioms. The `shell-config` skill carries the full reference.
 
 ### `[adr-health-check] Active ADR session` plus `domain` and `adr` path
 

hooks/README.md

@@ -32,7 +32,7 @@ Task completes: TaskCompleted
 |------|-------------|
 | `afk-mode` | Injects autonomous behavioral posture for unattended sessions (SSH, tmux, or `CLAUDE_AFK_MODE=always`). See [AFK Mode docs](afk-mode/README.md) |
 | `cross-repo-agents` | Discovers local `.claude/agents/` in the working directory and injects them for `/do` routing |
-| `fish-shell-detector` | Detects Fish shell users and injects the `fish-shell-config` skill |
+| `fish-shell-detector` | Detects Fish shell users and injects the `shell-config` skill |
 | `hook-version-parity-check` | Warn-only: compares deployed `~/.claude/hooks/*.py` hook-version headers against the repo checkout; on drift names the hooks and the sync command |
 | `session-github-briefing` | Injects GitHub monitoring briefing into session context (opt-in: `CLAUDE_KAIROS_ENABLED=true`) |
 | `operator-context-detector` | Detects operator context (personal/work/ci/production) and injects behavioral profile |

scripts/fix-skill-paths.py

@@ -53,18 +53,11 @@
     # live in ~/private-skills, not in this repo.
     "enterprise-search": "engineering",
     "go-patterns": "engineering",
-    "kotlin-coroutines": "engineering",
-    "kotlin-testing": "engineering",
     "kotlin": "engineering",
-    "php-quality": "engineering",
-    "php-testing": "engineering",
     "php": "engineering",
-    "swift-concurrency": "engineering",
-    "swift-testing": "engineering",
     "swift": "engineering",
     "sapcc-audit": "engineering",
     "sapcc-review": "engineering",
-    "cobalt-core": "engineering",
     "distinctive-frontend-design": "frontend",
     "frontend-slides": "frontend",
     "threejs-builder": "frontend",
@@ -74,11 +67,7 @@
     "game-sprite-pipeline": "game",
     "phaser-gamedev": "game",
     "motion-pipeline": "game",
-    "kubernetes-debugging": "infrastructure",
-    "kubernetes-security": "infrastructure",
     "kubernetes": "infrastructure",
-    "fish-shell-config": "infrastructure",
-    "zsh-shell-config": "infrastructure",
     "shell-config": "infrastructure",
     "shell-process-patterns": "infrastructure",
     "headless-cron-creator": "infrastructure",

scripts/migrate-skills-to-folders.py

@@ -55,18 +55,11 @@
     # engineering/ — language-specific patterns + domain engineering
     "enterprise-search": "engineering",
     "go-patterns": "engineering",
-    "kotlin-coroutines": "engineering",
-    "kotlin-testing": "engineering",
     "kotlin": "engineering",
-    "php-quality": "engineering",
-    "php-testing": "engineering",
     "php": "engineering",
-    "swift-concurrency": "engineering",
-    "swift-testing": "engineering",
     "swift": "engineering",
     "sapcc-audit": "engineering",
     "sapcc-review": "engineering",
-    "cobalt-core": "engineering",
     "cli-design": "engineering",
     "opensearch-detection-engineer": "engineering",
     # frontend/
@@ -82,11 +75,7 @@
     "phaser-gamedev": "game",
     "motion-pipeline": "game",
     # infrastructure/ — ops, k8s, shell, cron
-    "kubernetes-debugging": "infrastructure",
-    "kubernetes-security": "infrastructure",
     "kubernetes": "infrastructure",
-    "fish-shell-config": "infrastructure",
-    "zsh-shell-config": "infrastructure",
     "shell-config": "infrastructure",
     "shell-process-patterns": "infrastructure",
     "headless-cron-creator": "infrastructure",