Skip to content
16 changes: 12 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,31 +2,39 @@

Skills, slash commands, and a Claude Code plugin for building multi-agent systems with Agent Relay.

Package metadata lives in [prpm.json](prpm.json). The repo currently publishes `agent-workforce-skills` version `1.0.10`.
Package metadata lives in [prpm.json](prpm.json). The repo currently publishes `agent-workforce-skills` version `1.1.0`.

## Published Skills

| Skill | Version | Description |
|-------|---------|-------------|
| [choosing-swarm-patterns](skills/choosing-swarm-patterns/SKILL.md) | 1.1.3 | Pick the right Agent Relay orchestration pattern across the 10 core swarm patterns plus specialized patterns. |
| [writing-agent-relay-workflows](skills/writing-agent-relay-workflows/SKILL.md) | 1.6.12 | Build multi-agent workflows with WorkflowBuilder, DAG dependencies, verification gates, mandatory Claude-then-Codex review/fix loops with test hardening, channels, and chat-native coordination recipes. |
| [writing-agent-relay-workflows](skills/writing-agent-relay-workflows/SKILL.md) | 1.6.15 | Build multi-agent workflows with WorkflowBuilder, DAG dependencies, verification gates, mandatory Claude-then-Codex review/fix loops with test hardening, channels, and chat-native coordination recipes. |
| [setting-up-relayfile](skills/setting-up-relayfile/SKILL.md) | 1.1.0 | Set up Relayfile mounts and writeback for provider files through local filesystem access. |
| [using-agent-relay](skills/using-agent-relay/SKILL.md) | 1.3.0 | Participant-side MCP reference for a **registered** relay agent (spawned worker / registered lead): messaging, channels, threads, reactions, search, webhooks. Counterpart to `orchestrating-agent-relay`. |
| [orchestrating-agent-relay](skills/orchestrating-agent-relay/SKILL.md) | 2.0.0 | The canonical way to run agent-relay: self-bootstrap the broker and autonomously spawn, monitor, and coordinate a worker team without human intervention. |
| [orchestrating-agent-relay](skills/orchestrating-agent-relay/SKILL.md) | 2.1.2 | The canonical way to run agent-relay: self-bootstrap the broker and autonomously spawn, monitor, and coordinate a worker team without human intervention. |
| [relay-80-100-workflow](skills/relay-80-100-workflow/SKILL.md) | 1.0.7 | Author workflows that close the 80-to-100 validation gap with repair-aware test, verify, mandatory Claude-then-Codex review/fix with test hardening, and commit gates. |
| [review-fix-signoff-loop](skills/review-fix-signoff-loop/SKILL.md) | 1.0.2 | Loop review, repair, validation, and fresh-context dual-agent signoff until independent reviewers both satisfy the verdict contract. |
| [activity-summary](skills/activity-summary/SKILL.md) | 1.0.0 | Answer "what did I work on yesterday" questions by reading `digests/yesterday.md` first instead of crawling provider directories. |
| [daily-digest](skills/daily-digest/SKILL.md) | 1.0.0 | Authoring contract for `<mount>/digests/` files — windows, per-provider sections, adapter `digest()` exports, regeneration rules. |
| [writeback-as-files](skills/writeback-as-files/SKILL.md) | 1.0.0 | File-creation writeback contract — drop a JSON file at the canonical path and relayfile delivers the mutation, with dead-letter recovery. |
| [workspace-layout](skills/workspace-layout/SKILL.md) | 1.0.0 | Navigate a relayfile mount via root and per-provider `LAYOUT.md` files plus `by-*` alias indexes instead of `find`/`grep -r`. |
| [adding-swarm-patterns](skills/adding-swarm-patterns/SKILL.md) | 1.0.0 | Checklist for extending agent-relay with a new swarm pattern — TypeScript types, JSON schema, YAML template, and pattern/template docs. |
| [auto-merge-and-composition-safety](skills/auto-merge-and-composition-safety/SKILL.md) | 1.0.0 | Review and auto-merge discipline for autonomous PR runs, including live CI checks, bot-finding triage, and cross-PR composition safety. |
| [autonomous-run-contract](skills/autonomous-run-contract/SKILL.md) | 1.0.0 | Author the binding contract for autonomous multi-PR cutover runs: grants, gates, flip mechanism, rollback triggers, constraints, and escalation rules. |
| [dormant-flip-and-rollback](skills/dormant-flip-and-rollback/SKILL.md) | 1.0.0 | Design cutover-class changes with a dormant build, single-switch flip, and pre-authorized rollback path. |
| [instrument-dont-guess](skills/instrument-dont-guess/SKILL.md) | 1.0.0 | Add temporary diagnostics after repeated failed fixes instead of continuing to guess at the same symptom. |
| [swarm-blockers-and-gate-scoreboard](skills/swarm-blockers-and-gate-scoreboard/SKILL.md) | 1.0.0 | Dispatch paired worker/reviewer agents for hard blockers and maintain RED/GREEN gate scoreboards for autonomous runs. |
| [tiered-acceptance](skills/tiered-acceptance/SKILL.md) | 1.0.0 | Split broad acceptance gates into deeply proven tier-1 coverage and explicitly accepted tier-2 smoke coverage. |
| [openclaw-orchestrator](skills/openclaw-orchestrator/SKILL.md) | 1.0.0 | Run headless multi-agent orchestration sessions via Agent Relay — spawn teams across Claude/Codex/Gemini/Pi/Droid, create channels, and manage agent lifecycle. |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: README advertises openclaw-orchestrator as a published skill, but it is not declared in prpm.json packages. This will mislead users about installable packages until either the manifest is updated or the README entry is removed.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At README.md, line 29:

