Initial companion-offload skill for Claude Code

README.md

@@ -0,0 +1,62 @@
+# Companion Offload Skill
+
+A [skills.sh](https://skills.sh) skill for Claude Code that offloads tasks to a Companion sandbox in the cloud.
+
+## What it does
+
+When you invoke this skill, Claude will:
+
+1. Use `companion ssh` to connect to your sandbox
+2. Sync your entire project, environment variables, and Claude session history
+3. Install Claude Code on the sandbox if needed
+4. Start a Claude Code session with `--dangerously-skip-permissions` so it runs autonomously
+
+The remote session picks up right where you left off - full context, full environment.
+
+## Install
+
+```bash
+npx skills add getcompanion-ai/companion-skill
+```
+
+## Usage
+
+Inside a Claude Code session, tell Claude to offload:
+
+- "offload this task to my companion"
+- "continue this in the cloud"
+- "run this on my sandbox"
+
+Or use the standalone script:
+
+```bash
+./companion-offload/scripts/offload.sh "finish implementing the API"
+```
+
+## Prerequisites
+
+- `companion` CLI installed: `npm install -g @getcompanion/cli`
+- Logged in: `companion login`
+- A running sandbox: `companion create <handle>`
+- `rsync` available locally
+
+## Remote workspace
+
+Files are synced to whichever path exists on the sandbox:
+
+- `/home/node/.openclaw/workspace`
+- `/home/node/.pi/workspace`
+
+## Reconnecting
+
+After offloading, reconnect to the remote session:
+
+```bash
+companion ssh
+cd /home/node/.openclaw/workspace
+claude --continue
+```
+
+## License
+
+MIT