nextjs-on-cloudflare Skill for Claude: Build and Deploy Next.js on Cloudflare Workers

Makes Claude build, migrate and deploy Next.js apps on Cloudflare Workers, using vinext by default instead of OpenNext.

Installs: 47.9K; on skills.sh
Stars: 3.2K; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill sets a default: use vinext rather than OpenNext for new Next.js projects on Cloudflare Workers. It tells the agent to preserve existing OpenNext setups during unrelated maintenance and to respect your explicit choice.

For setup, migration or deployment, it points the agent to vinext's own upstream skills and docs, and says to install them with npx skills add cloudflare/vinext if they are missing. It bundles no scripts, only a feedback guide.

Good for

Developers starting a Next.js app on Cloudflare Workers
Teams moving an existing Next.js app to Workers
Anyone choosing between vinext and OpenNext

Install nextjs-on-cloudflare

Claude Code

Copy this prompt.

Install the nextjs-on-cloudflare skill in Claude Code. Run this command:

npx skills add https://github.com/cloudflare/skills --skill nextjs-on-cloudflare
npx skills add cloudflare/vinext

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The second command installs vinext's upstream skills, which SKILL.md tells the agent to install if they are missing. Installing them up front avoids a mid-task install prompt. They come from a different repo (cloudflare/vinext) and are not part of this skill.

From the vendor's docs. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Why vinext
Use the upstream workflow
Skill feedback

Key facts

Author: cloudflare
Repository: cloudflare/skills
License: Apache-2.0
Installs on skills.sh: 47,881 (Nov 2, 2026)
GitHub stars: 3,244 (Nov 2, 2026)
Last repo commit: Oct 31, 2026
What installs: 2 files including SKILL.md (references/skill-feedback.md)
Default stack: vinext, not OpenNext, for new Next.js projects on Workers
Hands off to: Skills in cloudflare/vinext, installed on demand with npx skills add cloudflare/vinext

What it includes

Chooses vinext over OpenNext for new Next.js projects on Workers
SKILL.md says this is the default in the Cloudflare Next.js guide. It keeps OpenNext in existing projects during unrelated work.
Pick vinext by default
Runs npx skills add cloudflare/vinext if the skills are missing
If installation is unavailable, it reads the upstream SKILL.md files directly.
Runs code · Install vinext's upstream skills
Follows vinext's new-project setup with create-vinext-app, Cloudflare target
The upstream migration skill needs an existing Next.js project; it must not be applied to an empty folder.
Runs code · New project
Follows the upstream migrate-to-vinext skill and its compatibility check
Selects Cloudflare as the deployment target.
Write · Existing Next.js project
Follows the current vinext Workers docs
Checks compatibility for your app's required features and does not assume full Next.js parity.
Network · Development and deployment
If you say the guidance is wrong or outdated, drafts a GitHub issue for you to approve
See the safety section: the issue is public.
Network · Skill feedback

From the official docs

Permissions

Medium risk

The skill tells the agent to fetch and follow other skills and project docs, and it can draft a public GitHub issue. Work on a branch and approve each command and any issue text.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can run npx to fetch more skills
SKILL.md tells the agent to run npx skills add cloudflare/vinext when those skills are missing. That downloads and installs third-party skill files, so confirm it before you allow it.
Feedback can become a public GitHub issue
The bundled skill-feedback guide drafts an issue on cloudflare/skills. It says to ask permission, show the exact title and body, and post only after you answer yes. Issues are public, so keep secrets out.
Setup and migration change your project
The upstream vinext skills it follows create or migrate project files. Commit or branch first so you can review the changes.

Technical details

Talks to	GitHub (npx skills add, issue creation). vinext and Cloudflare docs

Questions

What does nextjs-on-cloudflare do?

It guides Claude to build, migrate and deploy Next.js apps on Cloudflare Workers with vinext, following vinext's own skills and docs.

vinext or OpenNext?

SKILL.md says to use vinext for new Next.js projects on Workers, which is the default in the Cloudflare Next.js guide. It keeps existing OpenNext setups during unrelated maintenance and respects an explicit choice from you.

What is vinext?

Per SKILL.md, it reimplements the Next.js API surface on Vite: App Router, Pages Router, React Server Components and supported next/* imports, with local server execution in workerd. It says to check compatibility and not assume complete Next.js parity.

How do I install nextjs-on-cloudflare?

Use the install box above. It installs this skill and also vinext's upstream skills (cloudflare/vinext), because SKILL.md sends setup, migration and deployment work to them and tells the agent to run npx skills add cloudflare/vinext if they are missing. The Claude app is not listed: that route needs the agent to run npx and read other skills.

Does it need an API key?

SKILL.md names none. Deployment steps come from vinext's Workers docs, which this page does not cover.

Is nextjs-on-cloudflare safe?

It tells the agent to run package commands and to follow other skills that change your project, so work on a branch and approve each step. If you report a problem with the skill, it can draft a public GitHub issue on cloudflare/skills, but SKILL.md says it posts only after you approve the exact text.

Information

updated Nov 2, 2026

Repository: cloudflare/skills
Folder: skills/nextjs-on-cloudflare

cloudflare/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

nextjs-on-cloudflare SKILL.md · github.com
skills CLI commands · github.com
cloudflare/skills README · github.com
skill-feedback.md · github.com
nextjs-on-cloudflare on skills.sh · skills.sh