# Compose

> Use when a single agent demonstrably cannot handle the task and multi-agent coordination is justified.

- **Type:** Skill
- **Install:** `agentstack add skill-sharpdeveye-maestro-compose`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sharpdeveye](https://agentstack.voostack.com/s/sharpdeveye)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sharpdeveye](https://github.com/sharpdeveye)
- **Source:** https://github.com/sharpdeveye/maestro/tree/main/source/skills/compose
- **Website:** https://maestroskills.dev

## Install

```sh
agentstack add skill-sharpdeveye-maestro-compose
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

## MANDATORY PREPARATION

Invoke /agent-workflow — it contains workflow principles, anti-patterns, and the **Context Gathering Protocol**. Follow the protocol before proceeding — if no workflow context exists yet, you MUST run /teach-maestro first.
Consult the agent-architecture reference in the agent-workflow skill for topology patterns and when multi-agent is justified.

---

Design a multi-agent system. But first — are you sure you need one?

### Step 1: Pre-Composition Check

Answer these before proceeding:

1. **Has a single agent been tried and failed?** (If no, try single agent first)
2. **What specific limitation requires multiple agents?** (If you can't name it, you don't need multi-agent)
3. **Is the cost/latency increase justified?** (Multi-agent = 2-10x cost and latency)

If you can't articulate a specific limitation, use /amplify on the single agent instead.

### Step 2: Design the Topology

Choose the right architecture pattern (consult the agent-architecture reference in the agent-workflow skill):

For each agent in the system, define:

```markdown
## Agent: [Name]
Role: [One sentence]
Responsibilities: [What it does]
Boundaries: [What it does NOT do]
Tools: [List of tools this agent has access to]
Input: [What it receives]
Output: [What it produces]
```

### Step 3: Design Handoffs

For each agent-to-agent connection:

```markdown
## Handoff: [Agent A] → [Agent B]
Trigger: [When does A hand off to B?]
Payload: [What data is passed?]
Expected response: [What does A expect back?]
Timeout: [How long to wait?]
Failure handling: [What if B fails?]
```

### Step 4: Design the Supervisor

Every multi-agent system needs a supervisor:

- Monitors agent health and performance
- Routes tasks to appropriate agents
- Handles failures and escalation
- Enforces global constraints (budget, time, quality)

### Composition Checklist

- [ ] Each agent has a clear, non-overlapping role
- [ ] Handoff protocols are defined for every connection
- [ ] A supervisor pattern is in place
- [ ] Cost/latency budget accounts for all agents
- [ ] Failure modes are handled at every handoff point
- [ ] The system can be understood by reading the topology diagram

### Recommended Next Step

After composition, run `/fortify` to add error handling at every handoff, then `/evaluate` to test the multi-agent system end-to-end.

**NEVER**:

- Build multi-agent for a problem a single agent can handle
- Create agents with overlapping responsibilities
- Skip the supervisor (autonomous swarms are unpredictable)
- Pass full context between all agents (pass only what's needed)
- Compose without defining handoff protocols

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sharpdeveye](https://github.com/sharpdeveye)
- **Source:** [sharpdeveye/maestro](https://github.com/sharpdeveye/maestro)
- **License:** MIT
- **Homepage:** https://maestroskills.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sharpdeveye-maestro-compose
- Seller: https://agentstack.voostack.com/s/sharpdeveye
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.