How do I install the Remote Compilation Helper Setup skill?

Run npx skillmds@latest add dicklesworthstone/remote-compilation-helper-setup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Remote Compilation Helper Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Remote Compilation Helper Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Remote Compilation Helper Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Remote Compilation Helper Setup?

dicklesworthstone (@dicklesworthstone) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Remote Compilation Helper Setup by dicklesworthstone

Name: Remote Compilation Helper Setup
Author: dicklesworthstone

Remote Compilation Helper Setup

Configure RCH workers, install hooks, fix SSH/daemon issues. Use when setting up remote compilation, adding build machines, troubleshooting rch doctor, or "no workers available".

dicklesworthstone b5dec1a 6 files · 22.6 KB Updated Sep 17, 2026

File contents

RCH Setup

Offloads cargo build, bun test, gcc to remote workers. Transparent—same commands, faster builds.

Workflow

1. rch doctor           # What's broken?
2. rch doctor --fix     # Auto-fix common issues
3. rch doctor           # All green? Done.

If --fix can't solve it, continue below.

Setup Checklist

Prerequisites: which rustup rsync zstd (install missing)
Install: cargo install --path rch (or --path . from repo root)
Configure: Create ~/.config/rch/workers.toml (see below)
Hook: rch hook install
Daemon: rch daemon start (or systemctl --user start rchd)
Validate: rch doctor → all checks pass, then rch self-test

Worker Config

# ~/.config/rch/workers.toml
[[workers]]
id = "worker1"
host = "192.168.1.100"
user = "ubuntu"
identity_file = "~/.ssh/id_ed25519"
total_slots = 8    # ≈ CPU cores - 2
priority = 100     # Higher = preferred
tags = ["rust"]    # Optional capability tags

Discover from SSH config:

rch workers discover --from-ssh-config --dry-run  # Preview
rch workers discover --from-ssh-config            # Add to config

Verify workers:

rch workers probe worker1 --verbose  # Test single
rch workers probe --all              # Test all
rch workers capabilities             # Show detected toolchains/targets

Quick Fixes

Symptom	Fix
SSH fails	`eval $(ssh-agent) && ssh-add ~/.ssh/your_key`
Daemon down / stale socket	`rch daemon restart` — never `rm` the socket by hand
Hook missing	`rch hook install` (`--force` only after `rch hook status`)
No workers	`rch status --fleet` + `rch admit "cargo build"` — find the real cause; do not edit `workers.toml` for transient illness

Test the hook:

rch hook test

Validation

rch doctor --verbose   # Full diagnostics
rch doctor --json      # Machine-readable
rch diagnose "cargo check" --dry-run  # Show the decision without remote execution

⚠️ All rch doctor checks must pass before use.

References

Topic	Reference
Worker schema, selection algorithm, tags	WORKERS.md
All error messages & detailed fixes	TROUBLESHOOTING.md
Hook protocol, 5-tier classification	HOOKS.md

---name: remote-compilation-helper-setupdescription: Configure RCH workers, install hooks, fix SSH/daemon issues. Use when setting up remote compilation, adding build machines, troubleshooting rch doctor, or "no workers available".---# RCH SetupOffloads `cargo build`, `bun test`, `gcc` to remote workers. Transparent—same commands, faster builds.## Workflow```1. rch doctor # What's broken?2. rch doctor --fix # Auto-fix common issues3. rch doctor # All green? Done.```If `--fix` can't solve it, continue below.## Setup Checklist- [ ] **Prerequisites**: `which rustup rsync zstd` (install missing)- [ ] **Install**: `cargo install --path rch` (or `--path .` from repo root)- [ ] **Configure**: Create `~/.config/rch/workers.toml` (see below)- [ ] **Hook**: `rch hook install`- [ ] **Daemon**: `rch daemon start` (or `systemctl --user start rchd`)- [ ] **Validate**: `rch doctor` → all checks pass, then `rch self-test`## Worker Config```toml# ~/.config/rch/workers.toml[[workers]]id = "worker1"host = "192.168.1.100"user = "ubuntu"identity_file = "~/.ssh/id_ed25519"total_slots = 8 # ≈ CPU cores - 2priority = 100 # Higher = preferredtags = ["rust"] # Optional capability tags```**Discover from SSH config**:```bashrch workers discover --from-ssh-config --dry-run # Previewrch workers discover --from-ssh-config # Add to config```**Verify workers**:```bashrch workers probe worker1 --verbose # Test singlerch workers probe --all # Test allrch workers capabilities # Show detected toolchains/targets```## Quick Fixes| Symptom | Fix ||---------|-----|| SSH fails | `eval $(ssh-agent) && ssh-add ~/.ssh/your_key` || Daemon down / stale socket | `rch daemon restart` — never `rm` the socket by hand || Hook missing | `rch hook install` (`--force` only after `rch hook status`) || No workers | `rch status --fleet` + `rch admit "cargo build"` — find the real cause; **do not** edit `workers.toml` for transient illness |**Test the hook**:```bashrch hook test```## Validation```bashrch doctor --verbose # Full diagnosticsrch doctor --json # Machine-readablerch diagnose "cargo check" --dry-run # Show the decision without remote execution```⚠️ **All `rch doctor` checks must pass before use.**## References| Topic | Reference ||-------|-----------|| Worker schema, selection algorithm, tags | [WORKERS.md](references/WORKERS.md) || All error messages & detailed fixes | [TROUBLESHOOTING.md](references/TROUBLESHOOTING.md) || Hook protocol, 5-tier classification | [HOOKS.md](references/HOOKS.md) |

Frequently asked questions