docker-sandbox — Claude Code skill: what it does, how to install
docker-sandbox runs Claude and Codex agent loops inside isolated Docker containers. Keeps subprocesses separated from your host machine and protects credentials.
no license 103 installs ★ 68 updated 2026-10-20
npx skills add joelhooks/joelclaw --skill docker-sandbox -a claude-codeWhat docker-sandbox does
This skill routes execution based on the workload type. It points workshop and demo environments toward sandbox-computer, while background execution jobs use workflow-rig with a dedicated adapter.
Isolation is treated as a hard requirement. If Docker is unavailable, the skill refuses to silently fall back to running commands on your host. Credentials stay confined to persistent auth volumes, which blocks tokens from slipping into container layers or terminal arguments.
Container lifecycle is tightly tracked. The skill publishes only requested network ports and removes the containers it started once the task is finished.
What it helps with
- isolate agent tool subprocesses from the local host system
- prevent auth credentials from leaking into Docker images or command logs
- spin up isolated sandboxes for workshop exercises and code demos
- clean up finished containers and mapped ports after agent execution
Example prompts for the agent
- Run this agent loop inside a Docker sandbox to keep the host clean
- Set up an isolated demo workspace for the workshop
- Check Docker availability and execute this task in a container sandbox
How to install docker-sandbox
1Skills CLI (Vercel)
npx skills add joelhooks/joelclaw --skill docker-sandbox -a claude-code2Manually: put the files in place
~/.claude/skills/docker-sandbox/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/docker-sandbox/
1Skills CLI (Vercel)
npx skills add joelhooks/joelclaw --skill docker-sandbox -a codex2Manually: put the files in place
.agents/skills/docker-sandbox/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add joelhooks/joelclaw --skill docker-sandbox -a cursor2Manually: put the files in place
.cursor/skills/docker-sandbox/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install joelhooks/joelclaw skills/docker-sandbox2Manually: put the files in place
.github/skills/docker-sandbox/SKILL.md1Skills CLI (Vercel)
npx skills add joelhooks/joelclaw --skill docker-sandbox -a gemini-cli2Platform CLI
gemini skills install https://github.com/joelhooks/joelclaw --path skills/docker-sandboxManually: put the files in place
.devin/skills/docker-sandbox/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add joelhooks/joelclaw --skill docker-sandbox -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about docker-sandbox
How do I install docker-sandbox in Claude Code?
Run npx skills add joelhooks/joelclaw --skill docker-sandbox -a claude-code. The skill file will be placed in ~/.claude/skills/docker-sandbox/SKILL.md.
What does the docker-sandbox skill do?
It manages container sandboxes for running agent tools like Claude and Codex in isolation. The skill handles port publishing, cleanup, and secure credential handling.
What happens if Docker is not running?
The skill reports the exact limitation instead of silently running commands on the host. Falling back to host execution requires explicit user authorization.