cross-machine-coordination

Coordinates distributed agent task execution across machines via git-based task queuing.

2|Updated Jul 24, 2026
One-click install
npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill cross-machine-coordination-elbruno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-machine-coordination
Source: https://github.com/elbruno/ElBruno.MagenticUI/tree/main/.squad/templates/skills/cross-machine-coordination
Command: npx skills add https://github.com/elbruno/ElBruno.MagenticUI --skill cross-machine-coordination-elbruno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents running on different machines (laptop, DevBox, Azure VM) cannot easily share work or pass results without manual copy-paste handoffs. This Skill defines a git-based task queuing pattern so agents on separate machines can assign, execute, and return results automatically. ## Core Features & Use Cases - Git-Based Task Queue: Tasks are YAML files committed to .squad/cross-machine/tasks/ and results written to .squad/cross-machine/results/, giving an immutable audit trail through git history. - GitHub Issues Fallback: Urgent or ad-hoc tasks can be submitted as issues with squad:machine-{name} labels, which the target machine's agent detects and executes. - Security Validation Pipeline: Every task passes schema validation, command whitelisting, resource limits (timeout, memory, CPU), and execution isolation before running. - Use Case: A laptop agent needs a GPU workload (e.g., voice cloning) run on a DevBox. It writes a task YAML file, commits and pushes; the DevBox agent picks it up on its next 5-10 minute watch cycle, executes it, and pushes back a result file with exit code, stdout, and artifacts. ## Quick Start Create a YAML task file in .squad/cross-machine/tasks/ targeting the desired machine, then commit and push it so the remote agent executes it automatically.

Frequently Asked Questions about cross-machine-coordination

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I assign a task to an agent on another machine?

Create a YAML task file in .squad/cross-machine/tasks/ with the target_machine field set to the remote hostname, then commit and push to the shared git repository. The remote agent picks it up on its next watch cycle, typically every 5-10 minutes.

How do I submit an urgent task without writing a YAML file?

Create a GitHub issue with the label squad:machine-{name} matching the target machine. The agent on that machine detects the labeled issue, parses the task from the body, executes it, and comments with the result.

What security controls prevent malicious task execution?

Tasks pass through schema validation, a command whitelist, path validation, and resource limits on timeout, memory, and CPU. Execution runs as an unprivileged user, and all activity is logged immutably in git history.

What happens when a cross-machine task fails or times out?

Failed tasks produce a result file with status failed, the exit code, and captured stderr. Timed-out tasks are killed and marked status timeout; the source machine can retry by re-pushing the task with status pending.

Does cross-machine coordination work when the network is down?

Yes, tasks queue locally in the git repository when push or pull fails. The agent retries on the next cycle, and no tasks are lost since they are stored in the local repo until connectivity is restored.