nextjs-on-cloudflare
An agent skill by cloudflare, from cloudflare/skills. Tags: cloudflare, deployment, migration, nextjs, setup.
What it does
Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext. Use when starting a Next.js project on Cloudflare, moving an existing app to Workers, choosing between vinext and OpenNext, or setting up vinext for Workers. For setup, migration, or deployment, install vinext's upstream skills with `npx skills add cloudflare/vinext` if missing, then read and follow the applicable skill and docs.
Install
With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:
npx skills add cloudflare/skills --skill nextjs-on-cloudflare
Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):
git clone --depth 1 https://github.com/cloudflare/skills
cp -r skills/skills/nextjs-on-cloudflare ~/.claude/skills/nextjs-on-cloudflare
Safety box score
Grade C, moderate risk: 30 of 100 risk points, rated 2026-10-20. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.
This skill is mostly a routing document: it tells the agent to install and then follow external vinext skills/docs for building, migrating, and deploying Next.js apps on Cloudflare Workers. The main risks are executing a registry package via `npx` and delegating behavior to mutable remote GitHub content outside this bundle.
| Category | Level | Why |
|---|---|---|
| Code & shell execution | 2 (moderate) | It explicitly instructs `npx skills add cloudflare/vinext`, which runs code from the package registry and can execute install-time scripts. |
| Network access | 2 (moderate) | The workflow depends on fetching upstream skills and "current" docs from GitHub, so it requires outbound network access to remote content. |
| Filesystem reach | 1 (low) | Installing the upstream skill with `npx skills add cloudflare/vinext` will add local files to the agent's skill store, but this file itself does not directly edit project or system paths. |
| Secrets & credentials | 0 (none) | The skill does not ask for tokens, keys, passwords, `.env` files, or browser/CLI session data. |
| Privilege & persistence | 0 (none) | It does not request sudo, global system changes, service registration, or shell/OS configuration changes. |
| Instruction hijack surface | 1 (low) | It tells the agent to "read and follow" upstream SKILL.md files and docs from GitHub, so behavior can be shaped by external instructions outside this repo. |
| Irreversible actions | 1 (low) | Its purpose includes "build, migrate, and deploy" workflows, but this file does not itself issue deploy/publish actions or bypass human confirmation. |
| Transparency | 1 (low) | Important behavior is delegated to external vinext skills and docs that are not included here, and the guide points to "current" remote references that can change over time. |
Before installing
- Read the upstream vinext `SKILL.md` and references before allowing the agent to run `npx skills add cloudflare/vinext`.
- Run the install in a scratch workspace or throwaway account if you do not want registry code touching your main environment.
- Decide whether you are comfortable with the agent following external GitHub docs that can change over time.
Rated 2026-10-20 by an automated review of 1 file from the skill's repository.
Source
- Repository
- cloudflare/skills (all skills from this repository)
- Path
- skills/nextjs-on-cloudflare/SKILL.md
- Branch
- main
- Updated
- 2026-09-20
Related skills
- 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.
- wrangler — Run or troubleshoot Wrangler CLI commands and configure Worker projects for local development, deployment, and Cloudflare resource management.
- app-platform-migration — Migrate applications from Heroku, AWS, Render, Railway, Fly.io, or Docker Compose to DigitalOcean App Platform. Use when converting existing apps.
- eas-hosting — EAS service (paid). Deploy Expo websites and Expo Router API routes to EAS Hosting - export the web bundle, run eas deploy for production and PR preview URLs.
- expo-upgrade — Framework (OSS). Guidelines for upgrading Expo SDK versions and fixing dependency issues
- launch-with-aws — Migrates vibe-coded web applications to AWS.