
agent-fungibility
The philosophy and practical benefits of agent fungibility in multi-agent software development. Why homogeneous, interchangeable agents outperform specialized role-based systems at scale.
- Installs
- 52
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill agent-fungibility- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads agent-fungibility automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Agent Fungibility — The Key to Scalable Agent Swarms
Core Principle: "Fungibility bestows a LOT of really good properties automatically in a computer system."
YOU are the bottleneck. Be the clockwork deity to your agent swarms: design a beautiful and intricate machine, set it running, and then move on to the next project.
The Debate: Specialized vs. Fungible Agents
A burgeoning debate has sprung up around the optimal way to scale up the number of agents working on a software project:
| Approach | Description |
|---|---|
| Specialized Roles | Assign distinct roles (tester agent, backend agent, committer agent, etc.) |
| Fungible Agents | All agents are identical and can do any task |
The answer for software development: Fungible agents win.
Why Fungibility Works
The Problem with Specialized Agents
Rather than setting up a complex heterogeneous system where you have assigned roles to specific tasks for agents, which is brittle and creates problems when one of the agents crashes or loses its memory or otherwise suffers from context rot and needs to be euthanized, you have to deal with:
- Understanding what kind of agent just died
- What was it doing when it died
- How to replace it functionally with the relevant context
- What happens to the other agents that were depending on that specialized agent?
The Fungibility Solution
You're better off just having a bunch of fungible agents that are all simply executing beads of any kind.
They can be any kind of agent:
- Claude Code
- Codex
- Antigravity CLI (
agy, pinned to "Gemini 3.1 Pro (High)"; successor to the retiring Gemini CLI) - Amp
- Cursor
- etc.
But they're fungible in that they can all wear any hat and adaptively assume any role depending on the bead task they're working on.
The Two Big Unlocks
1. Use BV to Choose Optimal Next Bead
Each agent uses bv --robot-triage or bv --robot-next to find the highest-impact ready bead. No central assignment needed.
2. Put Everything in the Plan → Beads
If you put everything you want to have happening in your original markdown plan that you turn into beads, you get everything else "for free" and it's robust to bad things happening to any agents.
Robustness Properties
Agents fail. They:
- Crash
- You accidentally close the tab
- Context rot (lose track of what they're doing)
- Get stuck in loops
- Need to be "euthanized" and restarted
With fungible agents, you never have to worry about that stuff.
When an agent dies:
- The bead it was working on remains marked in-progress
- Any other agent can pick it up
- No special replacement logic needed
- No dependency on that specific agent
Scaling Properties
When you want to move faster:
- Simply spin up more agents at any time
- Don't need to think about whether there's an imbalance between the counts of each agent role
- 3 agents → 10 agents → 20 agents: just add more, they all do the same thing
Agent fungibility lets you go much faster and scales better, especially as:
- Projects get larger and more complex
- Agent counts increase past 10 working on the same project at the same time
The Analogy: Fountain Codes
This is why I'm a huge fan of things like fountain codes (like RaptorQ) for file storage:
Turn a file into an endless stream of fungible blobs with very little overhead and the user can catch any blob in any order and each new blob helps them reconstruct the file; there's no "rarest chunk" like with BitTorrent.
In software development:
- Each bead is a "blob"
- Any agent can work on any bead
- There's no "critical specialist" that becomes a bottleneck
- The system is resilient to partial failures
When Specialized Roles DO Make Sense
There are contexts where designated roles for agents work better. Example: Automated scientific inquiry (like BrennerBot).
Why it works there:
- The discourse itself (the back and forth between different agent types) is the core mechanism of surfacing truth
- The debate structure IS the point
Why it doesn't work for software:
- In software development, we just want good code that works
- The goal is output, not discourse
- Fungibility removes bottlenecks and single points of failure
The Clockwork Deity Philosophy
Most of my agent tooling and workflows are about removing me from the equation, because there's only one of me, but a potentially unlimited number of agents.
The way to do this:
- Front-load all input in planning phases — Use GPT Pro with Extended Reasoning, multiple iterations, blend feedback from all frontier models
- Offload task structuring — Convert plans to beads with full dependency graphs
- Allow direct communication — Agent Mail lets agents coordinate without you
- Set it running and move on — By the time you come back, huge chunks of work are done
Why This Works
It all ultimately works because:
- The best models (GPT Pro) are used to their fullest
- Many iterations with blending feedback from all frontier models
- The very best model as the final arbiter
- In "plan space" it all fits easily in context windows
- Models can see the entire system at once instead of through a pinhole
Practical Implementation
Starting a Fungible Swarm
# Spawn agents (any mix of types)
ntm spawn myproject --cc=3 --cod=2 --agy=1
# Give them all the SAME initial prompt
ntm send myproject --all "$(cat initial_prompt.txt)"
The Initial Prompt (Same for All)
First read ALL of the AGENTS dot md file and README dot md file super carefully and understand ALL of both! Then use your code investigation agent mode to fully understand the code, and technical architecture and purpose of the project. Then register with MCP Agent Mail and introduce yourself to the other agents.
Be sure to check your agent mail and to promptly respond if needed to any messages; then proceed meticulously with your next assigned beads, working on the tasks systematically and meticulously and tracking your progress via beads and agent mail messages.
Don't get stuck in "communication purgatory" where nothing is getting done; be proactive about starting tasks that need to be done, but inform your fellow agents via messages when you do so and mark beads appropriately.
When you're not sure what to do next, use the bv tool mentioned in AGENTS dot md to prioritize the best beads to work on next; pick the next one that you can usefully work on and get started. Make sure to acknowledge all communication requests from other agents and that you are aware of all active agents and their names. Use ultrathink.
When an Agent Fails
- Don't panic
- Start a new session in its place
- Give it the same initial prompt
- It will:
- Read AGENTS.md
- Check bead status via bv
- See what's in-progress/stuck
- Either resume or pick a new bead
No special logic. No role assignment. Just fungibility.
Summary
| Property | Specialized Agents | Fungible Agents |
|---|---|---|
| Failure handling | Complex | Simple |
| Scaling | Requires role balancing | Just add more |
| Replacement | Need matching specialist | Any agent works |
| Single point of failure | Yes (each role) | No |
| Coordination overhead | High | Low (via beads + mail) |
| Human involvement | Ongoing | Front-loaded in planning |
The bottom line: Agent fungibility lets you build the machine once, set it running, and move on. The swarm handles the rest.
FAQ
What does the agent-fungibility skill do?
The philosophy and practical benefits of agent fungibility in multi-agent software development. Why homogeneous, interchangeable agents outperform specialized role-based systems at scale.
How do I install agent-fungibility?
Run npx skills add https://github.com/dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill agent-fungibility in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/agent-fungibility/ (personal) or .claude/skills/agent-fungibility/ (project).
Which AI agents can use agent-fungibility?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is agent-fungibility safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains agent-fungibility?
It is published by dicklesworthstone in dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations. It has 52 recorded installs.
More from dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
ssh
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
SSH remote access - connections, tunnels, keys, file transfers. Use when connecting to servers, managing SSH keys, setting up port forwarding, or transferring files with scp/rsync.
ui-ux-polish
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
Iterative UI/UX polishing workflow for web applications. The exact prompt and methodology for achieving Stripe-level visual polish through multiple passes.
gcloud
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
Google Cloud Platform CLI - manage GCP resources. Use when working with Compute Engine, Cloud Run, GKE, Cloud Functions, Storage, BigQuery, or other GCP services.
agent-swarm-workflow
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
Jeffrey Emanuel's multi-agent implementation workflow using NTM, Agent Mail, Beads, and BV. The execution phase that follows planning and bead creation. Includes exact prompts used.
planning-workflow
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
Comprehensive markdown planning methodology for software projects. Use when starting a new project, creating implementation plans, or refining architecture before coding.
cass
dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations
Mine past agent sessions for working prompts, decisions, and patterns. Use when "what did I ask?", "find that prompt", session archaeology, or agent history.
Popular ai & agents skills
google-agents-cli-publish
google/agents-cli
This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).
google-agents-cli-eval
google/agents-cli
This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).
skill-creator
anthropics/skills
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
codex-pet
prime-skills/runcomfy-agent-skills
Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.
full-output-enforcement
leonxlnx/taste-skill
Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.
executing-plans
obra/superpowers
Use 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