Skip to content

Docs: refresh Agent Relay skill handoff#1087

Merged
willwashburn merged 3 commits into
mainfrom
docs/agent-relay-skill-handoff
Jun 10, 2026
Merged

Docs: refresh Agent Relay skill handoff#1087
willwashburn merged 3 commits into
mainfrom
docs/agent-relay-skill-handoff

Conversation

@willwashburn

Copy link
Copy Markdown
Member

Summary

  • add /skill as the default hosted Agent Relay handoff for orchestrators and participants
  • surface the handoff prominently in the README and homepage CTA/quick-start callout
  • refresh Relay skill docs for current flat MCP tools, current local CLI forms, and @relayflows/core workflow imports

Verification

  • git diff --check
  • npm test (web)
  • npm run build (web)
  • Playwright smoke check against http://localhost:3009 for /skill and homepage links

No changelog entry: docs and website skill handoff only.

@willwashburn willwashburn requested a review from khaliqgant as a code owner June 10, 2026 22:10
@gemini-code-assist

Copy link
Copy Markdown

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@coderabbitai

coderabbitai Bot commented Jun 10, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d7130636-ed1d-498b-bbbc-16637bfb83b1

📥 Commits

Reviewing files that changed from the base of the PR and between 8df1d78 and cb58c68.

📒 Files selected for processing (1)
  • README.md

📝 Walkthrough

Walkthrough

This PR modernizes Agent Relay skill documentation to align with @relayflows/core package APIs, refactors the SkillPage component into a reusable architecture, separates skill markdown readers for Agent Relay and OpenClaw, launches a new /skill landing page with comprehensive metadata and SEO infrastructure, and enhances landing page navigation and styling to promote the Agent Relay skill.

Changes

Agent Relay Documentation Alignment with @relayflows/core

