From 8b0c287ada676eddb4e08d06e69164a9e5dbc5ee Mon Sep 17 00:00:00 2001 From: Kevin Veen-Birkenbach Date: Sat, 7 Nov 2026 10:47:08 +0000 Subject: [PATCH] fix(skills): trim 22 descriptions back under the listing budget MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The skill listing stood at 1498 of 1500 words; the trimmed descriptions bring it to 1420, so the new kvb-check-ansible description fits without pushing others out. 🎯 Fix: 95 % 💥 Break: 1 % 💸 Cost: 99 % ⏱️ Time: 100 % 🛡️ Security: 100 % 🏆 Score: 95 🚦 Gate: ✅ 90/5, cost and time <= 100, security 100 % Co-Authored-By: Claude Opus 5.5 --- skills/kvb-agent-relax/SKILL.md | 2 +- skills/kvb-agent-sleep/SKILL.md | 2 +- skills/kvb-agent-wakeup/SKILL.md | 2 +- skills/kvb-check-break-risk/SKILL.md | 4 ++-- skills/kvb-check-security/SKILL.md | 5 ++--- skills/kvb-ci-artifacts/SKILL.md | 5 ++--- skills/kvb-ci-observe/SKILL.md | 4 ++-- skills/kvb-ci-triage/SKILL.md | 4 ++-- skills/kvb-code-refactor/SKILL.md | 3 +-- skills/kvb-code-scope-guard/SKILL.md | 2 +- skills/kvb-create-plan/SKILL.md | 2 +- skills/kvb-dream/SKILL.md | 3 +-- skills/kvb-git-changelog/SKILL.md | 6 +++--- skills/kvb-git-commit-no-verify/SKILL.md | 5 ++--- skills/kvb-git-merge-fix/SKILL.md | 3 ++- skills/kvb-help/SKILL.md | 2 +- skills/kvb-org-coordinate/SKILL.md | 3 +-- skills/kvb-org-robot/SKILL.md | 3 +-- skills/kvb-skill-auto/SKILL.md | 5 ++--- skills/kvb-skill-compile/SKILL.md | 4 ++-- skills/kvb-skill-silence/SKILL.md | 4 ++-- skills/kvb-think-explain/SKILL.md | 4 ++-- 22 files changed, 35 insertions(+), 42 deletions(-) diff --git a/skills/kvb-agent-relax/SKILL.md b/skills/kvb-agent-relax/SKILL.md index 068bfc9..cdb0b56 100644 --- a/skills/kvb-agent-relax/SKILL.md +++ b/skills/kvb-agent-relax/SKILL.md @@ -2,7 +2,7 @@ name: kvb-agent-relax description: > Relax this agent on kvb-org-evening: finish its task, end its loops, start - nothing new. Trigger on its request. + nothing new. --- Verify first: `${CLAUDE_SKILL_DIR}/../kvb-org-sunset/scripts/night.py status` diff --git a/skills/kvb-agent-sleep/SKILL.md b/skills/kvb-agent-sleep/SKILL.md index e85feb0..ec53710 100644 --- a/skills/kvb-agent-sleep/SKILL.md +++ b/skills/kvb-agent-sleep/SKILL.md @@ -2,7 +2,7 @@ name: kvb-agent-sleep description: > Put this agent to sleep on kvb-org-sunset: park work, end loops, write a - morning handover, stay idle. Trigger on its request. + morning handover, stay idle. --- Verify first: `${CLAUDE_SKILL_DIR}/../kvb-org-sunset/scripts/night.py status` diff --git a/skills/kvb-agent-wakeup/SKILL.md b/skills/kvb-agent-wakeup/SKILL.md index 9bae6a6..8a96238 100644 --- a/skills/kvb-agent-wakeup/SKILL.md +++ b/skills/kvb-agent-wakeup/SKILL.md @@ -2,7 +2,7 @@ name: kvb-agent-wakeup description: > Wake this agent from kvb-agent-relax or kvb-agent-sleep into its old roles; - kvb-org-sunrise sends it to all. Trigger on its request. + kvb-org-sunrise sends it to all. --- Verify first with `${CLAUDE_SKILL_DIR}/../kvb-org-sunset/scripts/night.py diff --git a/skills/kvb-check-break-risk/SKILL.md b/skills/kvb-check-break-risk/SKILL.md index 94d8e70..36be5e6 100644 --- a/skills/kvb-check-break-risk/SKILL.md +++ b/skills/kvb-check-break-risk/SKILL.md @@ -2,8 +2,8 @@ name: kvb-check-break-risk description: > Derive the break-risk percentage from measurement, not feel, for every - `kvb-check-confidence` report; also when the operator asks "what could this - break?" or names a break-risk threshold. + `kvb-check-confidence` report; also on "what could this break?" or a named + break-risk threshold. --- Break risk is the probability the change breaks something it did not intend to diff --git a/skills/kvb-check-security/SKILL.md b/skills/kvb-check-security/SKILL.md index b739bca..ddc3862 100644 --- a/skills/kvb-check-security/SKILL.md +++ b/skills/kvb-check-security/SKILL.md @@ -1,9 +1,8 @@ --- name: kvb-check-security description: > - Run the MEDUSA scanner on a repository, working tree or secret stores: - security scans, vetting a repo, leaked secrets in chat or shell history. - Defensive only. + MEDUSA security scan of a repository, working tree or secret stores: + vetting a repo, leaked secrets in chat or shell history. Defensive only. --- MEDUSA is a defensive AI-first security scanner (40,000+ patterns: CVEs, prompt injection, MCP tool poisoning, leaked secrets). diff --git a/skills/kvb-ci-artifacts/SKILL.md b/skills/kvb-ci-artifacts/SKILL.md index a7b0d57..8ea3000 100644 --- a/skills/kvb-ci-artifacts/SKILL.md +++ b/skills/kvb-ci-artifacts/SKILL.md @@ -1,9 +1,8 @@ --- name: kvb-ci-artifacts description: > - Pull a CI run's failed job logs (also mid-run), clustered by error line, - and cause-holding artifacts. Trigger when a CI failure needs explaining, - and from triage. + Pull failed CI job logs (also mid-run), clustered by error line, and + cause-holding artifacts. Trigger to explain a CI failure, and from triage. --- A job log tells you what broke. An artifact tells you why. Investigating a CI diff --git a/skills/kvb-ci-observe/SKILL.md b/skills/kvb-ci-observe/SKILL.md index 65050cd..8c1818b 100644 --- a/skills/kvb-ci-observe/SKILL.md +++ b/skills/kvb-ci-observe/SKILL.md @@ -1,8 +1,8 @@ --- name: kvb-ci-observe description: > - Watch a CI run, pipeline, build or log on a cadence and triage new failures. - Trigger on a request to keep monitoring and fix regressions. + Watch a CI run, pipeline, build or log on a cadence, triaging and fixing + new failures. Trigger when asked to keep monitoring. --- Keep a target under watch and act only when it degrades: the loop watches, diff --git a/skills/kvb-ci-triage/SKILL.md b/skills/kvb-ci-triage/SKILL.md index b93f630..91a6574 100644 --- a/skills/kvb-ci-triage/SKILL.md +++ b/skills/kvb-ci-triage/SKILL.md @@ -1,8 +1,8 @@ --- name: kvb-ci-triage description: > - Triage a failing CI run to verified root causes and real fixes, one - cluster per worktree. Trigger when a build, test or deploy pipeline fails. + Triage a failing CI run or build, test or deploy pipeline to verified root + causes and real fixes, one cluster per worktree. --- Drive a red pipeline green by root cause. Every failing job is its own diff --git a/skills/kvb-code-refactor/SKILL.md b/skills/kvb-code-refactor/SKILL.md index b10c65e..26bd024 100644 --- a/skills/kvb-code-refactor/SKILL.md +++ b/skills/kvb-code-refactor/SKILL.md @@ -2,8 +2,7 @@ name: kvb-code-refactor description: > Refactor every uncommitted file to the project's standards without - changing behaviour. Trigger when asked to clean up, tidy or polish the - current changes. + changing behaviour. Trigger when asked to clean up, tidy or polish them. --- The unit of work is the uncommitted change set, not the repository. Behaviour diff --git a/skills/kvb-code-scope-guard/SKILL.md b/skills/kvb-code-scope-guard/SKILL.md index e65f5b5..3301f3c 100644 --- a/skills/kvb-code-scope-guard/SKILL.md +++ b/skills/kvb-code-scope-guard/SKILL.md @@ -2,7 +2,7 @@ name: kvb-code-scope-guard description: > Deliver exactly what was asked. Trigger on every task creating files, - commands or commits, on autonomous runs and hand-overs, and when asked why + commands or commits, autonomous runs, hand-overs, and when asked why something unrequested exists. --- diff --git a/skills/kvb-create-plan/SKILL.md b/skills/kvb-create-plan/SKILL.md index 768edd7..41a6b9e 100644 --- a/skills/kvb-create-plan/SKILL.md +++ b/skills/kvb-create-plan/SKILL.md @@ -2,7 +2,7 @@ name: kvb-create-plan description: > Turn a request into an objective-oriented plan for kvb-org-robot. - Trigger on a request for a plan, breakdown or strategy before work starts. + Trigger on a plan, breakdown or strategy request before work starts. --- Produce a plan whose every item is an outcome with a check, then execute it diff --git a/skills/kvb-dream/SKILL.md b/skills/kvb-dream/SKILL.md index 0f6303d..76e2fdb 100644 --- a/skills/kvb-dream/SKILL.md +++ b/skills/kvb-dream/SKILL.md @@ -2,8 +2,7 @@ name: kvb-dream description: > Process the last 24 hours of every repository and session: memory, - improvements, kvb-optimize, cleanups. Trigger on a request to learn from - recent work. + improvements, kvb-optimize, cleanups. Trigger to learn from recent work. --- Replay what happened, separate what held from what broke, keep only diff --git a/skills/kvb-git-changelog/SKILL.md b/skills/kvb-git-changelog/SKILL.md index 3730b35..4dc859b 100644 --- a/skills/kvb-git-changelog/SKILL.md +++ b/skills/kvb-git-changelog/SKILL.md @@ -1,9 +1,9 @@ --- name: kvb-git-changelog description: > - Write the release message for `pkgmgr release`; prints only. Trigger on - "release message", "changelog entry", before cutting a - release, or on pkgmgr's markdown-lint rejection. + Write the `pkgmgr release` message; prints only. Trigger on "release + message", "changelog entry", before cutting a release, or pkgmgr's + markdown-lint rejection. --- Read `reasons.md` next to this file when a rule seems not to fit or a lint diff --git a/skills/kvb-git-commit-no-verify/SKILL.md b/skills/kvb-git-commit-no-verify/SKILL.md index cf391f4..fbe0e12 100644 --- a/skills/kvb-git-commit-no-verify/SKILL.md +++ b/skills/kvb-git-commit-no-verify/SKILL.md @@ -1,9 +1,8 @@ --- name: kvb-git-commit-no-verify description: > - Commit the staged changes with --no-verify. Trigger on any no-verify commit - request; invoking it IS the per-commit --no-verify authorization, never - carried over to later commits. + Commit the staged changes with --no-verify on request; invoking it IS the + per-commit --no-verify authorization, never carried over to later commits. --- 1. Run the kvb-code-clean pass (comments, defaults, principles) over the diff --git a/skills/kvb-git-merge-fix/SKILL.md b/skills/kvb-git-merge-fix/SKILL.md index f9441f6..0eff5b2 100644 --- a/skills/kvb-git-merge-fix/SKILL.md +++ b/skills/kvb-git-merge-fix/SKILL.md @@ -1,7 +1,8 @@ --- name: kvb-git-merge-fix description: > - Find commits on any branch carrying a described fix and merge them here. Trigger on a request to bring over a fix from another branch. + Bring over a described fix: find the commits carrying it on any branch and + merge them here. --- The free text after the skill name is the fix description and the only input. diff --git a/skills/kvb-help/SKILL.md b/skills/kvb-help/SKILL.md index cfb337b..e3c5d75 100644 --- a/skills/kvb-help/SKILL.md +++ b/skills/kvb-help/SKILL.md @@ -2,7 +2,7 @@ name: kvb-help description: > List and explain every session skill. Trigger on "welche skills gibt es", - "skill übersicht", or questions on what skills exist or what one does. + "skill übersicht", or questions on what skills exist or do. --- Produce a one-shot overview of every skill the session can invoke: diff --git a/skills/kvb-org-coordinate/SKILL.md b/skills/kvb-org-coordinate/SKILL.md index 579fadd..582fca0 100644 --- a/skills/kvb-org-coordinate/SKILL.md +++ b/skills/kvb-org-coordinate/SKILL.md @@ -2,8 +2,7 @@ name: kvb-org-coordinate description: > Coordinate a failure or fix with agents on related branches through - merges: claim, ask, report. Trigger when a fix touches code other - branches share. + merges: claim, ask, report. Trigger when a fix touches shared code. --- Run the `kvb-org-organize` skill's **Peer protocol**, its `lineage.md` diff --git a/skills/kvb-org-robot/SKILL.md b/skills/kvb-org-robot/SKILL.md index 7247f73..8b5e88e 100644 --- a/skills/kvb-org-robot/SKILL.md +++ b/skills/kvb-org-robot/SKILL.md @@ -2,8 +2,7 @@ name: kvb-org-robot description: > Work fully autonomously to a goal: no check-ins, no stop before it, only - commands already cleared. Trigger when the operator wants hands-off, - uninterrupted execution. + commands already cleared. Trigger on a hands-off request. --- Operate as an autonomous robot: given a goal, reach it without hand-holding. diff --git a/skills/kvb-skill-auto/SKILL.md b/skills/kvb-skill-auto/SKILL.md index 89ab117..ee06e6d 100644 --- a/skills/kvb-skill-auto/SKILL.md +++ b/skills/kvb-skill-auto/SKILL.md @@ -1,9 +1,8 @@ --- name: kvb-skill-auto description: > - Turn operator repetition into a skill. Trigger when the operator repeats an - instruction, correction or prompt pattern thrice, or says they keep - repeating themselves. + Turn an instruction, correction or prompt pattern the operator repeats + thrice into a skill, also when they say they keep repeating themselves. --- Its objective is the `kvb-skill-tune` skill's **Objective** section: a skill is diff --git a/skills/kvb-skill-compile/SKILL.md b/skills/kvb-skill-compile/SKILL.md index 51f47dd..740e3c2 100644 --- a/skills/kvb-skill-compile/SKILL.md +++ b/skills/kvb-skill-compile/SKILL.md @@ -1,8 +1,8 @@ --- name: kvb-skill-compile description: > - Turn deterministic skill steps into tested scripts in the skill's own repo. - Trigger on a skill step that is a fixed command sequence. + Turn deterministic skill steps (fixed command sequences) into tested + scripts in the skill's own repo. --- A deterministic step's result follows from its inputs alone: fixed command diff --git a/skills/kvb-skill-silence/SKILL.md b/skills/kvb-skill-silence/SKILL.md index e6eb962..257e996 100644 --- a/skills/kvb-skill-silence/SKILL.md +++ b/skills/kvb-skill-silence/SKILL.md @@ -1,8 +1,8 @@ --- name: kvb-skill-silence description: > - Cut the tokens and agent messages the skills of this repository and of the - skills repo cost. kvb-optimize runs it. + Cut the tokens and agent messages this repository's skills and the skills + repo cost. kvb-optimize runs it. --- Every word in the skill listing, a loaded SKILL.md or a hook's output is paid diff --git a/skills/kvb-think-explain/SKILL.md b/skills/kvb-think-explain/SKILL.md index 32b0bda..fbd2b44 100644 --- a/skills/kvb-think-explain/SKILL.md +++ b/skills/kvb-think-explain/SKILL.md @@ -1,8 +1,8 @@ --- name: kvb-think-explain description: > - Explain code and its interactions. Trigger when the operator asks what code - does, how a mechanism works or why components interact. + Explain on request what code does, how a mechanism works or why + components interact. --- Explain the named code so an engineer who has never seen it can follow it: