peer-collab

Send direct peer-to-peer messages between Zeus agents via the file bus.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JBODE-mhhs/Zeus2.0-public --skill peer-collab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: peer-collab
Source: https://github.com/JBODE-mhhs/Zeus2.0-public/tree/main/templates/orchestrator/.claude/skills/peer-collab
Command: npx skills add https://github.com/JBODE-mhhs/Zeus2.0-public --skill peer-collab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Wire two Zeus team members so they can talk to each other directly via the file bus instead of round-tripping every exchange through the orchestrator. Use whenever the operator says "let agent X talk to agent Y", or when a workflow has two roles that need a tight back-and-forth (e.g. frontend ↔ backend during an API contract negotiation).

Core Features & Use Cases

  • Direct peer-to-peer messaging between two agents via the file bus, bypassing the orchestrator when fast back-and-forth is needed.
  • Peers are declared in each agent's config.json and surfaced as ZEUS_PEERS, enabling targeted private conversations.
  • Use Case: during API contract negotiations, design reviews, or cross-role handoffs where low-latency coordination matters.

Quick Start

Configure two agents with each other’s IDs in their config.json peers list and run them in the same mission to enable direct peer messaging.

Frequently Asked Questions about peer-collab

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

FAQPage Schema
How do I set up direct peer-to-peer messaging between Zeus team members?▼

Configure direct peer-to-peer messaging by adding each agent's ID to the other's config.json peers list. Both agents must run in the same mission to exchange messages directly via the file bus.

What is the best way to let two agents coordinate without routing through the orchestrator?▼

Direct peer-to-peer messaging bypasses the orchestrator by using the zeus bus send-message command. This enables fast back-and-forth coordination between two roles, such as frontend and backend during API contract negotiations.

When should I use direct peer messaging instead of orchestrator-based workflows?▼

Use direct peer messaging for tight back-and-forth coordination between two roles, like design reviews or cross-role handoffs. It provides low-latency communication by skipping the orchestrator round-trip via the file bus.

Do I need to configure ZEUS_PEERS for file bus messaging to work?▼

Yes, ZEUS_PEERS must be configured. You declare peers in each agent's config.json, which surfaces them as ZEUS_PEERS and enables targeted private conversations over the Zeus file bus.

How are peer-to-peer messages received after being sent on the Zeus bus?▼

Peer-to-peer messages are sent using zeus bus send-message and are received by the target agent on its next inbox check. This polling mechanism allows asynchronous communication between agents.

Can I use peer collaboration for cross-role handoffs in a single mission?▼

Yes, peer collaboration is designed for workflow scenarios within a single mission. It supports cross-role handoffs and tight coordination between two configured agents operating in that mission.