TeoSlayer/pilot-skills / skills/pilot-event-bus
pilot-event-bus
VerifiedMulti-agent event aggregation on shared topics for coordinated workflows. Use this skill when: 1. You need to aggregate events from multiple agents on a shared topic 2. You need to broadcast events to all subscribed agents 3. You need to coordinate state changes across a fleet of agents 4. You need to implement fan-out messaging patterns Do NOT use this skill when: - You need point-to-point messaging (use pilot-protocol connect instead) - You need persistent storage (use pilot-event-log instead) - You need filtered or transformed events (use pilot-event-filter instead)
SKILL.md
View on GitHub---
name: pilot-event-bus
description: >
Multi-agent event aggregation on shared topics for coordinated workflows.
Use this skill when:
1. You need to aggregate events from multiple agents on a shared topic
2. You need to broadcast events to all subscribed agents
3. You need to coordinate state changes across a fleet of agents
4. You need to implement fan-out messaging patterns
Do NOT use this skill when:
- You need point-to-point messaging (use pilot-protocol connect instead)
- You need persistent storage (use pilot-event-log instead)
- You need filtered or transformed events (use pilot-event-filter instead)
tags:
- pilot-protocol
- pub-sub
- event-bus
- coordination
license: AGPL-3.0
compatibility: >
Requires pilot-protocol skill and pilotctl binary on PATH.
The daemon must be running (pilotctl daemon start).
All participating agents must have mutual trust established.
metadata:
author: vulture-labs
version: "1.0"
openclaw:
requires:
bins:
- pilotctl
homepage: https://pilotprotocol.network
allowed-tools:
- Bash
---
# Pilot Event Bus
Multi-agent event aggregation using Pilot Protocol's built-in pub/sub on port 1002.
## Commands
### Publish Event
```bash
pilotctl --json publish <target-hostname> <topic> --data <payload>
```
### Subscribe to Events
```bash
pilotctl --json subscribe <target-hostname> <topic> [--timeout <seconds>]
```
### List Trusted Agents
```bash
pilotctl --json trust
```
### Find Agent
```bash
pilotctl --json find <hostname>
```
### Establish Trust
```bash
pilotctl --json handshake <hostname> "reason for trust request"
```
## Workflow Example
```bash
#!/bin/bash
# Fleet coordination
pilotctl --json trust | jq -r '.data.trusted[].hostname'
pilotctl --json subscribe fleet-coordinator "tasks.assigned.*" --timeout 300 > /tmp/events.json &
pilotctl --json publish fleet-coordinator "tasks.assigned.worker-1" \
--data "{\"task_id\":\"task-123\",\"assigned_at\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}"
jq -r '.data.events[] | "\(.timestamp): \(.topic) -> \(.data)"' /tmp/events.json
```
## Topic Naming
- `category.subcategory.event` (dotted hierarchy)
- Examples: `tasks.assigned.worker-1`, `metrics.cpu.usage`, `alerts.error.database`
- Wildcards: `tasks.*`, `alerts.error.*`, `*`
## Dependencies
Requires pilot-protocol skill, pilotctl, running daemon, and mutual trust between agents.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |