| name | audit-activation |
| compatibility | Claude Code 2.1.220+ |
| description | Audits OrchestKit sub-agent activation from real spawn telemetry — computes the generic-vs-specialist spawn split, flags dormant agents (never fired), and classifies each as fires/mis-triggered/niche. The agent-side analogue of audit-skills. Use when specialized agents feel under-used, before pruning the catalog, or after wiring new agent spawn paths. |
| tags | ["audit","agents","activation","telemetry","orchestkit"] |
| version | 1.0.0 |
| author | OrchestKit |
| user-invocable | true |
| disable-model-invocation | false |
| argument-hint | [--json] |
| context | fork |
| background | false |
| complexity | medium |
| persuasion-type | discipline |
| allowed-tools | ["Read","Glob","Grep","Bash","TaskCreate","TaskUpdate","TaskList"] |
audit-activation
Reports whether OrchestKit's specialized sub-agents are actually being activated, from real spawn telemetry — not vibes. Scope is agent activation, not skill quality.
It answers: "Do my specialized agents get spawned, or does the model default to generic Explore/general-purpose?" Read-only — it never edits agents.
Why this exists: a 2026-06 audit found only ~14% of agent spawns hit the 36-agent catalog vs ~74% generic, with 17/36 agents dormant — and that agents fire ~1:1 with how often a high-traffic skill names them via subagent_type=. Description rewrites ("use proactively") were A/B-tested and gave Δ0, so this skill measures wiring + usage, not description prose. See docs/feat--activation-audit/.
Quick Reference
| Category | File | Impact | When to Use |
|---|
| Activation Checks | ${CLAUDE_PLUGIN_ROOT}/skills/audit-activation/rules/activation-checks.md | HIGH | What to compute per agent |
| Classification | ${CLAUDE_PLUGIN_ROOT}/skills/audit-activation/rules/activation-status.md | HIGH | fires / mis-triggered / niche / dead buckets |
| Output Format | ${CLAUDE_PLUGIN_ROOT}/skills/audit-activation/references/output-format.md | MEDIUM | Report layout + the spawn-split summary |
CRITICAL: Task Management is MANDATORY (CC 2.1.16)
TaskCreate(subject="Audit activation: agent spawn analysis",
description="Computing generic-vs-specialist split + dormancy from spawn telemetry",
activeForm="Auditing agent activation")
TaskCreate(subject="Read spawn telemetry", activeForm="Reading subagent-spawns.jsonl")
TaskCreate(subject="Compute split + dormancy", activeForm="Computing split and dormant agents")
TaskCreate(subject="Classify & render", activeForm="Classifying agents and rendering report")
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId=, addBlockedBy=[])
