Agent skill · cloudflare
sandbox-migrate-to-next
Migrate Cloudflare Sandbox apps from stable @cloudflare/sandbox to @cloudflare/sandbox@next (SDK 1.0 preview). Use sandbox-next for apps already on the preview.
What it needs
About 4k tokens when loaded.
What this skill does
Migrate stable → Sandbox SDK 1.0 preview (@next) Perform the port. Follow the steps in order. Depth lives in docs—fetch the linked page when a step needs detail. Human guide: Migrate · 1.0 preview New projects should start on @next (sandbox-next), not this skill. Day-to-day stable work → sandbox-stable. Deprecated-API cleanup without moving to @next → 2026 deprecation guide first if needed. Existing apps should migrate when you can, so you are ready when 1.0 becomes the stable release. Do not force production cutover without the user agreeing. Prefer installed @next types and the migrate doc over memory. Workflow 1. Review hard rules and the replacement map 2. Audit the codebase; list hits and target shapes 3. Clarify with the user (cutover, bridge, Python image, unclear sites) 4. Upgrade package, image, and code 5. Validate Stop after any step that needs a user decision. Hard rules Worker package and container image must be the same @next line. Production cutover uses immediate container rollout. Stable and @next control protocols are incompatible both ways; gradual rollout leaves a broken mixed window. In-flight container work can stop. After cutover, await sandbox.exec(...) means process started, not command finished. Argv is as-is (no implicit shell). Shell syntax needs an explicit shell binary. Process handles have no stdin → terminals for interactive input. Observation timeout / AbortSignal cancel the wait only, not the process. No single retry loop for every error. Do not invent APIs (gitCheckout on core, process stdin, string-exec completion helper). Self-deployed bridge stays on stable (not part of the preview line yet). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills cloudflare/sandbox-migrate-to-next