← Explore all skills

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.

Upstream setup instructions ↗

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
  1. Install the pinned skill directory interactively, retaining its bundled references and scripts.
  2. Inspect the dependency and container image and keep both on the stable line.
  3. 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.

  1. Pinned skill definition ↗Checked

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

    Supports: summary, whySelected, bestFor, limitations, install, access, review

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

    Supports: install

  3. Apache-2.0 licence ↗Checked

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

    Supports: license

  4. https://raw.githubusercontent.com/cloudflare/skills/53395984c3ea1925d00fce03b266112302f050e6/skills/sandbox-stable/SKILL.md

    Supports: upstreamDescription, review.notTested, review.reviewedAt

Evidence & Ask