multi-agent-coordinator

Coordinate concurrent agents using leases, fencing tokens, and exclusive-write semantics.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill multi-agent-coordinator-quydu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: multi-agent-coordinator
Source: https://github.com/QuyDu/Skills-Orchestrator/tree/main/.github/skills/multi-agent-coordinator
Command: npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill multi-agent-coordinator-quydu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When multiple agents work on the same repository artifacts at the same time, they can overwrite each other's outputs, corrupt shared state, or make conflicting decisions. This Skill prevents that by enforcing deterministic concurrency control with leases, fencing tokens, and explicit ownership rules. ## Core Features & Use Cases - Lease-Based Ownership: Issues and renews leases with fencing tokens, TTLs, and explicit read/write scopes so only one agent holds exclusive write access at a time. - Conflict Detection and Resolution: Rejects conflicting claims deterministically, records conflict outcomes and retries, and provides resume guidance for expired leases. - Ownership Transfer: Coordinates safe handoffs by requiring the current owner to release before the next owner accepts. - Use Case: Two agents both need to update the same workflow report. The coordinator grants an exclusive-write lease to one, rejects the other's claim with a deterministic conflict reason, and publishes the coordination state to reports/coordination-state.json for downstream observability. ## Quick Start Ask the agent to coordinate two concurrent agents contending for the same report output using exclusive-write lease semantics.

Frequently Asked Questions about multi-agent-coordinator

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

FAQPage Schema
How do I prevent multiple agents from writing the same file concurrently?

Use lease-based coordination with fencing tokens. Each agent requests an exclusive-write lease with a TTL and scope; conflicting claims are rejected deterministically with a conflict reason and next action, so only one owner can write at a time.

What is a fencing token in distributed coordination?

A fencing token is a monotonic identifier attached to a lease that lets downstream systems reject stale writers. In this Skill, every active lease carries an owner, token, scope, and expiration so outdated holders cannot perform writes.

When should I not use multi-agent coordination?

Do not use it for single-agent sequential work, where lease overhead adds no value. It is designed only for scenarios where more than one agent may write the same artifacts concurrently.

What happens when lease state is ambiguous or corrupted?

The coordinator fails closed: it preserves the last valid coordination snapshot, returns a blocked conflict state, and never grants write ownership under uncertain concurrency conditions.

How does ownership transfer work between agents?

Ownership transfer requires the current owner to release its lease and the next owner to explicitly accept. Forced revocation or manual overrides that could discard in-flight work require explicit approval first.