Agent skill

Multi Agent Handoff

by Arenukvern in Arenukvern/mcp_flutter

Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

MITAuto-check passedAgent Workflows

Install Multi Agent Handoff

skills CLI
$ npx skills add Arenukvern/mcp_flutter --skill multi-agent-handoff -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Arenukvern/mcp_flutter multi-agent-handoff --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Arenukvern/mcp_flutter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/multi-agent-handoff .claude/skills/multi-agent-handoff && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
multi-agent-handoff
GitHub stars
386
Token cost
~2.7k tokens
SKILL.md length
1,060 words
Files
8 (incl. references)
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

  • Works in 6 steps: Isolate the minimal source-owned diff… → Apply only that diff to the owner… → Rerun the lane's native gate in the… → …
  • Multi-agent workflows
  • SKILL.md covers When to use, Handoff document template, Parallel batch contract and Parent lane contract, plus 6 more sections
  • Calls npx

What it does

Multi Agent Handoff is an agent skill from Arenukvern/mcp_flutter. Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers). Use for multi-agent workflows, subagents, original goal preservation, native gates, claim ceilings, terminal states, baton passes, or guild-style agent coordination.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files (for example `evals/cases/parallel-batch-contract-trigger.yaml`, `evals/cases/parallel-overhead-collapse-trigger.yaml` and `evals/cases/parallel-product-impact-guardrail-trigger.yaml`).

It sits in Agent Workflows, covering Multi-agent orchestration. The repository describes itself as: MCP Toolkit for Flutter AI Agent Driven Development (MCP/CLI + custom client side tools) - via closed feedback loop (visual & semantic snapshot) and high client side… The licence is MIT.

When your agent uses it

  • Multi-agent workflows
  • Original goal preservation
  • Terminal states
  • Guild-style agent coordination

Example prompts

  • “/multi-agent-handoff”

Requirements

  • Node.js

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Isolate the minimal source-owned diff from the temp or worker result.
  2. Apply only that diff to the owner checkout.
  3. Rerun the lane's native gate in the owner checkout.
  4. Update the current ledger or evidence note only if the claim changed.
  5. Record source_owner_status as temp_only,
  6. Mark the terminal state as integrated_to_owner, blocked_to_current_ledger,

What it can do on your machine

Read from SKILL.md and the folder at commit 62f3ee1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Multi Agent Handoff loads about 2.7k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 82 tokens; SKILL.md has 1,060 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~82
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Arenukvern/mcp_flutter at commit 62f3ee1, republished under its MIT licence (© Arenukvern). 1,060 words, ~2,724 tokens.

Download SKILL.mdSave it as .claude/skills/multi-agent-handoff/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
multi-agent-handoff
description
Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers). Use for multi-agent workflows, subagents, original goal preservation, native gates, claim ceilings, terminal states, baton passes, or guild-style agent coordination.
license
MIT
type
governance
metadata.author
skill-steward
metadata.version
1.0.0
metadata.category
multi-agent

Multi-agent handoff

Structure work so multiple agents can execute sequentially without losing context.

When to use

  • Splitting a large task across explorer, implementer, and reviewer agents
  • Foreman/worker or parent/subagent patterns
  • Need a written baton between chat sessions or tools

Handoff document template

Create or update HANDOFF.md (or a section in the task issue) with:

markdown
## Goal
{one sentence outcome}

## Done
- {completed items}

## Next
1. {ordered steps for the receiving agent}

## Constraints
- {tech stack, style, files not to touch}

## Verification
- {commands or checks that must pass}

## Validation status
- {commands run}
- {commands skipped or blocked, with reason}
- {blocked JSON explained with `steward blocked explain --input <path> --json`, when available}
- {schema/output drift checked with `steward schema check-outputs --json`, when machine-readable output is part of the handoff}
- {claims not proven because validation was skipped or blocked}

## Partial results
- {missing, partial, superseded, or timed-out agents/lenses}

## Context links
- {paths, PRs, prior decisions}

## Artifact capture
- {ADR, FAQ, skill, evidence note, test, validator, generator, or check that should absorb durable learning}

Parallel batch contract

For broad decomposable work, the parent may use a disposable batch section instead of a new plan format. Keep only enough contract to move safely:

  • original goal and user acceptance check;
  • default native gate and aggregate gates;
  • product impact check for the primary artifact, especially when the repo is an app, library, CLI/tool, plugin, or prototype;
  • detour budget and stop condition;
  • integration capacity, merge order, and conflict policy;
  • comparison strategy for lane outputs;
  • final evidence boundary, claim ceiling, and non-claims;
  • acceleration note with three fields: Saved, Cost/duplication, and Future hot path;
  • hot-path promotion check for repeated verification or comparison work.

