---
title: "Docker Sandboxes environment file: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/docker-docker-sandboxes-env/
description: "Pins Docker's sbxenv skill, which treats sbx env plan as a no-change preview and will not default to auto-approving host lifecycle commands."
---

# Docker Sandboxes environment file: review, setup & limitations · Undominated.ai

> Pins Docker's sbxenv skill, which treats sbx env plan as a no-change preview and will not default to auto-approving host lifecycle commands.

[← Explore all skills](/skills/)

SANDBOX CONFIGURATION / Docker

# Docker Sandboxes environment file

Pins Docker's sbxenv skill, which treats sbx env plan as a no-change preview and will not default to auto-approving host lifecycle commands.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/docker/skills/tree/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-env)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 5 linked sources
 Publisher Docker
 Licence [Apache-2.0 ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE)
 Revision f79172733725
 [Read what was—and wasn’t—checked ↓](#review)

“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`).”

 [Docker · upstream description ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-env/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - sbx env plan is described as printing the apply set and changing nothing, while create and run require approval before they do any work. The file says never to default to -y for a file or kit that has not been reviewed.
- Lifecycle commands run on the host with the operator's privileges. A failing preRemove does not itself block removal, but a new credential, a changed binding, or a replacement sandbox stops removal before deletion.

### A good fit for

 - Reviewing an sbxenv.yaml file with sbx env plan before create or run, without auto-approving host commands

### Weigh up before choosing

 - A failing preRemove is only a warning. Removal can still stop afterwards when the destroy plan no longer matches. Those are different gates.
- bindings are left in place by sbx env rm unless --prune-bindings is passed. MCP server registrations are also left in place. Sandbox-scoped secrets are the entries the file says rm can remove.
- writableEnvFiles true is called a security downgrade, and read-only protection is complete only for a file at the mount root.
- `npx skills add docker/skills` prompts for which skills and agents to install. It does not install this file by itself. The README's one-skill example names docker-compose-patterns and includes --yes; that line is not this record's command.
- The repository README marks this skill experimental. The skill calls its verification runbook unexecuted. references/sources.md was not opened, and the frontmatter's docker/sandboxes pin was not rerun.
- This review did not execute the resource.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/docker-sandboxes-env/SKILL.md
- README.md
- LICENSE

### Our findings

 - sbx env plan prints what applying the file would set up and changes nothing. create and run show that plan and require approval before doing work.
- The file says never to default to -y for an unreviewed file or kit, and never to treat an untrusted kit's lifecycle commands as pre-approved.
- Lifecycle commands run on the host, outside the sandbox, with the operator's own privileges. initialize must be idempotent because it reruns on every create and run, including an attach.
- A failing preRemove does not itself block removal. A new credential, a changed binding not covered by the approval, or a replacement sandbox under the same name stops removal before deletion.
- A literal secret must not be written into a checked-in sbxenv.yaml. bindings stay after sbx env rm unless --prune-bindings is passed.
- sbx env exec runs no lifecycle commands and does not create a sandbox. Setting writableEnvFiles true is described as a security downgrade.

### Not established by this review

 - The resource was not executed and its tools were not called.
- sbx env plan, create, run, exec, and rm were not run.
- No secret was stored, no host lifecycle command was approved, and the verification runbook was not opened.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md)

DOCUMENTED COMMAND

 npx skills add docker/skills Copy command ↗

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

 - The repository README shows `npx skills add docker/skills` as the skills CLI quick start. It says the command prompts for which skills and which agents, so it does not install this file by itself.
- The README's non-interactive one-skill example names docker-compose-patterns and passes --yes. That line is a different skill and is not the command recorded here.
- Claude Code's plugin alternative in the README is `/plugin marketplace add docker/skills` and `/plugin install docker-skills@docker`. This review did not install a plugin.

### Before you start

 - Node.js with npx if the skills CLI command is used
- An agent that can read an Agent Skills directory
- Standalone sbx with sbx env support, only if an operator later runs a command; this review did not

### Compatibility

Claude Code · Cline · Codex · Cursor · Gemini CLI · GitHub Copilot · GitHub Copilot CLI · Google Antigravity · Kiro · OpenAI Codex · OpenCode · Windsurf

### Implementation

yaml

### Local skill text; host lifecycle commands and sandbox deletion run only if an operator approves sbx

 - Read the skill text
- Run host lifecycle commands only after the approval the file describes
- Remove a sandbox, a secret, or a binding only if an operator runs sbx env rm

### Cost model

Apache-2.0; no sbx command was run

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [docker-sandboxes-env SKILL.md ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-env/SKILL.md) Checked 2026-10-14 https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-env/SKILL.md Supports: Plan versus apply, host-command approval, preRemove removal gates, and the checked-in secret refusal
- [Repository README ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md) Checked 2026-10-14 https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md Supports: npx skills add docker/skills and the Apache-2.0 badge
- [Repository LICENSE ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE) Checked 2026-10-14 https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE Supports: Apache License Version 2.0
- [2026-10-15 C2-W26 source re-review at the existing pin ↗](https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-env/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-env/SKILL.md Supports: upstreamDescription, review.notTested, review.reviewedAt
- [2026-10-15 C2-W26 source re-review at the existing pin ↗](https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/README.md) Checked 2026-10-15 https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/README.md Supports: install.command

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Docker Sandboxes lifecycle ↗ Pins Docker's local sbx lifecycle skill, which requires a dry-run before prune and forbids mounting a secrets file into the sandbox.](/skills/docker-sandboxes-lifecycle/)[### Docker Sandboxes kits ↗ Pins Docker's kit-spec skill, which forbids secret kit arguments and says a schema check does not prove composition or that a host is blocked.](/skills/docker-docker-sandboxes-kits/)[### Infisical User Setup Guide ↗ Infisical skill for getting secrets from Infisical into applications and platforms: the CLI, Docker, CI/CD, Kubernetes, the language SDKs and machine identity authentication.](/skills/infisical-setup/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
