Skip to content

fix(skills): retarget openclaw-orchestrator and /spawn at the current CLI - #90

Open
willwashburn wants to merge 2 commits into
mainfrom
claude/agent-relay-skills-review-a8mgtd-stale-cli
Open

fix(skills): retarget openclaw-orchestrator and /spawn at the current CLI#90
willwashburn wants to merge 2 commits into
mainfrom
claude/agent-relay-skills-review-a8mgtd-stale-cli

Conversation

@willwashburn

@willwashburn willwashburn commented Aug 3, 2026

Copy link
Copy Markdown
Member

Summary

openclaw-orchestrator documents a CLI that no longer exists. Nearly every command in it is wrong:

Skill says Actually
agent-relay up --workspace-key … --no-spawn agent-relay node up --background
agent-relay spawn NAME CLI "task" agent-relay node agent spawn <cli> --name … --task …
agent-relay agents agent-relay node agent list
agent-relay agents:logs NAME agent-relay node tail --agent NAME
agent-relay agents:kill NAME agent-relay node agent release NAME
agent-relay send '#chan' 'msg' / agent-relay inbox agent-relay message post / message inbox check
agent-relay down agent-relay node down
mcporter call relaycast create_channel relay MCP tools, or --channels on spawn
--team TEAM no such flag — grouping is by --channels

createProgram() in packages/cli/src/cli/bootstrap.ts registers none of those at the top level. Lifecycle lives under agent-relay node …, messaging under agent-relay message …, and the old flat surface survives only as a hidden, deprecated local alias that prints a removal warning.

Rather than re-document what orchestrating-agent-relay already covers correctly, this reduces the skill to what is genuinely OpenClaw-specific — the @agent-relay/openclaw setup, openclaw system event completion reporting, provider quirks — and defers everything else to that skill. It names the removed commands explicitly, so an agent that has them in context from an older copy discards them rather than trusting them.

Alternative worth considering: delete the skill outright. Its unique content is now about 30 lines, and everything else duplicates orchestrating-agent-relay. I kept it because it's a published package (@agent-relay/openclaw-orchestrator) and removing one is your call, not mine.

Also fixed

  • Frontmatter name mismatch. name: was agent-relay-orchestrator while the directory and published package are openclaw-orchestrator, so the installed skill registered under a name nothing else referenced. Also drops the non-contract version: / homepage: / metadata: keys.
  • /spawn used the same removed commands, told the user to supply a workspace key that node up auto-creates, and pointed monitoring at agents:logs. Retargeted; it now also offers an observer link and warns against reading replies with node tail.
  • /create-workflow referenced agent-relay agents.
  • Version bumps in prpm.json + README: openclaw-orchestrator 1.0.0 → 2.0.0 (rewrite), /spawn 1.0.0 → 1.1.0, /create-workflow 1.0.4 → 1.0.5.

Part of a series from a review of the Agent Relay skills and plugins.

Test Plan

  • Built the current CLI and verified every command in the rewritten files resolves: node agent spawn, node agent list, node agent attach, node agent release, node status, node up, message inbox check, observer — all return help, none error
  • Confirmed via node agent spawn --help that the flags are --name / --channels / --task / --model and that no --team flag exists
  • Confirmed via agent-relay --help that the top-level surface has no up, spawn, agents, send, or down
  • prpm.json parses as valid JSON after the version bumps
  • Grepped the repo for remaining removed-surface commands — only hit left is the intentional "these were removed" warning in the rewritten skill
  • Tests added/updated — n/a, this repo has no test tooling (no root package.json, no CI workflows)

Screenshots

n/a


Generated by Claude Code

Review in cubic

@coderabbitai

coderabbitai Bot commented Aug 3, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@willwashburn, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 58 minutes

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

Wait for the limit to reset, then comment @coderabbitai review or push new commits to the PR.

An organization admin can change what happens after included review limits in Billing.

How do review limits work?

CodeRabbit enforces per-developer PR review limits within each organization.

For paid Pro and Pro+ reviews, CodeRabbit uses a developer's included PR review attempts over the past 7 days to set the current hourly allowance. At typical activity levels, the full plan allowance applies. Higher sustained activity can lower the allowance until earlier attempts leave the 7-day window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 39bae81d-8cf3-4966-86df-3c66ca66ce7e