Use this compact shape before dispatching parallel lanes:

markdown
## Parallel Batch
Original goal: {user-visible outcome}
Acceptance check: {how the parent will know the original goal is satisfied}
Product impact check: {source-owned product behavior/API/UI/perf/doc-user workflow that must change or be proven unchanged}
Default native gate: {repo-native command or reason none exists}
Aggregate gate: {final validation before claiming completion}
Detour budget: {when to stop repairing tools and return to the goal}
Claim ceiling: {strongest claim allowed if all lanes pass}
Non-claims: {adjacent claims this batch cannot prove}
Acceleration note:
- Product impact line: {recognized prefix plus proof; use support_only: Steward scaffolding only when no product surface moved}
- Saved: {time, uncertainty, or risk reduced by running lanes in parallel}
- Cost/duplication: {duplicated work, integration cost, or coordination drag caused or avoided}
- Future hot path: {command, check, skill, script, deletion, or native route created for the next run}

| Lane | Agent/role | Scope | Write set | Forbidden paths | Native gate | Direct fix? | Terminal state |
|------|------------|-------|-----------|-----------------|-------------|-------------|----------------|
| L1 | {owner} | {bounded work} | `{paths}` | `{paths}` | `{command}` | yes/no | pending |

Delete or collapse this batch section after synthesis unless it becomes a review artifact. Do not preserve lane maps as project management state.

Parent lane contract

Parent-assigned lane contracts are the only write-authority surface. Advisory ecology route dispatch_lane_candidates, MoE findings, A2A notes, and reviewer comments are inputs only.

Each assigned lane should state:

  • lane_id, assigned agent/role, scope, exact write_set, and forbidden_paths;
  • inherited repo rules, required impact checks, permission checks, native gate, and aggregate gate responsibility;
  • direct_fix_allowed: true|false, claim ceiling, non-claims, and escalation triggers;
  • terminal state: integrated_to_owner, rejected, blocked_to_current_ledger, promoted_to_durable_owner, deleted, reported_to_parent, accepted_as_input, partial, timed_out, or superseded.

Only a parent lane contract may set direct_fix_allowed: true. Direct fixes must be bounded low-risk work with exact write sets, declared forbidden paths, inherited safety rules, required impact/permission checks, and available validation. If validation is skipped or blocked, the result downgrades to blocked or recommendation; it is not integrated_to_owner.

A2A artifacts never authorize writes, widen scope, accept/reject lanes, or launder steward judgment. The parent or explicit A2Human checkpoint owns authorization, synthesis, final claims, and scope changes.

Landing phase

When a lane proves a fix in a temp clone, fork, worktree, or external checkout, that proof is accepted_as_input until the owner checkout carries the smallest source-owned diff and reruns the native gate. Do not treat temp proof as repo-owned evidence by default.

Before claiming a lane is integrated:

  1. Isolate the minimal source-owned diff from the temp or worker result.
  2. Apply only that diff to the owner checkout.
  3. Rerun the lane's native gate in the owner checkout.
  4. Update the current ledger or evidence note only if the claim changed.
  5. Record source_owner_status as temp_only, owner_landed_pending_gate, owner_gate_passed, or blocked_owner_dirty.
  6. Mark the terminal state as integrated_to_owner, blocked_to_current_ledger, accepted_as_input, or rejected.

If the source checkout is dirty or cannot accept the diff safely, record the temp proof as a candidate and keep the stronger source-owned claim unproven. After one bounded landing attempt, close the lane as blocked or rejected rather than creating another proof packet for the same unlanded result.

Show full SKILL.md (559 more words)Show less

