Agent skill · cloudflare
sandbox-stable
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.
What it needs
About 3k tokens when loaded.
What this skill does
Sandbox SDK — stable package Isolated Linux environments on Cloudflare Containers, driven from Workers. Prefer the main Sandbox docs and installed stable types over memory. This skill is a gate, a contract, and a retrieval map—not a full manual. This line is the current stable default npm package. The main Sandbox documentation describes it. Existing apps can stay here and keep shipping. We recommend new projects on @cloudflare/sandbox@next with sandbox-next. When you can, plan a move with sandbox-migrate-to-next so you are ready when 1.0 becomes the stable release. Do not force that port unless the user asks. 1. Gate — confirm the package line Before writing code, inspect the app: Check Must match ----- ---------- npm dependency Default @cloudflare/sandbox (not @next / preview tags) Container image Matching stable image (not cloudflare/sandbox:next) If you find… Action ------------ ------ @cloudflare/sandbox@next or a next image Stop. Load sandbox-next. User wants to port to 1.0 / @next Stop. Load sandbox-migrate-to-next. Do not half-apply preview APIs on a stable package. Only cleaning deprecated stable APIs Stay here; use the 2026 deprecation guide. That is not a move to @next. Never mix a stable Worker package with an @next container image (or the reverse). Skills install: Agent setup · cloudflare/skills 2. Contract — non-negotiables await sandbox.exec(command) takes a command string and resolves when the command finishes, with buffered stdout / stderr / exitCode (and related fields). Long-running and streaming work use the stable command APIs (startProcess, execStream, and related helpers)—not the @next single-handle model. Open the Commands docs; do not invent @next output() handles on stable. Sessions can preserve working directory and environment across commands (default session / enableDefaultSession, createSession). See Sessions docs when state must carry across calls. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills cloudflare/sandbox-stable