ccoalm/ccl-skills / skills/skill-extraction-workflow
skill-extraction-workflow
Flagged复盘 / 沉淀 / 总结经验 / 补进技能 / 技能缺陷 / 流程优化 / would other teammates hit this / will we forget next time / teamwide recurrence / extract skill / post-mortem / 深度 review·审计技能仓库 / 对标外部技能包找 gap(benchmark superpowers·gstack 等) / 核查全局安装点(~/.config/opencode 等)旧快照是否遮蔽本仓技能 / 本仓(ccl-skills 等共享技能仓)OpenCode 项目配置·命令治理 → turn reusable lessons into durable CCL skills.
references/skill-listing-budget.md
View on GitHub# Claude Code skill-listing budget — mechanism, cold-start trap, levers
Companion to the **budget-dropped** Core Rule in `SKILL.md` (under *Triggers, routing surfaces & isolation*). The Core Rule carries the gate (before fixing a routing miss with a trigger-word edit, check whether the description was even in the host listing; the evidence bar; the two host corollaries). This file carries the **mechanism detail and the remediation levers**. It adds no new gate.
## Mechanism
Claude Code always loads every skill *name*, but when many skills are installed it collapses the *descriptions* of the **least-invoked** skills to bare name-only to fit a skill-listing budget (default ~1% of the context window via `skillListingBudgetFraction`). `/doctor` shows the overflow and which skills lost their description.
While an entry is name-only, **trigger-word edits are invisible to description-based routing** — the skill is still reachable by explicit `/skill-name` or by name semantics, just not by the new keywords.
## The cold-start trap
A rarely-used gate skill can spiral: never invoked → description dropped → never auto-routed → never invoked. The trigger-word edit that was supposed to fix routing has no effect because the description it edits is not in the listing.
## Levers (once confirmed name-only)
- **Raise `skillListingBudgetFraction`** — applies to ALL skills incl. plugins, but it is a global per-turn context/cost tradeoff, not a default fix.
- **Disable unused plugins** via `/plugin` — note `skillOverrides: name-only` does NOT apply to plugin skills (personal/project only).
- **Invoke the skill once** — a single invocation lifts it out of the least-invoked set.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |