CLOUD DEVELOPMENT / cloudflare
Cloudflare Sandbox Stable SDK
Maintain existing stable Sandbox SDK applications without mixing preview package, image, command or terminal APIs.
“Build or maintain Cloudflare Sandbox apps on the stable @cloudflare/sandbox package. Use sandbox-next for preview apps and sandbox-migrate-to-next for stable-to-preview migrations.”
01 / THE REASONING
Why this made the selection.
- It keeps stable @cloudflare/sandbox code on the stable command APIs and stops a half-applied move to @next.
- Live credentials stay in the Worker, and the file tells the agent to fetch the matching docs instead of inventing signatures.
- Starts with an explicit npm-package and container-image compatibility gate.
- Maps commands, sessions, files, ports, backups and outbound handling to task-specific stable documentation.
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-stable/SKILL.md
- README.md
- LICENSE
Our findings
- The file is a gate and retrieval map, not a full manual, and it says to prefer installed stable types over memory.
- A stable Worker package must not be mixed with an @next container image.
- Live credentials belong in the Worker; only non-secret config belongs in the sandbox env.
- The skill does not force a port to sandbox-next unless the user asks.
- Contract distinguishes buffered exec from stable streaming/background APIs and preview process handles.
- Source explicitly avoids forcing an unrelated application migration.
Not established by this review
- The resource was not executed and its tools were not called.
- No skill execution, authenticated service operation, or outcome benchmark was performed.
- 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/skills/sandbox-stable 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/tree/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-stable - Install the pinned skill directory interactively, retaining its bundled references and scripts.
- Inspect the dependency and container image and keep both on the stable line.
- Retrieve the relevant stable API page, typecheck locally and verify production hostname requirements for preview URLs.
Before you start
- Workers project using stable @cloudflare/sandbox
- Matching stable container image and Cloudflare Containers access
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Pinned skill definition ↗Checked
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-stable/SKILL.md
Supports: summary, whySelected, bestFor, limitations, install, access, review
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/README.md
Supports: install
- Apache-2.0 licence ↗Checked
https://github.com/cloudflare/skills/blob/53395984c3ea1925d00fce03b266112302f050e6/LICENSE
Supports: license
https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-stable/SKILL.md
Supports: upstreamDescription, review.notTested, review.reviewedAt