📥 Commits

Reviewing files that changed from the base of the PR and between d40c284 and 287c6e8.

📒 Files selected for processing (10)
  • README.md
  • commands/create-workflow.md
  • commands/spawn.md
  • plugins/claude-relay-plugin/agents/relay-worker/agent.md
  • plugins/claude-relay-plugin/hooks/subagent-bootstrap.sh
  • plugins/claude-relay-plugin/skills/relay-fanout/SKILL.md
  • plugins/claude-relay-plugin/skills/relay-pipeline/SKILL.md
  • plugins/claude-relay-plugin/skills/relay-team/SKILL.md
  • prpm.json
  • skills/openclaw-orchestrator/SKILL.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: aec62d675f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread plugins/claude-relay-plugin/skills/relay-team/SKILL.md

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

All reported issues were addressed across 10 files

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread plugins/claude-relay-plugin/hooks/subagent-bootstrap.sh
Comment thread plugins/claude-relay-plugin/skills/relay-team/SKILL.md
Comment thread plugins/claude-relay-plugin/skills/relay-fanout/SKILL.md
Comment thread plugins/claude-relay-plugin/agents/relay-worker/agent.md
claude added 2 commits August 20, 2026 11:12
…tokens

The three pattern skills each mandated printing the raw workspace key in
an observer URL — "Do not print a placeholder — print the real URL the
user can click. This is mandatory." A workspace key is an administrative
credential; a URL query string is the worst place to put one.

They also required the key be copied into every worker prompt. That is
unnecessary: `create_workspace` and `set_workspace_key` both pin the
workspace to the project, and the relay MCP server a `relay-worker`
subagent starts resolves that pin on its own. The mandate put an admin
credential into N prompts and N transcripts to achieve nothing.

- Step 3 now calls `get_observer_url`, which mints a scoped, expiring,
  read-only token. Requires the tool added in AgentWorkforce/relay#1422.
- Worker prompts no longer carry the workspace key; the worker agent
  definition and SubagentStart hook now say the workspace is inherited
  and that a key must never be printed or requested.
- The three skills' shared setup steps are now byte-identical, and all
  three carry the worker/stage tracking table and the "do not
  self-release" instruction that only relay-team had.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jmke9G9s7ftrN49opNmdx1
… CLI

`openclaw-orchestrator` documented Agent Relay's removed flat command
surface almost end to end: `agent-relay up`, `spawn`, `agents`,
`agents:logs`, `agents:kill`, `send`, `inbox`, `down`, plus
`mcporter call relaycast ...` for channels and messaging. None of those
are registered at the top level any more — `createProgram()` puts
lifecycle under `agent-relay node ...` and messaging under
`agent-relay message ...`, with the old flat group surviving only as a
hidden, deprecated `local` alias. It also documented a `--team` flag that
`node agent spawn` does not have; grouping is by `--channels`.

Rather than re-document what `orchestrating-agent-relay` already covers
correctly, this reduces the skill to what is actually OpenClaw-specific
(the `@agent-relay/openclaw` setup, `openclaw system event` completion
reporting, provider quirks) and defers everything else to that skill. It
also names the removed commands explicitly so an agent carrying them in
context discards them.

Other fixes:
- Frontmatter `name:` was `agent-relay-orchestrator` while the published
  package and directory are `openclaw-orchestrator`, so the installed
  skill registered under a name nothing referenced. Also drops the
  non-contract `version:`/`homepage:`/`metadata:` keys.
- `/spawn` used the same removed commands, told the user to supply a
  workspace key that `node up` auto-creates, and pointed monitoring at
  `agents:logs`. Retargeted, and it now offers an observer link.
- `/create-workflow` referenced `agent-relay agents`.

Every command in the rewritten files was checked against `--help` on a
build of the current CLI.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jmke9G9s7ftrN49opNmdx1
@willwashburn
willwashburn force-pushed the claude/agent-relay-skills-review-a8mgtd-stale-cli branch from aec62d6 to 287c6e8 Compare August 20, 2026 11:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants