Prepare Cloudflare Production Deployment
LubomirGeorgiev/cloudflare-workers-nextjs-saas-template
Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.
Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext.
Install Nextjs On Cloudflare
$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cloudflare/skills nextjs-on-cloudflare --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/cloudflare/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/nextjs-on-cloudflare .claude/skills/nextjs-on-cloudflare && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "nextjs-on-cloudflare" agent skill from https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflare into .claude/skills/nextjs-on-cloudflare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-on-cloudflare", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflareType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cloudflare/skills nextjs-on-cloudflare --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudflare/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/nextjs-on-cloudflare .agents/skills/nextjs-on-cloudflare && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "nextjs-on-cloudflare" agent skill from https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflare into .agents/skills/nextjs-on-cloudflare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-on-cloudflare", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cloudflare/skills nextjs-on-cloudflare --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudflare/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/nextjs-on-cloudflare .cursor/skills/nextjs-on-cloudflare && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "nextjs-on-cloudflare" agent skill from https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflare into .cursor/skills/nextjs-on-cloudflare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-on-cloudflare", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/cloudflare/skills.git --path skills/nextjs-on-cloudflare--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cloudflare/skills nextjs-on-cloudflare --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudflare/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/nextjs-on-cloudflare .gemini/skills/nextjs-on-cloudflare && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "nextjs-on-cloudflare" agent skill from https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflare into .gemini/skills/nextjs-on-cloudflare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-on-cloudflare", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install cloudflare/skills nextjs-on-cloudflareInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cloudflare/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/nextjs-on-cloudflare .github/skills/nextjs-on-cloudflare && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "nextjs-on-cloudflare" agent skill from https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflare into .github/skills/nextjs-on-cloudflare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-on-cloudflare", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cloudflare/skills nextjs-on-cloudflare --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cloudflare/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/nextjs-on-cloudflare .opencode/skills/nextjs-on-cloudflare && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "nextjs-on-cloudflare" agent skill from https://github.com/cloudflare/skills/tree/main/skills/nextjs-on-cloudflare into .opencode/skills/nextjs-on-cloudflare/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-on-cloudflare", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
nextjs-on-cloudflare- GitHub stars
- 3k
- Used in
- 2 other repos
- Token cost
- ~678 tokens
- SKILL.md length
- 233 words
- Files
- 1
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext.
- Starting a Next.js project on Cloudflare
- SKILL.md covers Why vinext and Use the upstream workflow
- Calls npx
- Moving an existing app to Workers
What it does
Nextjs On Cloudflare is an agent skill from cloudflare/skills, published by the product's own GitHub organization. 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.
Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Deployment. It works with Cloudflare, Next.js, Cloudflare Workers and Vite. The repository describes itself as: Skills for teaching agents how to build on Cloudflare. The licence is Apache-2.0.
When your agent uses it
- Starting a Next.js project on Cloudflare
- Moving an existing app to Workers
- Choosing between vinext and OpenNext
- Setting up vinext for Workers
Example prompts
- “/nextjs-on-cloudflare”
Requirements
- Node.js
What it can do on your machine
Read from SKILL.md and the folder at commit 41e0d19. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.comdevelopers.cloudflare.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Nextjs On Cloudflare loads about 678 tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 233 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from cloudflare/skills at commit 41e0d19, republished under its Apache-2.0 licence (© cloudflare). 233 words, ~678 tokens.
Download SKILL.mdSave it as
.claude/skills/nextjs-on-cloudflare/SKILL.md (or your agent's skills folder).- name
- nextjs-on-cloudflare
- description
- 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.
Next.js on Cloudflare
Use vinext rather than OpenNext for new Next.js projects on Cloudflare Workers. This is the default in the Cloudflare Next.js guide. Preserve existing OpenNext setups during unrelated maintenance and respect explicit user choices.
Why vinext
vinext reimplements the Next.js API surface on Vite:
- Familiar Next.js development: App Router, Pages Router, React Server Components, and supported
next/*imports. - Vite tooling: fast HMR, native ESM, and the Vite plugin ecosystem.
- Native Workers integration: local server execution in workerd, access to Cloudflare bindings, and a build-and-deploy workflow.
- Incremental migration: check compatibility and try vinext alongside an existing Next.js setup.
Use the upstream workflow
Before setup, migration, or deployment, check whether the skills maintained in vinext are available. If missing, install them:
npx skills add cloudflare/vinextThen read and follow the applicable upstream SKILL.md and its relevant references. Use the current vinext docs for workflows the skills do not cover:
- New project: follow vinext's new-project setup using
create-vinext-appwith the Cloudflare target. The upstream migration skill requires an existing Next.js project; do not apply it to an empty directory. - Existing Next.js project: load and follow the upstream
migrate-to-vinextskill, including its compatibility check and relevant references. Select Cloudflare as the deployment target. - Development and deployment: follow the current Workers integration docs.
If installation is unavailable, read the linked upstream SKILL.md and relevant references directly. Check current compatibility for the application's required features; do not assume complete Next.js parity.
© cloudflare, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/nextjs-on-cloudflare of cloudflare/skills.
Open the folder on GitHubat commit 41e0d19
Used in 2 other repositories
We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in cloudflare/skills, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Nextjs On Cloudflare next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Nextjs On Cloudflare this skillcloudflare/skills | 3k | 2 repos | ~678 | Automated safety check: Pass | Apache-2.0 | |
| Prepare Cloudflare Production DeploymentLubomirGeorgiev/cloudflare-workers-nextjs-saas-template | 786 | — | ~5.9k | Automated safety check: Notes | MIT | |
| Cloudflare Workers CD Rollbackmizchi/skills | 356 | — | ~1.2k | Automated safety check: Notes | None | |
| Cloudflare Worker Builderinfometa/workbuddyskills | 342 | — | ~1k | Automated safety check: Pass | None | |
| Deploy Agentsundial-org/awesome-openclaw-skills | 663 | — | ~1.6k | Automated safety check: Pass | None | |
| Convex Self Hostingwaynesutton/markdown-site | 628 | — | ~1.4k | Automated safety check: Pass | MIT |
Similar skills
Cloudflare Workers CD Rollback
mizchi/skills
GitHub Actions CD for Cloudflare Workers through cf with automatic traffic rollback on smoke failure, including JSON deployment snapshots, D1 migrations and prebuilt artifacts.
Cloudflare Worker Builder
infometa/workbuddyskills
Scaffold and deploy Cloudflare Workers with Hono routing, Vite plugin, and Static Assets.
Deploy Agent
sundial-org/awesome-openclaw-skills
Multi-step deployment agent for full-stack apps. An agent skill from sundial-org/awesome-openclaw-skills.
Convex Self Hosting
waynesutton/markdown-site
Integrate Convex static self hosting into existing apps using the latest upstream instructions from get-convex/self-hosting every time.
Lunora Deploy
anolilab/lunora
Deploys a Lunora app to Cloudflare. An agent skill from anolilab/lunora.
More from cloudflare/skills
All 16 skills in this repo- Official
Turnstile Spin
cloudflare/skills
Set up, repair, or migrate to Cloudflare Turnstile bot verification in an existing frontend and backend, including server-side Siteverify.
- Official
Agents SDK
cloudflare/skills
Build, debug, or review Cloudflare Agents SDK applications using the agents package.
- Official
Durable Objects
cloudflare/skills
Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.
- Official
Sandbox Next
cloudflare/skills
Build or maintain Cloudflare Sandbox apps on @cloudflare/sandbox@next (SDK 1.0 preview).
- Official
Cloudflare One Migrations
cloudflare/skills
Assess and plan migrations from existing VPN, SWG, or SASE platforms to Cloudflare One, including policy mapping, parity gaps, and rollout.
- Official
Workers Best Practices
cloudflare/skills
Cloudflare Workers best practices for production applications.
Related
Works with
Categories
Questions about Nextjs On Cloudflare
What does Nextjs On Cloudflare do?
Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext. Nextjs On Cloudflare is an agent skill from cloudflare/skills, published by the product's own GitHub organization.js apps on Cloudflare Workers with vinext.
When should I use Nextjs On Cloudflare?
Nextjs On Cloudflare fits situations like: starting a Next.js project on Cloudflare; moving an existing app to Workers; choosing between vinext and OpenNext; setting up vinext for Workers.
How do I install Nextjs On Cloudflare in Claude Code?
Run `npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a claude-code`. Or copy the skill folder (skills/nextjs-on-cloudflare in cloudflare/skills) into .claude/skills/nextjs-on-cloudflare in your project. Claude Code loads it when a task matches its description.
How do I install Nextjs On Cloudflare in Codex?
Run `npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a codex`. Or copy the skill folder (skills/nextjs-on-cloudflare in cloudflare/skills) into .agents/skills/nextjs-on-cloudflare in your project. Codex loads it when a task matches its description.
Can I use Nextjs On Cloudflare in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cloudflare/skills --skill nextjs-on-cloudflare -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nextjs-on-cloudflare, .gemini/skills/nextjs-on-cloudflare, .github/skills/nextjs-on-cloudflare and .opencode/skills/nextjs-on-cloudflare in your project.
What does Nextjs On Cloudflare need to run?
Going by SKILL.md and its folder, Nextjs On Cloudflare needs the command-line tools its instructions call (npx). Our summary lists: Node.js.
Does Nextjs On Cloudflare access the network?
SKILL.md names 2 domains. As links in the text: github.com and developers.cloudflare.com. This is read from the text; nothing was executed.
Is Nextjs On Cloudflare safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Nextjs On Cloudflare use?
Nextjs On Cloudflare is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Nextjs On Cloudflare use?
About 678 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Nextjs On Cloudflare?
Skills that share tags, products or a category with Nextjs On Cloudflare: Prepare Cloudflare Production Deployment (LubomirGeorgiev/cloudflare-workers-nextjs-saas-template, 786 stars), Cloudflare Workers CD Rollback (mizchi/skills, 356 stars), Cloudflare Worker Builder (infometa/workbuddyskills, 342 stars) and Deploy Agent (sundial-org/awesome-openclaw-skills, 663 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Nextjs On Cloudflare?
cloudflare (a GitHub organization, an official publisher) maintains it in cloudflare/skills, which has 2,999 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 1, 2026.
Source: cloudflare/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.