multi-agent-patterns

Designs supervisor, swarm, and hierarchical multi-agent architectures with context isolation.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/TECH-HY/SKILLS --skill multi-agent-patterns-tech-hy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multi-agent-patterns
Source: https://github.com/TECH-HY/SKILLS/tree/main/skills/multi-agent-patterns
Command: npx skills add https://github.com/TECH-HY/SKILLS --skill multi-agent-patterns-tech-hy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Single agents hit context limits, sequential bottlenecks, and degraded reasoning on complex tasks. This Skill provides architectural patterns for distributing work across multiple language model instances with isolated context windows, explicit coordination protocols, and mitigations for failure modes like supervisor bottlenecks and error propagation. ## Core Features & Use Cases - Architecture Pattern Selection: Guidance on choosing between supervisor/orchestrator, peer-to-peer/swarm, and hierarchical patterns based on coordination needs rather than organizational metaphor. - Context Isolation Strategies: Covers full context delegation, instruction passing, and file system memory approaches with their trade-offs. - Consensus and Failure Handling: Weighted voting, debate protocols, trigger-based intervention, and mitigations for divergence, bottlenecks, and error propagation. - Use Case: When building a research system that must search multiple sources in parallel, use this Skill to design a supervisor that delegates to researcher, analyzer, fact-checker, and writer sub-agents, each operating in a clean context. ## Quick Start Ask the agent to design a multi-agent architecture for your task, specifying whether you need centralized control, flexible handoffs, or layered planning.

Frequently Asked Questions about multi-agent-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design a multi-agent system with a supervisor pattern?

Place a central supervisor agent in control that decomposes user objectives into subtasks and routes them to specialist workers. Implement a forward_message tool so sub-agents can pass responses directly to users, avoiding the telephone game problem where supervisor paraphrasing loses fidelity.

What is the difference between supervisor and swarm agent architectures?

Supervisor architectures centralize control in one orchestrating agent, giving strict workflow control but creating a bottleneck. Swarm architectures let agents hand off directly to each other via transfer functions, removing single points of failure but requiring explicit convergence constraints.

How much more expensive are multi-agent systems compared to single agents?

Multi-agent systems consume roughly 15 times the tokens of a single-agent chat baseline, compared to about 4 times for a single agent with tools. Token usage explains about 80 percent of performance variance, so the added capacity often justifies the cost for complex tasks.

When should I not use a multi-agent architecture?

Avoid multi-agent designs for simple queries or tasks that do not decompose into parallel subtasks, since coordination overhead and token costs negate benefits. Upgrading to a stronger single model often provides larger gains than adding agents.

How do I prevent agents from agreeing on wrong answers in multi-agent debates?

Use weighted voting that favors higher-confidence or domain-expert agents instead of simple majority voting. Debate protocols with adversarial critique rounds and sycophancy triggers that detect agents mimicking each other also reduce false consensus.