SANDBOX KITS / Docker
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.
“Use this skill when authoring, validating, packaging, signing, or composing a Docker Sandboxes kit `spec.yaml` (`sbx kit add/inspect/pack/pull/push/sign/validate/verify`), even if the user just says they want to "add a tool to a sandbox agent", "build a reusable sandbox extension", "publish a kit to a registry", or "give a mixin its own credentials and network access". Covers the kit-spec v2 grammar (`kind: sandbox` vs `kind: mixin`, the `sandbox:` block, `permissions.network`, `ports`, `credentials` apiKey/oauth, `environment`, `setup` install/startup/files, `volumes`, `args`, `extends`, `mixins`, `requires.agent`), composition via `--kit`/`sbx kit add`, and distribution (pack/push/pull/sign/verify/provenance).”
01 / THE REASONING
Why this made the selection.
- The file forbids passing a secret as a kit argument, keeps OAuth off mixin kits, and calls token passthrough a security downgrade.
- It says kit validation never composes against a base agent, kit add skips volumes, and removing one allow entry does not prove a host is blocked.
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-kits/SKILL.md
- README.md
- LICENSE
Our findings
- A mixin must not declare a sandbox block, extends, or mixins, and OAuth belongs on sandbox kits rather than mixins.
- Kit arguments are not a place for secrets, because those values are not masked.
- OAuth passthrough is described as a security downgrade because the real token reaches the container.
- sbx kit validate is a schema check and does not compose the kit against a base agent.
- An unsized block volume inherits a 50 GiB default, and sbx kit add skips volume changes.
- Every push attaches provenance that is unsigned by default.
- Removing a host from one allow list does not prove that host is blocked.
Not established by this review
- The resource was not executed and sbx was not called.
- No kit was validated, packed, pushed, signed, or added to a sandbox.
- references/sources.md, references/spec-v2-fields.md, references/kit-distribution-commands.md, checks/verification.md, and the asset YAML files were 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.
DOCUMENTED COMMAND
npx skills add docker/skills 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`, which prompts for which skills and agents to install. That is the whole repository, not this file alone.
- The same README shows `/plugin marketplace add docker/skills` and `/plugin install docker-skills@docker` for Claude Code and GitHub Copilot CLI. That installs the docker-skills plugin group.
- No fetched line installs only docker-sandboxes-kits. The per-skill example names docker-compose-patterns instead.
Before you start
- Standalone sbx with kit support and kit-spec schemaVersion 2, as the skill frontmatter states
- npx, because the README install line uses npx
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-kits/SKILL.md
Supports: secret kit arguments, OAuth passthrough, schema-only validation, volume size, and unsigned provenance
- Repository README ↗Checked
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/README.md
Supports: npx skills add docker/skills, the docker-skills plugin install, and the Apache-2.0 statement
- Repository LICENSE ↗Checked
https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE
Supports: Apache License 2.0
https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-kits/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt
https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/README.md
Supports: install.command