refactor(skills): cap every SKILL.md at 600 words and cut agent messages

Every loaded SKILL.md and every listed description is paid on every turn of every session, and every delivered message costs its recipient a full turn. scripts/budget.py gains SKILL_WORDS = 600, enforced by test_lock, and test_naming forbids a skill naming its own slash command; 53 descriptions and 10 body lines drop it. The 18 longest skills move details into 31 side files read only in their situation (organize's capacity, succession, peers, offices, relay and lineage; cleanup's docker, worktrees, execute and ask; code-tune, changelog, triage, dream, split and others), so all SKILL.md files shrink from 33866 to 26291 words without dropping a rule; an independent review of HEAD against the new text found no loss in 60 of 64 skills and three weakenings, now restored (WSJF re-estimates after an objective change, cleanup's volume checklist, essence's absolute dates).

The kvb-org-organize Peer protocol sends status that asks nothing to the news board, answers nothing that asks nothing, keeps messages terse, and lets light runs admit themselves in the operator's wording; the skills follow it (operator reads the register, relax and wakeup reply through the news, evening collects them there, wsjf asks only for missing estimates, cleanup and triage batch their questions). Skills that explore code ask the codebase-memory-mcp graph first, subagent briefs scale with the stakes and cap their answers, and the skills that need the full register or council tables call show --wide or list --long.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kevin Veen-BirkenbachandClaude Opus 5.5 committed 2026-11-04 17:07:23 +01:00
1 parent 34b434a744
commit 3c2f6c44b5
99 files changed
+2110 -2086

No files matched your search

+37 -35
View File
@@ -2,27 +2,30 @@
name: kvb-org-matrix
description: >
One matrix of everything in flight with confidence and break risk per
item. Trigger on /kvb-org-matrix, "status", "übersicht", "wo stehen wir".
item. Trigger on "status", "übersicht", "wo stehen wir".
---
One-shot overview, no side effects: this skill reads state and reports it. It
never edits files, stages, commits, deploys, or starts work — the operator
decides what to act on after reading the matrix.
One-shot overview, no side effects: it reads state and reports it, never
edits, stages, commits, deploys or starts work. The operator decides what to
act on.
## Collect the state
Gather in parallel, skip any source the session does not have, and never invent
a row for a source you could not read:
In parallel; skip a source the session lacks, and never invent a row for one
you could not read:
1. **Tasks** — the `kvb-org-rasci` register first, then the session's todo list, the operator's stated goals this
session, and any requirement or plan documents the work follows.
2. **Working tree** — `git status --short` and `git log --oneline -10`:
uncommitted files are open work, commits since the branch point are closed
work. Untracked files count as open.
3. **Running** — background bash jobs, spawned agents not yet reported,
scheduled `/loop` wake-ups, and remote runs (CI, deploys). Poll their live
state; a job you started is not "running" because you started it.
4. **Remote** — open PRs and issues for the branch, and their check
1. **Tasks**: the `kvb-org-rasci` register first, then the session's todo
list, the operator's goals this session, and the requirement or plan
documents the work follows.
2. **Peers**: `council.py list` and `news.py show --all` (the
`kvb-org-organize` skill's scripts); never message a peer for status.
3. **Working tree**: `git status --short` and `git log --oneline -10`:
uncommitted and untracked files are open work, commits since the branch
point closed work.
4. **Running**: background jobs, spawned agents not yet reported, scheduled
`/loop` wake-ups, remote runs (CI, deploys). Poll their live state; a job
is not "running" because you started it.
5. **Remote**: open PRs and issues for the branch and their check
conclusions, when a forge CLI is available.
## The matrix
@@ -31,30 +34,29 @@ One table, most-blocking first, one row per item:
| Item | State | Conf. | Break risk | Evidence / next step |
- **State**: `open`, `running`, `blocked`, `done`. `done` means verified —
a passing run, a green check, a reproduction that now succeeds. Work that
- **State**: `open`, `running`, `blocked`, `done`. `done` means verified (a
passing run, a green check, a reproduction that now succeeds); work that
merely looks finished is `open`.
- **Conf.** and **Break risk**: two separate percentages per the `kvb-check-confidence`
skill — probability the item does what it claims, and probability it breaks
something else. Only for rows that changed something; `—` for pure
observation rows.
- **Evidence / next step**: for `done`, the strongest proof line (what ran,
what it returned). For everything else, the single next action.
- **Conf.** and **Break risk**: two separate percentages per the
`kvb-check-confidence` skill, only for rows that changed something; `-`
for pure observation rows.
- **Evidence / next step**: for `done` the strongest proof line (what ran,
what it returned), otherwise the single next action.
Then at most three lines below the table:
Then at most three lines:
- **Blocked on**: what needs the operator (a decision, a credential, an
approval) — omit when nothing does.
- **Residuals**: what keeps the lowest confidence number below 100.
- **Running**: what will report back on its own, so the operator does not wait
on it manually.
approval); omit when nothing does.
- **Residuals**: what keeps the lowest confidence below 100.
- **Running**: what reports back on its own, so the operator need not wait
on it.
## Rules
- Cover everything in scope, including work the operator did not ask about —
a forgotten background job or an unpushed commit is exactly what the matrix
exists to surface.
- Report what the poll returned, never a predicted result for work still in
flight; a running item has no confidence number yet.
- Compress: one row per item, no per-item paragraphs. If a row needs
explaining, the operator will ask.
- Cover everything in scope, including work the operator did not ask about:
a forgotten background job or an unpushed commit is what the matrix exists
to surface.
- Report what the poll returned, never a predicted result; a running item
has no confidence number yet.
- One row per item, no per-item paragraphs; the operator asks when a row
needs explaining.