Workflow

  1. Decompose — break the goal into independent slices where possible.
  2. Assign roles — e.g. Explore (read-only), Implement (write), Review (read-only critique).
  3. Write baton — fill the template; keep "Next" to ≤7 concrete steps. For parallel work, include the compact batch table before dispatch.
  4. Execute one slice — receiving agent does only "Next"; updates "Done".
  5. Record proof — update validation status before claiming completion. Skipped checks and blocked generators are non-proof, not quiet success.
  6. Land source-owned changes — convert temp or worker proof into the owner checkout and rerun the native gate before strengthening the claim.
  7. Close every lane — assign a terminal state to each lane or lens, including timed-out, blocked, or superseded work.
  8. Measure acceleration — fill the acceleration note with what was saved, what duplicated work or coordination cost appeared, and what future command/check/hot path now exists. If nothing was saved, say so and keep the claim ceiling low.
  9. Check product impact — for product repos, name the source-owned product delta or product-native gate reached. If the batch only improved Steward scaffolding, proof artifacts, or tools-about-tools, claim orientation or harness maintenance only, not product acceleration. Use one product impact prefix: runtime_behavior:, public_api:, product_native_gate:, visual_capture:, performance_metric:, release_path:, developer_workflow:, command_output:, plugin_install:, or support_only:. If Cost/duplication is not lower than the saved uncertainty, risk, or repeat work, default to leave_native, rejected, or a low-confidence support claim.
  10. Capture durable learning — if a finding changes future behavior, route it to an ADR, FAQ, skill, evidence note, validator, generator, test, or check.
  11. Re-handoff — pass updated HANDOFF.md to the next agent or subagent.
  12. Close — delete or archive handoff file when goal is verified.

Anti-patterns

  • Vague "continue working on X" without file paths or acceptance criteria
  • Handoffs longer than one screen (split into references/ or issues)
  • Duplicate conflicting instructions across parent and child agents
  • Subagents that repeat the parent plan instead of looking for contradiction, stale assumptions, missing evidence, or smaller deletable designs
  • Final handoffs that sound complete while validation is skipped, blocked, or only manually inferred
  • Clean temp proof presented as source-owned adoption before landing and rerunning the owner checkout's native gate
  • Long-running or vanished subagents silently absorbed into parent synthesis without a partial, timed_out, blocked, or superseded terminal state
  • Parallel work claimed as faster without naming saved uncertainty, duplicated work, and the future command/check/hot path it created
  • A batch that closes with green Steward gates but no product delta, product-native gate, screenshot/perf proof, API behavior change, or user-facing workflow improvement while still claiming product acceleration

