docker-sandboxes-env
Use this skill when authoring, planning, or running a declarative sbxenv.yaml file for Docker Sandboxes (sbx env create/run/plan/exec/rm), even if the user just says they want to "check in a sandbox config", "make onboarding reproducible for a sandbox", "run a setup script before the agent starts", or "define arguments for a shared sandbox environment". Covers the sbxenv.yaml schema (schemaVersion, agent, kits, workspace/additionalWorkspaces, args, env, secrets, registries, bindings, mcp, ports, sandboxOptions), host lifecycle: commands (initialize/postCreate/preRemove) and their approval-plan model, multi-file merge (-f-style deep merge and the user-level .sbxenv.yaml base layer), and file-write-protection (sandboxOptions.writableEnvFiles).
- License
- Apache-2.0
- Compatibility
- Requires standalone sbx with sbx env support and sbxenv.yaml schemaVersion "1", not the legacy docker sandbox wrapper. Verified against docker/sandboxes df5c96ba60484fa2c375469dbac912c205da6c37; installed-help version and provenance are in references/sources.md. docker_help does not cover standalone sbx.
Pinned to revision 4e8964e24a5a, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/docker-sandboxes-env/SKILL.md
- skills/docker-sandboxes-env/assets/sbxenv.yaml
- skills/docker-sandboxes-env/checks/verification.md
- skills/docker-sandboxes-env/references/env-schema-fields.md
- skills/docker-sandboxes-env/references/sources.md
- skills/docker-sandboxes-env/skill.yaml
Every link opens the file at its source, pinned to the revision this page describes.