Audit Activation

What it does

When your agent uses it

• Specialized agents feel under-used
• Before pruning the catalog
• After wiring new agent spawn paths

Example prompts

• “Use the audit-activation skill to audit sub-agent activation from explicit consumer telemetry roots”
• “/audit-activation”

Requirements

• Python 3
• Node.js
• A Bash shell
• Compatibility (from SKILL.md): Claude Code 2.1.277+
• Pre-approved tools (allowed-tools): Read, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Run the script FIRST — every audit starts by running (or, when execution is impossible, explicitly referencing) the deterministic collector
2. 2Inventory — let the script resolve its own source or installed agents/ catalog. Do not point it at a consumer project's agent directory.
3. 3Read telemetry — .claude/logs/subagent-spawns.jsonl carries pretool intent and start events. Triangulate it with the restored global…
4. 4Compute — all checks from Read("rules/activation-checks.md"); the Report Contract below lists the mandatory ones.
5. 5Classify — bucket every agent using the Four Buckets below (full procedure: Read("rules/activation-status.md")).
6. 6Render — output per Read("references/output-format.md"), satisfying the Report Contract.

What it can do on your machine

Read from SKILL.md and the folder at commit 02bbf9a. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Read
  • Glob
  • Grep
  • Bash
  • TaskCreate
  • TaskUpdate
  • TaskList

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 2 files in scripts/ (JavaScript and Shell), which the agent can run.

  Shell commands in SKILL.md call:

  • bash

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Claude Code 2.1.277+

  From compatibility in the SKILL.md frontmatter.

Context cost

Audit Activation loads about 2.6k tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 91 tokens; SKILL.md has 897 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~91

When it runs · the whole SKILL.md, loaded when a task matches

~2.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Read, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from yonatangross/orchestkit at commit 02bbf9a, republished under its MIT licence (© yonatangross). 897 words, ~2,553 tokens.

name

audit-activation

description

Audits sub-agent activation from explicit consumer telemetry roots. It separates attempted, started, completed, and unattributed events, reports coverage, and identifies observed zero starts without making an estate-wide dormancy claim. Use when specialized agents feel under-used, before pruning the catalog, or after wiring new agent spawn paths.

allowed-tools

Read, Glob, Grep, Bash, TaskCreate, TaskUpdate, TaskList

compatibility

Claude Code 2.1.277+

user-invocable

true

disable-model-invocation

false

argument-hint

[--json]

context

fork

background

false

metadata.version

1.0.0

metadata.author

OrchestKit

metadata.complexity

medium

metadata.tags

audit, agents, activation, telemetry, orchestkit

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 + observed zero starts", activeForm="Computing activation events and coverage")
TaskCreate(subject="Classify & render", activeForm="Classifying agents and rendering report")
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

Data: scripts/run-activation-audit.sh over /consumer/.claude/logs/subagent-spawns.jsonl (window: 2026-05-23T00:00:00Z to 2026-07-14T00:00:00Z; coverage: observed)
Stop feed: ~/.claude/analytics/agent-usage.jsonl supplied separately; it is not joined to starts.

## Spawn split
Total 560 spawns: 412 generic (74%) / 78 ork-catalog (14%) / 70 other-plugin (12%)

## Concentration
Top-5 = 63/78 catalog spawns (81%): web-research-analyst 26, code-quality-reviewer 21,
test-generator 8, debug-investigator 5, backend-system-architect 3

## Observed zero-start agents (6 of 20 in the supplied roots, refs via grep -rc "subagent_type=ork:<name>" src/skills/)
- emulate-engineer      (3 refs)  -> MIS-TRIGGERED
- expect-agent          (3 refs)  -> MIS-TRIGGERED
- design-system-architect (2 refs) -> NICHE (rare domain, wired)
- multimodal-specialist (1 ref)   -> NICHE (rare domain, wired)
- infrastructure-architect (2 refs) -> NICHE (rare domain, wired)
- event-driven-architect (1 ref)  -> MIS-TRIGGERED

Caveat: observed zero starts are absent only from the supplied telemetry roots and
window. They are not proof of zero estate-wide or lifetime use.

## Buckets (rules/activation-status.md)
ACTIVE (14) | MIS-TRIGGERED (3) | NICHE (3) | DEAD (0 — none: every agent has >=1 reference)

## Fixes (wiring only — never description rewrites)
- emulate-engineer: add subagent_type=ork:emulate-engineer spawn from cover (src/skills/cover/SKILL.md)
- expect-agent: add subagent_type=ork:expect-agent spawn from review-pr

© yonatangross, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (scripts, references) in src/skills/audit-activation of yonatangross/orchestkit.

• SKILL.md
• references/output-format.md
• rules/_sections.md
• rules/activation-checks.md
• rules/activation-status.md
• scripts/collect-activation-audit.mjs
• scripts/run-activation-audit.sh
• test-cases.json

Open the folder on GitHubat commit 02bbf9a