Subagent hints (Codex / Cursor / Zed)

  • Use read-only agents for exploration and review
  • Pass the handoff block verbatim in the subagent prompt
  • Prefer disable-model-invocation: true on skills that must run only when invoked
  • For parallel work, keep agent scopes non-overlapping and declare write ownership before implementation.
  • Useful reviewer roles include Repo Truth Verifier, Boundary Leak Reviewer, Evidence Ladder Reviewer, Doc Collapse Reviewer, Harness QA Reviewer, and Stale External Assumption Reviewer.
  • Codex custom agents live in .codex/agents/*.toml or ~/.codex/agents/*.toml; define name, description, and developer_instructions, and spawn subagents only when the user explicitly asks for subagent delegation.
  • Cursor custom subagents live in .cursor/agents/*.md or ~/.cursor/agents/*.md; each run has isolated context, and background/parallel execution is useful for independent slices.
  • Zed parallel work uses separate agent threads or worktrees; use skills for repeatable single-context procedures and threads for independent concurrent work.

Install

bash
npx skills add arenukvern/skill_steward --skill multi-agent-handoff

Sources

See references/sources.md. When researching, follow skill-source-citations.

© Arenukvern, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in .agents/skills/multi-agent-handoff of Arenukvern/mcp_flutter.

  • SKILL.md
  • evals/cases/parallel-batch-contract-trigger.yaml
  • evals/cases/parallel-overhead-collapse-trigger.yaml
  • evals/cases/parallel-product-impact-guardrail-trigger.yaml
  • evals/cases/temp-proof-landing-trigger.yaml
  • references/evals.md
  • references/handoff-template.md
  • references/sources.md

Open the folder on GitHubat commit 62f3ee1

Compare with similar skills

Multi Agent Handoff next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Multi Agent Handoff compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Multi Agent Handoff this skillArenukvern/mcp_flutter386—~2.7kAutomated safety check: PassMIT
Orca CLIstablyai/orca88k2 repos~593Automated safety check: PassMIT
Paseo Advisor Second Opiniongetpaseo/paseo20k1 repos~756Automated safety check: PassCustom licence
O2 Review Loopopenobserve/openobserve22k—~3.7kAutomated safety check: PassAGPL-3.0
Paseo Committeegetpaseo/paseo20k1 repos~496Automated safety check: PassCustom licence
Mission Control Agent APIbuilderz-labs/mission-control6.3k—~2.1kAutomated safety check: PassMIT

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    88k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed
  • Launches one separate agent through Paseo to give a second opinion on the current task, with a self-contained briefing and no permission to edit files.

    20k GitHub starsUsed in 1 repo~756 tokens
    Agent WorkflowsAuto-check passed
  • O2 Review Loop

    openobserve/openobserve

    Splits a change into planner, coder and independent reviewer roles: you confirm a spec, a subagent implements it, and a separate reviewer checks each round's local WIP commit.

    22k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Paseo Committee

    getpaseo/paseo

    Forms a two-agent committee with contrasting profiles to analyze a stuck problem in parallel, reconcile their views and return a consensus plan without editing files.

    20k GitHub starsUsed in 1 repo~496 tokens
    Agent WorkflowsAuto-check passed
  • Mission Control Agent API

    builderz-labs/mission-control

    Teaches an agent to use the Mission Control dashboard API: register, send heartbeats, fetch assigned tasks, report progress and disconnect, with API key auth.

    6.3k GitHub stars~2.1k tokensUpdated 11 days ago
    Agent WorkflowsAuto-check passed
  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed

More from Arenukvern/mcp_flutter

All 23 skills in this repo
  • Harness Engineering Lifecycle

    Arenukvern/mcp_flutter

    Design, implement, and integrate generalized validation harnesses across a producer-consumer boundary after a local harness contract exists.

    386 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Mixture Of Experts

    Arenukvern/mcp_flutter

    Run a Mixture of Experts (MoE) audit on any topic, plan, codebase, evidence archive, or process.

    386 GitHub stars~2.3k tokensUpdated 6 days ago
    Auto-check passed
  • Plugin Marketplace Setup

    Arenukvern/mcp_flutter

    Designs public or private Agent Skill and plugin marketplaces for Cursor, Claude Code, Codex, Zed, Open Plugin, and npx skills—manifest layout, install matrix, and Skill Steward vs product boundaries.

    386 GitHub stars~2.9k tokensUpdated 6 days ago
    Auto-check passed
  • Release Changelog Harness

    Arenukvern/mcp_flutter

    Chooses ecosystem-native release and changelog tooling (Changesets, Melos, release-plz) plus binary distribution (GitHub Release tarballs, install.sh) when the product is an executable.

    386 GitHub stars~2.6k tokensUpdated 6 days ago
    Auto-check passed
  • Repository Governance Lifecycle

    Arenukvern/mcp_flutter

    Master orchestration for repository governance, North Star impact, sub-Star boundaries, and repair-first or evidence-first drift checks.

    386 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed
  • Skill Authoring Lifecycle

    Arenukvern/mcp_flutter

    Scaffold and formally review a new Agent Skill in this marketplace repo.

    386 GitHub stars~1.5k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Multi Agent Handoff

What does Multi Agent Handoff do?

Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers). Multi Agent Handoff is an agent skill from Arenukvern/mcp_flutter. Plan and document handoffs, parent lane contracts, and parallel batch contracts between specialized AI agents (foreman, workers, reviewers).

When should I use Multi Agent Handoff?

Multi Agent Handoff fits situations like: multi-agent workflows; original goal preservation; terminal states; guild-style agent coordination.

How do I install Multi Agent Handoff in Claude Code?

Run `npx skills add Arenukvern/mcp_flutter --skill multi-agent-handoff -a claude-code`. Or copy the skill folder (.agents/skills/multi-agent-handoff in Arenukvern/mcp_flutter) into .claude/skills/multi-agent-handoff in your project. Claude Code loads it when a task matches its description.

How do I install Multi Agent Handoff in Codex?

Run `npx skills add Arenukvern/mcp_flutter --skill multi-agent-handoff -a codex`. Or copy the skill folder (.agents/skills/multi-agent-handoff in Arenukvern/mcp_flutter) into .agents/skills/multi-agent-handoff in your project. Codex loads it when a task matches its description.

Can I use Multi Agent Handoff in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Arenukvern/mcp_flutter --skill multi-agent-handoff -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/multi-agent-handoff, .gemini/skills/multi-agent-handoff, .github/skills/multi-agent-handoff and .opencode/skills/multi-agent-handoff in your project.

What does Multi Agent Handoff need to run?

Going by SKILL.md and its folder, Multi Agent Handoff needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Multi Agent Handoff access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Multi Agent Handoff safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Multi Agent Handoff use?

Multi Agent Handoff is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Multi Agent Handoff use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Multi Agent Handoff?

Skills that share tags, products or a category with Multi Agent Handoff: Orca CLI (stablyai/orca, 88k stars), Paseo Advisor Second Opinion (getpaseo/paseo, 20k stars), O2 Review Loop (openobserve/openobserve, 22k stars) and Paseo Committee (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Multi Agent Handoff?

Arenukvern (a GitHub user) maintains it in Arenukvern/mcp_flutter, which has 386 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 3, 2026.

Source: Arenukvern/mcp_flutter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.