Add spawn-cloud-swarm skill

[kjgbot]

Summary

• add the standalone spawn-cloud-swarm skill under skills/spawn-cloud-swarm
• register it in prpm.json and README
• document the install-ahead requirement instead of relying on relay auto-install
• incorporate review feedback: MCP tool preflight first, relaycast conflictCount status contract, per-worker quota retry wording

Validation

• node -e "JSON.parse(require('fs').readFileSync('prpm.json','utf8'))"
• custom manifest/content check for spawn-cloud-swarm package files and required remediation tokens
• prpm validate is not available in prpm 2.1.38

Merge order

1. Add cloud local mount MCP tools relaycast#135
2. this PR
3. feat(skill): spawn-cloud-swarm skill + connect-claude installer (PR 7b relay-side) relay#866

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: e8b67753-04ed-4afc-8995-6bd6e3e0a558

📥 Commits

Reviewing files that changed from the base of the PR and between ce092ce and b619fe7.

📒 Files selected for processing (3)

• README.md
• prpm.json
• skills/spawn-cloud-swarm/SKILL.md

---

📝 Walkthrough

Walkthrough

This PR adds a new spawn-cloud-swarm skill to the agent workforce skills repository. The version is bumped from 1.1.0 to 1.1.1 in the package manifest. The new skill documentation describes orchestrating cloud agent swarms using shared relayfile workspaces with MCP-based local-mount tooling, prerequisites validation, retry logic, and explicit boundary limitations.

Changes

Spawn Cloud Swarm Skill Addition

Layer / File(s)	Summary
Package manifest and registry updates prpm.json, README.md	The package manifest version is bumped to 1.1.1 and the new spawn-cloud-swarm skill package entry (v1.0.0) is added with description and tags. The README version is updated and the skill is added to the published skills list.
Spawn Cloud Swarm skill documentation skills/spawn-cloud-swarm/SKILL.md	Complete skill guide defining when to use the skill, installation and prerequisites (including MCP tool presence and config file validation), the end-to-end orchestration procedure (mount setup, agent spawning with retry/backoff on quota limits, health polling, lifecycle teardown), error code mappings with remediation steps, and explicit boundary limitations clarifying scope.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A new swarm skill has spawned today,
Cloud workers dancing their relay way,
With mounts and quotas held just right,
The clouds shall swirl in workforce flight! ☁️✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The pull request title 'Add spawn-cloud-swarm skill' directly and clearly describes the main change: adding a new skill called spawn-cloud-swarm to the codebase.
Description check	✅ Passed	The pull request description is directly related to the changeset, providing clear context about adding the spawn-cloud-swarm skill, registration in prpm.json and README, documentation requirements, and review feedback incorporated.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
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 feat/spawn-cloud-swarm-skill

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

Devin Review found 1 potential issue.

View 2 additional findings in Devin Review.

[devin-ai-integration]

🟡 Prereq 1 claims to verify "every tool this skill drives" but only checks 3 of 5 tools

Prereq 1 opens with "The relaycast MCP surface exposes every tool this skill drives" then only verifies cloud.local-mount.ensure, cloud.local-mount.status, and cloud.local-mount.stop. However, the Boundaries section (skills/spawn-cloud-swarm/SKILL.md:126-128) confirms the skill also drives cloud.agent.spawn (step 2) and cloud.agent.list (step 3). If either agent tool is missing from the MCP surface, the prereq check passes, the mount gets started in step 1, and the skill then fails at step 2 with no structured error code or verbatim remediation — leaving the user with an active mount but a broken spawn flow.

Suggested change

	1. The relaycast MCP surface exposes every tool this skill drives. Confirm
	`cloud.local-mount.ensure`, `cloud.local-mount.status`, and
	`cloud.local-mount.stop` are all registered on the MCP client. If any are
	missing, surface `MCP_LOCAL_MOUNT_TOOLS_MISSING` and the verbatim
	remediation: "Upgrade `@relaycast/mcp` to a build that includes
	`cloud.local-mount.*` (see relaycast PR `feat/cloud-local-mount-tools`)."
	Then stop.
	1. The relaycast MCP surface exposes every tool this skill drives. Confirm
	`cloud.local-mount.ensure`, `cloud.local-mount.status`,
	`cloud.local-mount.stop`, `cloud.agent.spawn`, and `cloud.agent.list`
	are all registered on the MCP client. If any are
	missing, surface `MCP_LOCAL_MOUNT_TOOLS_MISSING` and the verbatim
	remediation: "Upgrade `@relaycast/mcp` to a build that includes
	`cloud.local-mount.*` (see relaycast PR `feat/cloud-local-mount-tools`)."
	Then stop.

---

Was this helpful? React with 👍 or 👎 to provide feedback.