---
title: "Cloudflare Sandbox next: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/cloudflare-sandbox-next/
description: "Pins Cloudflare's sandbox-next skill, which stops on the stable package, refuses a mixed preview image, and keeps live credentials in the Worker."
---

# Cloudflare Sandbox next: review, setup & limitations · Undominated.ai

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

[← Explore all skills](/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.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/cloudflare/skills/tree/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next)

SOURCE REVIEW

 Reviewed 2026-10-15
 Evidence 6 linked sources
 Publisher Cloudflare
 Licence [Apache-2.0 ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE)
 Revision 53395984c3ea
 [Read what was—and wasn’t—checked ↓](#review)

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

 [Cloudflare · upstream description ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md) Our analysis follows below.

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.

### A good fit for

 - Writing a new Cloudflare Sandbox app only after the package and container image are both on the @next line

### Weigh up before choosing

 - Several different tasks in the retrieval table share the URL https://developers.cloudflare.com/sandbox/index.md, so the table does not by itself distinguish those pages.
- A self-deployed bridge is kept on the stable package and image. Porting is sent to sandbox-migrate-to-next and is out of scope here.
- `npx skills add https://github.com/cloudflare/skills` adds the whole repository, not this file alone.
- references/api-quick-ref.md and references/examples.md were not opened. No plugin README sits above this skill.
- This review did not execute the resource.

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 ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md)

DOCUMENTED COMMAND

 npx skills add cloudflare/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.

 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 Copy reviewed-revision command ↗ - 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

### Compatibility

Claude Code · Codex · Cursor · GitHub Copilot · OpenCode · OpenAI Codex · Pi · VS Code

### Implementation

typescript

### Local skill text; sandbox processes and credentials change only if an operator runs the SDK

 - Read the skill text
- Keep live credentials in the Worker rather than in sandbox environment variables
- Start, wait on, or kill a sandbox process only if an operator runs that code

### Cost model

Apache-2.0; no sandbox 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.

 - [sandbox-next SKILL.md ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md) Checked 2026-10-14 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 ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md) Checked 2026-10-14 https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md Supports: Repository skills install line
- [Plugin manifest ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/plugin.json) Checked 2026-10-14 https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/plugin.json Supports: plugin.json license field Apache-2.0
- [Repository LICENSE ↗](https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE) Checked 2026-10-14 https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE Supports: Apache License Version 2.0
- [2026-10-15 W45 source re-review at the existing pin ↗](https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md) Checked 2026-10-15 https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-next/SKILL.md Supports: upstreamDescription, review.notTested, review.reviewedAt
- [2026-10-15 W45 source re-review at the existing pin ↗](https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/README.md) Checked 2026-10-15 https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/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.

 [### Cloudflare Sandbox preview migration ↗ Pins Cloudflare's stable-to-preview Sandbox migration, which refuses an unagreed production cutover and forbids invented APIs and live secrets in the sandbox environment.](/skills/cloudflare-sandbox-migrate-to-next/)[### Cloudflare product discovery ↗ Pins Cloudflare's product-discovery skill, which blocks a new Wrangler setup, runs cf migrate only when asked, and says a version rollback does not restore resource data.](/skills/cloudflare-cloudflare/)[### Cloudflare Wrangler Workflow ↗ Runs Wrangler work in projects that already have a Wrangler configuration file, against the installed Wrangler version and an explicitly identified target.](/skills/cloudflare-wrangler/)

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