---
title: "Docker Sandboxes kits: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/docker-docker-sandboxes-kits/
description: "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."
---

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

> 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.

[← Explore all skills](/skills/)

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.

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

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, 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).”

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

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.

### A good fit for

 - Authoring a schemaVersion 2 sandbox or mixin spec when secrets stay out of kit arguments and egress is checked on a real sandbox

### Weigh up before choosing

 - This review did not execute the resource.
- `npx skills add docker/skills` prompts for skills from the whole repository. It does not install this file alone.
- `/plugin install docker-skills@docker` installs the docker-skills plugin group, not this file alone.
- The repository README marks docker-sandboxes-kits experimental.
- references/, checks/verification.md, and the asset YAML files were not opened. A mixin must not declare mixins, while the composition section says a mixins field is accepted with a warning and not applied; those sentences are about different kit kinds.
- The file says it was checked against a docker/sandboxes commit. This review did not open that commit.

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.

[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`, 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

### Compatibility

Claude Code · Codex · Cursor · GitHub Copilot · Gemini CLI · OpenCode · Windsurf · Cline · Kiro · standalone sbx

### Implementation

YAML

### Local skill text; a kit changes a sandbox only if an operator runs sbx

 - Read the skill text
- Publish, sign, or inject a kit only if the operator runs those sbx kit commands
- Do not pass secret values as kit arguments

### Cost model

Apache-2.0; no sbx, registry, or signing 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-kits SKILL.md ↗](https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-kits/SKILL.md) Checked 2026-10-14 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 ↗](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, the docker-skills plugin install, and the Apache-2.0 statement
- [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 2.0
- [2026-10-15 C2-W27 source re-review at the existing pin ↗](https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-kits/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-kits/SKILL.md Supports: upstreamDescription, review.notTested, review.reviewedAt
- [2026-10-15 C2-W27 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 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.](/skills/docker-docker-sandboxes-env/)[### 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/)[### dbt Core to v2 migration triage ↗ Pins dbt Labs' v2 migration triage, which asks before a credential check and forbids edits until autofix changes have been reviewed.](/skills/dbt-labs-migrating-dbt-core-to-v2/)

 [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/)
