agent_spinner

agent_spinner is a skill for Claude Code from theafh/ai-modules. It costs 255 tokens per session (4,509 once invoked), scanned A, original, MIT.

An orchestration guide for coordinating helper agents on a larger task. It chooses how to divide the work, limits each helper to one path, and handles missing or failed results.

In plain words
What is it for?
Use it when splitting work across files, running review passes, deciding how many helpers to use, or merging their reports.
Why use it?
It helps avoid overlapping edits and makes parallel agent work easier to check and combine.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions subagents.

Part of the ai_dev plugin — 26 skills, 9 agents, 1 hook shipped together

Good fit Use it when splitting work across files, running review passes, deciding how many helpers to use, or merging their reports.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/theafh/ai-modules/agent_spinner
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add theafh/ai-modules --skill agent_spinner
Clone the repo
git clone --depth 1 https://github.com/theafh/ai-modules

Made for: Claude Code.

Or install ai_dev, the plugin that ships this one along with the rest of its 26 skills, 9 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for agent_spinner

README.md
[![agentmods](https://agentmods.dev/badge/skills/theafh/ai-modules/agent_spinner/github.svg)](https://agentmods.dev/skills/theafh/ai-modules/agent_spinner)
Your own site
<a href="https://agentmods.dev/skills/theafh/ai-modules/agent_spinner"><img src="https://agentmods.dev/badge/skills/theafh/ai-modules/agent_spinner/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for agent_spinner

Your own site · 80×15
<a href="https://agentmods.dev/skills/theafh/ai-modules/agent_spinner"><img src="https://agentmods.dev/badge/skills/theafh/ai-modules/agent_spinner.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 255 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,509 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00255 $0.04509
Opus 5.5 $0.00102 $0.01804
Sonnet 5.5 $0.00051 $0.00902
Haiku 4.5 $0.00026 $0.00451

Measured 25d ago against content hash 82eb816a49f3, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

agent_spinner scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 25d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/ai_dev/skills/agent_spinner/SKILL.md · 218 lines

How it starts

The opening of the file, as written. The whole thing — 218 lines — stays where its author put it; the contents beside it link to each section on GitHub.

agent_spinner

<agent_spinner_skill>

<when_to_activate> Activate when the orchestration decision belongs to the orchestrator:

  • "Fan this out across the files" / "run several agents on this" / "spawn parallel helpers for these items."
  • "Split the review into lenses" / "have a second agent check the first one's work" / "add a verifier pass."
  • "How many helpers should this take?" / "how do I keep two writers off the same file?"
  • "One of the helpers came back empty" / "a helper hung" / "merge what the helpers reported."

Route a request naming the task backlog to the task_* family and a request naming the wiki to wiki_fix. Route every concrete per-harness question, meaning which delegation surface a target exposes and how a role registers on it, to harness_portability, which owns those facts under its own re-verification rule. </when_to_activate>

<invocation_boundary> A run already governed by a named skill keeps that skill's orchestration contract. Where that skill states its own loop bounds, helper-failure policy, verification standard, aggregation rule, or stop-and-ask boundary, this skill adds nothing to that run and overrides nothing in it. Read agent_spinner for a request about running helpers in general, or for a job no shipped family owns. The shipped families stay worked instances of this shape at different sizes: cite them for illustration, and leave authority over their runs with them. </invocation_boundary>

<capability_probe> Establish callability, never infer it. A role definition on disk is evidence that the file deployed, not evidence that it can be called: definition-present-and-uncallable is a real state, so a registration check reporting a definition as available settles deployment alone. Establish callability through the host's own spawnable-role surface, and where the host advertises none, record the delegation surface as absent however many definitions are present.

Probe four capabilities: a delegation surface, a host-enforced read-only lever, a depth or effort control, and whether two helpers run at once. Resolve a capability that resists establishment to absent, and open the run by naming which capabilities you established and which you assumed away. </capability_probe>

  1. Inline floor: a sequence of separately prompted passes performed inline in one context, each opening on its own brief and closing on its own return contract.
  2. Spawned roles: each pass runs in its own context.
  3. Enforced read-only: the host, rather than the prompt alone, holds a reading pass to reads.
  4. Depth pin: the adversarial pass runs at a fixed depth.
  5. Concurrent fan-out: independent helpers run at once.

Write every guarantee to hold at the floor, so no step depends on a fresh context, an isolated tool set, or a process boundary. Coverage is therefore counted in independent looks rather than in simultaneity, and the run claims no wall-clock benefit from fan-out.

The inline floor is the floor for a run the orchestrator owns outright. Where a governing skill states its own stop-and-ask boundary for a host with no spawn surface, honour that boundary, offer that skill's manual routes, and perform no helper role inline, as <invocation_boundary> already establishes.

Read the full file on GitHub · 218 lines

Files

What ships with it

4 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 25d ago Changed · +19 lines · +255 tokens per session 82eb816a49f3
  2. 1mo ago First seen · 199 lines · 0 tokens per session scan A b97464f25977

Subscribe to this mod's changes

agent_spinner is a skill published in the GitHub repository theafh/ai-modules (38 stars, last pushed today), licensed MIT. It adds 255 tokens to every session and 4,509 once invoked, about $0.0010 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-18.

Related

Other skills, from other repositories

local-ai-agents

Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models. Covers Small Language Models (SLMs), the OpenAI-compatible local endpoint, sandboxed local tools, local RAG with Chroma, local MCP servers, hybrid cloud/local routing, and the…

microsoft/ai-agents-for-beginners · 200 tokens

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

next-cache-components-adoption

Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the cacheComponents flag, work through a flood of blocking-prerender / instant validation errors, run the cache-components-instant-false codemod, or…

vercel/next.js · 95 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

insight-error-page

Write or audit an insight-kind error page for the Next.js dev overlay. Use when creating a new errors/ .mdx page, auditing an existing one, or checking that a page matches the framework fix cards. Covers page structure, title alignment, FixCard cards with Copy prompt button, code snippets, terminology verification…

vercel/next.js · 83 tokens