← Explore all 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.

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

Upstream setup instructions ↗

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.

  1. 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.
  2. 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.
  3. 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.

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

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

  3. Repository LICENSE ↗Checked

    https://github.com/docker/skills/blob/f79172733725e2fd236343ee7b963c446ed85d09/LICENSE

    Supports: Apache License 2.0

  4. https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/skills/docker-sandboxes-kits/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

  5. https://raw.githubusercontent.com/docker/skills/f79172733725e2fd236343ee7b963c446ed85d09/README.md

    Supports: install.command

Evidence & Ask