← Explore all skills

SANDBOX DEVELOPMENT / Cloudflare

Cloudflare Sandbox next

Pins Cloudflare's sandbox-next skill, which stops on the stable package, refuses a mixed preview image, and keeps live credentials in the Worker.

“Build or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-migrate-to-next when porting a stable app.”

01 / THE REASONING

Why this made the selection.

  • The file says to stop when the app uses the default @cloudflare/sandbox package, and not to mix an @next Worker package with a stable container image.
  • A local wait timeout cancels the wait only and does not kill the process, and live credentials stay in the Worker rather than in sandbox environment variables.

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/sandbox-next/SKILL.md
  • README.md
  • plugin.json
  • LICENSE

Our findings

  • If the dependency is the default @cloudflare/sandbox package, the file says to stop, load sandbox-stable, and not apply this skill's APIs.
  • A requested port from stable to @next is stopped here and sent to sandbox-migrate-to-next. A self-deployed bridge stays on the stable package and image.
  • An @next Worker package must not be mixed with a stable container image, or the reverse.
  • A local wait timeout or AbortSignal cancels the wait only and does not kill the process. getProcess, listProcesses, getTerminal, and listTerminals do not start a container.
  • Non-secret config is the only material for setEnvVars and launch env. Live credentials stay in the Worker, and the pre-ship list says no live secrets in the sandbox environment.

Not established by this review

  • The resource was not executed and its tools were not called.
  • No sandbox was created, no process was killed, and no container image was pulled.
  • The preview docs, installed @next types, and the skill's reference 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 cloudflare/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.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/cloudflare/skills
  1. The repository README shows `npx skills add https://github.com/cloudflare/skills` for the skills collection, not this file alone.
  2. The Claude Code alternative in that README is `/plugin marketplace add cloudflare/skills` and `/plugin install cloudflare@cloudflare`.
  3. This skill says to inspect the installed npm dependency and container image before writing code. This review did not install the package.

Before you start

  • Node.js with npx if the skills CLI command is used
  • An agent that can read an Agent Skills directory
  • A Workers project whose sandbox dependency and container image can be inspected before use

04 / FOLLOW THE EVIDENCE

The source trail.

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

  1. sandbox-next SKILL.md ↗Checked

    https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md

    Supports: Package-line stop, image mismatch refusal, wait versus kill, and credential placement

  2. Repository README ↗Checked

    https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md

    Supports: Repository skills install line

  3. Plugin manifest ↗Checked

    https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/plugin.json

    Supports: plugin.json license field Apache-2.0

  4. Repository LICENSE ↗Checked

    https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE

    Supports: Apache License Version 2.0

  5. https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

  6. https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/README.md

    Supports: install.command

Evidence & Ask