<comment>README advertises `openclaw-orchestrator` as a published skill, but it is not declared in `prpm.json` packages. This will mislead users about installable packages until either the manifest is updated or the README entry is removed.</comment>

<file context>
@@ -22,15 +22,11 @@ Package metadata lives in [prpm.json](prpm.json). The repo currently publishes `
-| [running-headless-orchestrator](skills/running-headless-orchestrator/SKILL.md) | 1.0.0 | Self-bootstrap Agent Relay and manage a team of workers without human intervention. |
-| [trigger-autocomplete-catalog](skills/trigger-autocomplete-catalog/SKILL.md) | 1.0.0 | Register webhook events in the trigger autocomplete catalog when integrations add provider events. |
-| [shadcn](skills/shadcn/SKILL.md) | 1.0.0 | Work with shadcn/ui projects, registries, presets, component composition, styling, CLI commands, and MCP helpers. |
+| [openclaw-orchestrator](skills/openclaw-orchestrator/SKILL.md) | 1.0.0 | Run headless multi-agent orchestration sessions via Agent Relay — spawn teams across Claude/Codex/Gemini/Pi/Droid, create channels, and manage agent lifecycle. |
 
 ## Slash Commands
</file context>


## Slash Commands

| Command | Version | Description |
|---------|---------|-------------|
| [/create-workflow](commands/create-workflow.md) | 1.0.2 | Scaffold a model-agnostic Agent Relay workflow using the workflow and swarm-pattern skills, including mandatory Claude-then-Codex review/fix loops with test hardening. |
| [/create-workflow](commands/create-workflow.md) | 1.0.3 | Scaffold a model-agnostic Agent Relay workflow using the workflow and swarm-pattern skills, including mandatory Claude-then-Codex review/fix loops with test hardening. |
| [/spawn](commands/spawn.md) | 1.0.0 | Bootstrap the broker and spawn a worker for `claude`, `codex`, `opencode`, `droid`, `gemini`, or `pi`. |
| [/review-loop](commands/review-loop.md) | 1.0.1 | Run a dual-reviewer code-review loop with repair and fresh-context signoff. |

## Claude Relay Plugin

Expand Down
2 changes: 1 addition & 1 deletion commands/spawn.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Bootstrap the agent-relay broker (if not already running) and spawn a worker on
4. **Ensure a coordination channel exists.** Default to `#orchestrator` unless the user specified one. Create it via `mcporter call relaycast create_channel` if missing, then join it.

