Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
Enables squad agents on different machines to share work via git-based task queuing
$ npx skills add bradygaster/squad --skill cross-machine-coordination -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install bradygaster/squad cross-machine-coordination --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.squad-templates/skills/cross-machine-coordination .claude/skills/cross-machine-coordination && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cross-machine-coordination" agent skill from https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordination into .claude/skills/cross-machine-coordination/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cross-machine-coordination", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordinationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add bradygaster/squad --skill cross-machine-coordination -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install bradygaster/squad cross-machine-coordination --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.squad-templates/skills/cross-machine-coordination .agents/skills/cross-machine-coordination && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cross-machine-coordination" agent skill from https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordination into .agents/skills/cross-machine-coordination/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cross-machine-coordination", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bradygaster/squad --skill cross-machine-coordination -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install bradygaster/squad cross-machine-coordination --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.squad-templates/skills/cross-machine-coordination .cursor/skills/cross-machine-coordination && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cross-machine-coordination" agent skill from https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordination into .cursor/skills/cross-machine-coordination/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cross-machine-coordination", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/bradygaster/squad.git --path .squad-templates/skills/cross-machine-coordination--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add bradygaster/squad --skill cross-machine-coordination -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install bradygaster/squad cross-machine-coordination --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.squad-templates/skills/cross-machine-coordination .gemini/skills/cross-machine-coordination && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cross-machine-coordination" agent skill from https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordination into .gemini/skills/cross-machine-coordination/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cross-machine-coordination", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install bradygaster/squad cross-machine-coordinationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add bradygaster/squad --skill cross-machine-coordination -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .github/skills && cp -r skills-src/.squad-templates/skills/cross-machine-coordination .github/skills/cross-machine-coordination && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cross-machine-coordination" agent skill from https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordination into .github/skills/cross-machine-coordination/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cross-machine-coordination", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add bradygaster/squad --skill cross-machine-coordination -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install bradygaster/squad cross-machine-coordination --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/bradygaster/squad.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.squad-templates/skills/cross-machine-coordination .opencode/skills/cross-machine-coordination && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cross-machine-coordination" agent skill from https://github.com/bradygaster/squad/tree/dev/.squad-templates/skills/cross-machine-coordination into .opencode/skills/cross-machine-coordination/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cross-machine-coordination", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
cross-machine-coordinationEnables squad agents on different machines to share work via git-based task queuing
Cross Machine Coordination is an agent skill from bradygaster/squad. Enables squad agents on different machines to share work via git-based task queuing
Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Development. It works with Git. The repository describes itself as: Squad: AI agent teams for any project. The licence is MIT.
5 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 1fd7e03. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
gitghFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Cross Machine Coordination loads about 2.7k tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 611 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from bradygaster/squad at commit 1fd7e03, republished under its MIT licence (© bradygaster). 611 words, ~2,707 tokens.
.claude/skills/cross-machine-coordination/SKILL.md (or your agent's skills folder).Skill ID: cross-machine-coordination
Owner: Ralph (Work Monitor)
Squad Integration: All agents
Status: Specification (ready for implementation)
Enables squad agents running on different machines (laptop, DevBox, Azure VM) to securely share work, coordinate execution, and pass results without manual intervention.
Pattern: Git-based task queuing + GitHub Issues supplement
To assign work to DevBox:
# Create task file
cat > .squad/cross-machine/tasks/2026-03-14T1530Z-laptop-gpu-voice-clone.yaml << 'EOF'
id: gpu-voice-clone-001
source_machine: laptop-machine
target_machine: devbox
priority: high
created_at: 2026-03-14T15:30:00Z
task_type: gpu_workload
payload:
command: "python scripts/voice-clone.py --input voice.wav --output cloned.wav"
expected_duration_min: 15
resources:
gpu: true
memory_gb: 8
status: pending
EOF
# Commit & push
git add .squad/cross-machine/tasks/
git commit -m "Cross-machine task: GPU voice cloning [squad:machine-devbox]"
git push origin mainRalph on DevBox will:
.squad/cross-machine/results/gpu-voice-clone-001.yamlRalph automatically watches .squad/cross-machine/tasks/ for work targeted at this machine.
On each cycle (5-10 min):
# Pseudo-code (Ralph implementation)
1. git pull origin main
2. Load all .yaml files in .squad/cross-machine/tasks/
3. Filter for status=pending AND target_machine=HOSTNAME
4. For each task:
a. Validate schema (must have: id, source_machine, target_machine, payload)
b. Validate command against whitelist
c. Execute task (with timeout)
d. Write result to .squad/cross-machine/results/{id}.yaml
e. Commit & push resultUse GitHub Issues with squad:machine-{name} label:
# Create issue
gh issue create \
--title "GPU: Clone voice profile from sample.wav" \
--body "Execute voice cloning on DevBox. Input: /path/to/voice-input.wav" \
--label "squad:machine-devbox" \
--label "urgent"Ralph on DevBox will:
squad:machine-devbox labelLocation: .squad/cross-machine/tasks/{timestamp}-{machine}-{task-id}.yaml
Required Fields:
id: {task-id} # Unique identifier (alphanumeric + dash)
source_machine: {hostname} # Where task was created
target_machine: {hostname} # Where task will execute
priority: high|normal|low # Execution priority
created_at: 2026-03-14T15:30:00Z # ISO 8601 timestamp
task_type: gpu_workload|script|... # Category
payload:
command: "..." # Shell command to execute
expected_duration_min: 15 # Timeout (minutes)
resources:
gpu: true|false
memory_gb: 8
cpu_cores: 4
status: pending|executing|completed|failedOptional Fields:
description: "Human-readable task description"
timeout_override_min: 120 # Override default timeout
retry_count: 3 # Retry failed tasksLocation: .squad/cross-machine/results/{task-id}.yaml
id: {task-id} # Links back to task
target_machine: devbox # Executed on
completed_at: 2026-03-14T15:45:00Z # When it finished
status: completed|failed|timeout # Outcome
exit_code: 0 # Shell exit code
stdout: "..." # Captured output
stderr: "..." # Captured errors
duration_seconds: 900 # How long it took
artifacts:
- path: "/path/to/artifacts/..." # Location of results
type: audio|text|model|...
size_mb: 2.5All tasks go through:
Schema Validation
Command Whitelist
../../ escapes)&&, |, >)Resource Limits
Execution Isolation
Audit Trail
| Threat | Mitigation |
|---|---|
| Malicious task injection | Branch protection + PR review before merge |
| Credential leakage | Pre-commit secret scan + environment scrubbing |
| Resource exhaustion | Timeout + memory limits |
| Code injection | Command whitelist + no shell evaluation |
| Result tampering | Git commit history is immutable |
Ralph reads config from .squad/config.json:
{
"cross_machine": {
"enabled": true,
"poll_interval_seconds": 300,
"this_machine": "devbox",
"max_concurrent_tasks": 2,
"task_timeout_minutes": 60,
"command_whitelist": [
"python scripts/voice-clone.py",
"python scripts/data-process.py",
"bash scripts/cleanup.sh"
],
"result_ttl_days": 30
}
}1. Laptop creates task:
# .squad/cross-machine/tasks/2026-03-14T1530Z-laptop-gpu-001.yaml
id: gpu-voice-clone-001
source_machine: laptop-machine
target_machine: devbox
priority: high
created_at: 2026-03-14T15:30:00Z
task_type: gpu_workload
payload:
command: "python scripts/voice-clone.py --input voice.wav --output cloned.wav"
expected_duration_min: 15
resources:
gpu: true
memory_gb: 8
status: pending2. Laptop commits & pushes:
git add .squad/cross-machine/tasks/
git commit -m "Task: GPU voice cloning [squad:machine-devbox]"
git push origin main3. DevBox Ralph (5 min later):
[Ralph Watch Cycle]
- Pulled origin/main
- Detected: gpu-voice-clone-001 (status: pending, target: devbox)
- Validation: ✅ Schema OK, command whitelisted
- Executing: python scripts/voice-clone.py ...
- [15 minutes of processing]
- Completed: exit code 0
- Writing result...
- Committing & pushing...4. Laptop Ralph (next cycle) sees result:
# .squad/cross-machine/results/gpu-voice-clone-001.yaml
id: gpu-voice-clone-001
target_machine: devbox
completed_at: 2026-03-14T15:45:00Z
status: completed
exit_code: 0
stdout: "Voice cloning completed. Output written to /tmp/cloned.wav"
stderr: ""
duration_seconds: 900
artifacts:
- path: "/path/to/artifacts/voice-clone-001/output.wav"
type: audio
size_mb: 2.5Create issue:
gh issue create \
--title "DevBox: Debug voice model failure" \
--body "Error: Model failed to load on last run. Please check /tmp/model.log and report findings." \
--label "squad:machine-devbox" \
--label "urgent"DevBox Ralph detects → executes → comments:
✅ Executed on devbox at 2026-03-14 15:47:00
Command: python scripts/debug-model.py
Result:
------
Model file: /tmp/model-v2.bin (OK)
Checksum: a1b2c3d4e5f6 (matches expected)
Memory available: 12 GB (sufficient)
ERROR FOUND: Config file permission issue
- File: ~/.config/voice/model.yaml
- Permissions: -rw------- (owner-only)
- Expected: -rw-r--r-- (world-readable for service)
FIX: Run: chmod 644 ~/.config/voice/model.yamlIf a task fails (exit code != 0):
status: failed + exit codestatus: pendingIf a task doesn't complete within timeout:
status: timeoutIf git push/pull fails:
ls -la .squad/cross-machine/tasks/
cat .squad/cross-machine/tasks/*.yaml | grep -E "^(id|status|target_machine):"ls -la .squad/cross-machine/results/
cat .squad/cross-machine/results/{task-id}.yamlgit log --oneline .squad/cross-machine/ | head -20tail -f .squad/log/ralph-watch.log | grep "cross-machine"Ralph automatically includes this pattern in its watch loop:
Ralph Watch Cycle (every 5-10 min):
1. Fetch GitHub issues with squad:machine-* labels
2. Poll .squad/cross-machine/tasks/
3. For each matching task:
- Validate
- Execute
- Write result
- Commit & push
4. Update status in issue (if applicable)
5. Sleep until next cycleNo manual Ralph configuration needed — just create task files or issues with the right labels.
Before (today):
After (with this pattern):
Potential expansions (Phase 2+):
Refer to research report: research/active/cross-machine-agents/README.md
Contact: the research and documentation owner or Ralph (Work Monitor)
© bradygaster, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .squad-templates/skills/cross-machine-coordination of bradygaster/squad.
Open the folder on GitHubat commit 1fd7e03
Cross Machine Coordination next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Cross Machine Coordination this skillbradygaster/squad | 3.3k | — | ~2.7k | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 296k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 5 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Codebase Knowledge Graph Q&AEgonex-AI/Understand-Anything | 86k | 1 repos | ~1.2k | Automated safety check: Pass | MIT | |
| Code Design Rationale Investigatorcursor/plugins | 10k | 9 repos | ~2.6k | Automated safety check: Pass | None | |
| Understand Diff AnalysisEgonex-AI/Understand-Anything | 86k | 1 repos | ~1.4k | Automated safety check: Pass | MIT |
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
Egonex-AI/Understand-Anything
Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.
cursor/plugins
Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.
Egonex-AI/Understand-Anything
Reads your git changes or a pull request against a prebuilt knowledge graph of the project to explain what changed, which components are affected and what is risky.
Egonex-AI/Understand-Anything
Gives an in-depth explanation of one file, function or module by reading the project's knowledge graph and checking that the graph is still fresh.
bradygaster/squad
Review and validate claims using counter-hypothesis testing.
bradygaster/squad
How to review PRs for architectural quality — module boundaries, dependency direction, export surface, pattern consistency
bradygaster/squad
Preserve content when moving entries between tracked Squad state files
bradygaster/squad
Defensive CI/CD patterns: semver validation, token checks, retry logic, and draft detection
bradygaster/squad
Checklist and patterns for wiring new CLI commands into cli-entry.ts
bradygaster/squad
Validate GitHub Agentic Workflow contracts through compiled artifacts and realistic mutations
Works with
Categories
Enables squad agents on different machines to share work via git-based task queuing. Cross Machine Coordination is an agent skill from bradygaster/squad.
Cross Machine Coordination fits situations like: development work in your project.
Run `npx skills add bradygaster/squad --skill cross-machine-coordination -a claude-code`. Or copy the skill folder (.squad-templates/skills/cross-machine-coordination in bradygaster/squad) into .claude/skills/cross-machine-coordination in your project. Claude Code loads it when a task matches its description.
Run `npx skills add bradygaster/squad --skill cross-machine-coordination -a codex`. Or copy the skill folder (.squad-templates/skills/cross-machine-coordination in bradygaster/squad) into .agents/skills/cross-machine-coordination in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bradygaster/squad --skill cross-machine-coordination -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cross-machine-coordination, .gemini/skills/cross-machine-coordination, .github/skills/cross-machine-coordination and .opencode/skills/cross-machine-coordination in your project.
Going by SKILL.md and its folder, Cross Machine Coordination needs the command-line tools its instructions call (git and gh). Our summary lists: Python 3.
SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Cross Machine Coordination is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Cross Machine Coordination: Finishing a Development Branch (obra/superpowers, 296k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Codebase Knowledge Graph Q&A (Egonex-AI/Understand-Anything, 86k stars) and Code Design Rationale Investigator (cursor/plugins, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
bradygaster (a GitHub user) maintains it in bradygaster/squad, which has 3,257 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 8, 2026.
Source: bradygaster/squad on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.