agent-message-broker-skill

The canonical agent skill for agent-message-broker (amb) — the knowledge a coding agent needs to react to amb events mid-session, inspect topics and events, and wire its own subscriptions through the amb CLI.

This package is a pure skill bundle: no code, no dependencies. The broker itself is the separate agent-message-broker package. Both are versioned in lockstep — install a skill version that matches your broker version.

Install (pi)

pi install npm:agent-message-broker-skill
pi update                     # later: updates the skill with the rest

Install (any agent, manually)

The skill is a plain SKILL.md + references directory; any Agent Skills-compatible harness can load it:

npx agent-message-broker skill print                # read it
npx agent-message-broker skill install              # copy into ~/.pi, ~/.claude, ~/.codex skill dirs
npx agent-message-broker skill install --agent codex --link

Install (Claude Code)

This package is pi-shaped; Claude Code installs the same skill through the plugin marketplace in the broker's GitHub repo:

/plugin marketplace add bitnahian/agent-message-broker
/plugin install amb@agent-message-broker

What the skill teaches the agent

• What an amb event frame is ({{kind}}/{{payload}} rendered) and how to react in the current conversation
• Discovering state: amb topics list, amb sessions, amb events list, amb deliveries
• Subscribing itself: amb topics create → amb sources create → amb subscriptions create with a template
• Where credentials and the broker token live (~/.amb/, ~/.config/agent-message-broker/token)
• Retention/replay semantics, and when not to touch vendor credentials

See skills/agent-message-broker/SKILL.md after install, or browse the source in the repo.