5. **Spawn the worker.** Construct the spawn command from parsed args:
```
```text
agent-relay spawn <auto-name> $1 [--model <model>] [--team orchestrator] "<task>"
```
- `<auto-name>` should be unique per run (e.g., `worker-<short-uuid>`) to avoid 409 conflicts.
Expand Down
70 changes: 70 additions & 0 deletions prpm.json
Original file line number Diff line number Diff line change
Expand Up @@ -283,6 +283,76 @@
"files": [
"commands/review-loop.md"
]
},
{
"name": "auto-merge-and-composition-safety",
"version": "1.0.0",
"description": "Use before auto-merging any PR in an autonomous run, and between consecutive merges that touch overlapping code. Covers the per-PR auto-merge bar (live CI verification, substantive review by area, bot-finding stale-vs-actionable triage) and the cross-PR composition discipline (serialize through green main, rebase + re-CI between merges, dormant-safety audit, force-reset over half-merged commits).",
"format": "claude",
"subtype": "skill",
"files": [
"skills/auto-merge-and-composition-safety/SKILL.md"
]
},
{
"name": "autonomous-run-contract",
"version": "1.0.0",
"description": "Use at the start of every autonomous, multi-PR, cutover-class delegated run. Authors the binding contract between operator and agent — the gates, the flip mechanism, the rollback triggers, the standing constraints, and the explicit escalate-to-human conditions — and surfaces it to the operator for explicit grant of (a) auto-merge authority, (b) flip-the-switch authority, (c) swarm-blockers authority. No autonomous work begins until the contract is acknowledged.",
"format": "claude",
"subtype": "skill",
"files": [
"skills/autonomous-run-contract/SKILL.md"
]
},
{
"name": "dormant-flip-and-rollback",
"version": "1.0.0",
"description": "Use when designing or executing a cutover-class change (migration, ingestion path swap, provider relink, flag enablement). Encodes the dark-launch + single-switch flip pattern, the refusal to flip on amber, and the pre-authorized rollback procedure — the canonical way to make irreversible-feeling infra changes reversible-feeling.",
"format": "claude",
"subtype": "skill",
"files": [
"skills/dormant-flip-and-rollback/SKILL.md"
]
},
{
"name": "instrument-dont-guess",
"version": "1.0.0",
"description": "Use when a fix has failed two consecutive times for the same symptom. Encodes the discipline that the third action must be a temporary diagnostic (a /_diag endpoint, an enriched structured log, a runtime-captured snapshot) rather than another fix attempt. Also covers the discipline for removing those diagnostics once the real root cause is in.",
"format": "claude",
"subtype": "skill",
"files": [
"skills/instrument-dont-guess/SKILL.md"
]
},
{
"name": "swarm-blockers-and-gate-scoreboard",
"version": "1.0.0",
"description": "Use during an autonomous run to (a) dispatch supporting codex-impl + claude-review agent pairs against hard blockers when the orchestrator cannot make progress alone, and (b) maintain the live RED / GREEN gate scoreboard the orchestrator reads to authorize the flip. Encodes the file-based reporting convention that keeps the channel readable.",
"format": "claude",
"subtype": "skill",
"files": [
"skills/swarm-blockers-and-gate-scoreboard/SKILL.md"
]
},
{
"name": "tiered-acceptance",
"version": "1.0.0",
"description": "Use when a single gate would require deep proof across a large set (44 models × 10 providers; 60+ resources; every region; every plan tier). Splits the acceptance into tier-1 (deep proof on high-volume / high-fidelity slice) and tier-2 (smoke proof on low-volume tail), documents the explicit accepted trade-off, and preserves safety through dormant-default + per-item enable + rollback.",
"format": "claude",
"subtype": "skill",
"files": [
"skills/tiered-acceptance/SKILL.md"
]
},
{
"name": "openclaw-orchestrator",
"version": "1.0.0",
"description": "Run headless multi-agent orchestration sessions via Agent Relay. Use when spawning teams of agents, creating channels for coordination, managing agent lifecycle, and running parallel workloads across Claude/Codex/Gemini/Pi/Droid agents.",
"format": "claude",
"subtype": "skill",
"files": [
"skills/openclaw-orchestrator/SKILL.md"
]
}
],
"collections": [
Expand Down
Loading