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.
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 - The repository README shows `npx skills add https://github.com/cloudflare/skills` for the skills collection, not this file alone.
- The Claude Code alternative in that README is `/plugin marketplace add cloudflare/skills` and `/plugin install cloudflare@cloudflare`.
- 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.
- 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
- Repository README ↗Checked
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md
Supports: Repository skills install line
- Plugin manifest ↗Checked
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/plugin.json
Supports: plugin.json license field Apache-2.0
- Repository LICENSE ↗Checked
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE
Supports: Apache License Version 2.0
https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt
https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/README.md
Supports: install.command