agent-stocktakelisted

# agent-stocktake — Agent Definition Quality Audit Evaluate every agent definition under `~/.claude/agents/*.md` and assign each a verdict: `Keep / Improve / Update / Merge / Demote to skill / Dissolve / Retire`. The audit unit is the file, but the cost unit is **split across two layers** — that split is the reason this skill exists as a third sibling next to skill-stocktake and rules-stocktake. > Design note — the hybrid cost model. A skill's cost is trigger pollution (probabilistic > firing degrades selection); a rule's cost is residency (always loaded). An agent has > **both at once**: its `description` is injected into every session via the > "Available agent types" listing (**residency**, like a rule), while its body loads only > when the agent is invoked (**invocation**, like a skill — but triggered by Claude's > delegation judgment, not by description matching against the user's words). So the > description is audited on residency density and the body on invocation quality, with > different questions for each layer. > Design note 2 — edits are applied in-session. Same reasoning as rules-stocktake: no > improvement engine exists for agent definitions, and the corpus is ~20 small files — > delegation would be overengineering. The handoff exception is Demote to skill > (creating a skill is skill-creator's job). ## Modes (`$ARGUMENTS`) | Argument | Behavior | |----------|----------| | none / `full` | Read and evaluate every agent definition (default) | | `changed` | R