skill-agent-topology

Featured

Audit whether a multi-agent setup earns its coordination cost — use before adding an agent, or when a workflow feels slow or agents agree without adding signal

AI & Automation 4,061 stars 380 forks Updated today MIT

Install

View on GitHub

Quality Score: 96/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Agent Topology Audit Most advice about multi-agent systems is about how to add agents. This is about whether to. It audits a setup you already have, counts what each boundary between agents costs, and compares that against what the boundary buys. Removing an agent is a valid, and often the correct, result. The framing comes from Liu, Canhui (2026), *The Organizational Behavior of Agentic AI* ([arXiv:2606.30986](https://arxiv.org/abs/2606.30986)), which models coordination overhead as **contextual transaction cost** — the cost of making task context usable across an agent boundary. ## When To Use - Before adding another agent, seat, or phase to a workflow that already works. - When a workflow is slow and it is not obvious which part is earning its time. - When agents keep agreeing. Agreement that costs three dispatches and produces what one would have produced is overhead wearing the costume of consensus. - When a handoff keeps losing something and the fix keeps being "add more context to the prompt". - After a workflow produced a bad result and you want to know whether the topology or the models were at fault. ## When Not To Use - To pick a workflow for a new task. That is `/octo:auto`, which already routes by intent, or `skill-decision-support` for a general option comparison. - To decide whether to delegate a task to agents at all. That is the allocation step in `skill-intent-contract`. - To choose between providers or models. See `skills/blocks/frontier-m...

Details

Author
nyldn
Repository
nyldn/claude-octopus
Created
7 months ago
Last Updated
today
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

ai-agent-multi-agent-coordination

Use when designing systems where multiple agents collaborate on one task — supervisor/worker, debate, plan-execute, peer handoff. Covers handoff message contracts, shared scratchpad, conflict resolution, deadlock detection, and the cost/SLA discipline that keeps multi-agent setups from spiralling.

25 Updated 3 days ago
peterbamuhigire
AI & Automation Listed

agent-design

design and review llm agent systems, tool interfaces, and skill boundaries. use when chatgpt needs to decide whether a task should be handled by a prompt, workflow, skill, tool, single-agent loop, or multi-agent system; define tool schemas, instructions, guardrails, evaluation plans, or permission boundaries; or critique an existing agent design for over-orchestration, weak context handling, missing verification, or poor tool design.

73 Updated yesterday
wibus-wee
AI & Automation Listed

team-topology

Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the task's dominant risk, specify the runtime/communication/trust layers, place model capability by lane, present it as a diagram + table + trust-boundary note + open choices, and deploy ONLY after the user agrees to the proposed shape. Use when the user asks to "define/design/lay out the team", "what topology are we deploying", "how should the agents be arranged", "design the team for <task>", "what formation for <task>", or wants a team expressed as a topology (nodes, edges, models, trust boundaries) rather than spawned ad hoc. Substrate-agnostic - Cotal mesh, harness subagents, Workflow stages, containers, or any orchestration system.

274 Updated today
Cotal-AI