Layer / File(s) Summary
Swarm patterns documentation
.agents/skills/choosing-swarm-patterns/SKILL.md, .claude/skills/choosing-swarm-patterns/SKILL.md
Both skill files are updated to reference @relayflows/core, document single-field swarm.pattern configuration, correct MCP tool names to canonical flat forms (send_dm instead of message_dm_send), clarify verification/completion signals, and refresh Source of Truth references to @relayflows/core/dist/* paths.
Workflow templates and execution semantics
.agents/skills/relay-80-100-workflow/SKILL.md, .agents/skills/writing-agent-relay-workflows/SKILL.md, .claude/skills/relay-80-100-workflow/SKILL.md, .claude/skills/writing-agent-relay-workflows/SKILL.md
Workflow imports switch from @agent-relay/sdk to @relayflows/core. Documentation clarifies that agent-relay local run executes files as subprocesses. Wave-planning parallelism examples updated. PR-opening guidance replaces createGitHubStep with deterministic git + gh steps and pr_url verification.
Participant guides
.agents/skills/using-agent-relay/SKILL.md, .claude/skills/using-agent-relay/SKILL.md
Both files extensively rewritten to document canonical flat MCP tool names (workspace/identity, channels, messages, reactions/actions/workers), structured startup protocol (register, join channels, check inbox, send ACK), communication protocol (concise status messaging, DM vs post routing), worker management (add_agent/remove_agent), current CLI reference with environment variables, and correct responsibilities for registered participants vs orchestrators.
Supporting skill updates
plugins/codex-relay-skill/SKILL.md, README.md, web/content/openclaw/SKILL.md
Codex relay skill rebranded from Relaycast to Agent Relay; worker patterns section restructured. README adds agent team onboarding guidance. OpenClaw skill content updated for relaycast.register_agent command.

Web UI Skill Page Refactoring and New Route Launch

Layer / File(s) Summary
SkillPage component and markdown readers
web/components/SkillPage.tsx, web/lib/skill-markdown.ts
SkillPage refactored to accept SkillPageProps (eyebrow, title, lead, markdown) instead of hard-coded content. Markdown readers split into readAgentRelaySkillMarkdown() and readOpenClawSkillMarkdown(), replacing unified readSkillMarkdown().
OpenClaw skill pages updated
web/app/openclaw/skill/page.tsx, web/app/openclaw/skill/invite/[token]/page.tsx
Both pages refactored to use readOpenClawSkillMarkdown() and explicitly pass title/lead props to generalized SkillPage component.
New Agent Relay skill page
web/app/skill/page.tsx
New statically rendered page (dynamic = 'force-static', revalidate = 86400) replaces prior OpenClaw redirect. Full metadata with canonical /skill URL, OpenGraph/Twitter properties. Renders SkillPage with Agent Relay-specific title/lead and readAgentRelaySkillMarkdown() content.
Landing page navigation and styling
web/components/home/Hero.tsx, web/components/home/QuickStart.tsx, web/app/landing.module.css
Hero adds secondary CTA to /skill. QuickStart adds "Hand this to an agent" callout with link. CSS module introduces .skillCallout flex styling with responsive overrides at 960px (vertical stack) and 600px (padding).
SEO and analytics infrastructure
web/app/robots.ts, web/app/sitemap.ts, web/lib/site-analytics.ts, web/lib/test/site-analytics.test.ts, web/lib/test/skill-markdown.test.ts
robots.ts adds /skill to allowed paths. sitemap.ts adds /skill with weekly frequency and 0.9 priority. site-analytics.ts reclassifies /skill from openclaw to skill page group. Tests added for analytics tracking and markdown bundling.
Agent Relay team onboarding skill
web/content/agent-relay/SKILL.md
New skill document providing hosted handoff URL, role selection guidance (orchestrator vs participant), quick-start CLI steps, copy-ready lead and worker prompts, common failure mode remediation, and canonical links.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Suggested reviewers

  • khaliqgant

🐰 The skill docs leap forth with shiny new core,
While pages are split and refreshed evermore.
A /skill route blooms on the landing page,
Agent Relay orchestrates its stage!
Navigation flows bright, styling takes flight—
Now teams can coordinate left and right! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Docs: refresh Agent Relay skill handoff' clearly and specifically describes the main objective of this PR—refreshing documentation for the Agent Relay skill handoff.
Description check ✅ Passed The description follows the template with a comprehensive Summary section, includes test/verification steps, and clearly outlines what was changed and why.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/agent-relay-skill-handoff

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 and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
.claude/skills/writing-agent-relay-workflows/SKILL.md (1)

1060-1066: ⚠️ Potential issue | 🟠 Major

Fix/implement missing pr_url verification type support in the runner

  • pr_url is mentioned only in .claude/skills/writing-agent-relay-workflows/SKILL.md/CHANGELOG.md, but repo code contains no verification.type: "pr_url" handling.
  • The SDK verification type union does not include it: packages/sdk-py/src/agent_relay/types.py defines Literal["output_contains", "exit_code", "file_exists", "custom"].
  • Broker-side “delivery verification” logic is echo-string based (crates/broker/src/broker/delivery_verification.rs) and does not validate PR URLs.

Either add real pr_url verification support to the workflow runner (including the documented value semantics) or remove it from the docs to avoid false “auto-pass” completion.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.claude/skills/writing-agent-relay-workflows/SKILL.md around lines 1060 -
1066, The docs advertise a verification type "pr_url" but the codebase lacks
support; update the SDK type union in packages/sdk-py/src/agent_relay/types.py
to include Literal["pr_url"] (and the associated Pydantic model field
`verification`/`value` semantics), implement broker-side validation in
crates/broker/src/broker/delivery_verification.rs to recognize "pr_url" and
verify output contains a valid GitHub PR URL and optional owner/repo match
(enforce the documented `<owner>/<repo>` behaviour), and wire the runner/adapter
that emits verification results so a deterministic PR-step prints the URL and is
validated; if you prefer removing the feature, instead remove `pr_url` from
SKILL.md/CHANGELOG.md and from the SDK union so docs and code stay consistent.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Outside diff comments:
In @.claude/skills/writing-agent-relay-workflows/SKILL.md:
- Around line 1060-1066: The docs advertise a verification type "pr_url" but the
codebase lacks support; update the SDK type union in
packages/sdk-py/src/agent_relay/types.py to include Literal["pr_url"] (and the
associated Pydantic model field `verification`/`value` semantics), implement
broker-side validation in crates/broker/src/broker/delivery_verification.rs to
recognize "pr_url" and verify output contains a valid GitHub PR URL and optional
owner/repo match (enforce the documented `<owner>/<repo>` behaviour), and wire
the runner/adapter that emits verification results so a deterministic PR-step
prints the URL and is validated; if you prefer removing the feature, instead
remove `pr_url` from SKILL.md/CHANGELOG.md and from the SDK union so docs and
code stay consistent.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: c9ebbde9-272f-4b25-9872-49b2cf0c94b0

📥 Commits

Reviewing files that changed from the base of the PR and between 040da37 and 8df1d78.

📒 Files selected for processing (25)
  • .agents/skills/choosing-swarm-patterns/SKILL.md
  • .agents/skills/relay-80-100-workflow/SKILL.md
  • .agents/skills/using-agent-relay/SKILL.md
  • .agents/skills/writing-agent-relay-workflows/SKILL.md
  • .claude/skills/choosing-swarm-patterns/SKILL.md
  • .claude/skills/relay-80-100-workflow/SKILL.md
  • .claude/skills/using-agent-relay/SKILL.md
  • .claude/skills/writing-agent-relay-workflows/SKILL.md
  • README.md
  • plugins/codex-relay-skill/SKILL.md
  • web/app/landing.module.css
  • web/app/openclaw/skill/invite/[token]/page.tsx
  • web/app/openclaw/skill/page.tsx
  • web/app/robots.ts
  • web/app/sitemap.ts
  • web/app/skill/page.tsx
  • web/components/SkillPage.tsx
  • web/components/home/Hero.tsx
  • web/components/home/QuickStart.tsx
  • web/content/agent-relay/SKILL.md
  • web/content/openclaw/SKILL.md
  • web/lib/site-analytics.ts
  • web/lib/skill-markdown.ts
  • web/lib/test/site-analytics.test.ts
  • web/lib/test/skill-markdown.test.ts

Added quick test and integration instructions for agents.
@willwashburn willwashburn merged commit 2c174d7 into main Jun 10, 2026
37 of 39 checks passed
@willwashburn willwashburn deleted the docs/agent-relay-skill-handoff branch June 10, 2026 22:51
@github-actions

Copy link
Copy Markdown
Contributor

Preview deployed!

Environment URL
Web https://dpc7gh9yx4yc1.cloudfront.net

This preview will be cleaned up when the PR is merged or closed.

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.

1 participant