К основному содержанию
скилл CX Codex

frameworks-on-cloudflare — скилл для Claude Code: сборка на Workers

Скилл frameworks-on-cloudflare для Claude Code помогает собирать и переносить веб-приложения на Cloudflare Workers. Включается, когда проект на Astro, SvelteKit, Nuxt или другом поддерживаемом фреймворке нацелен на Workers.

Apache-2.0 8 100 установок ★ 3 424 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cloudflare/skills --skill frameworks-on-cloudflare -a claude-code
Открыть на GitHub

Что делает frameworks-on-cloudflare

Скилл настраивает веб-фреймворк для сборки и развёртывания на Cloudflare Workers. Он начинает с проверки фреймворка, его версии, пакетного менеджера и конфигурации проекта, а затем подбирает подходящие инструкции для адаптера и сборки.

Для нового проекта инструкции используют C3 и Wrangler. Существующий проект с конфигурацией Wrangler сохраняет её и требует скилл wrangler; команды cf init ., cf dev, cf build и cf deploy для такого проекта запускать нельзя. Если конфигурации Cloudflare ещё нет, используется cf, который распознаёт поддерживаемые фреймворки, но само распознавание не гарантирует успешную сборку.

Скилл учитывает различия режимов Astro, React Router и Hono. Например, SPA-режим React Router не поддерживается плагином Cloudflare Vite. После настройки он предлагает проверить скрипты пакета, выполнить проверки и сборку фреймворка, затем запустить Worker локально перед развёртыванием.

Какие задачи решает

  • настроить новый проект фреймворка для Cloudflare Workers
  • перенести существующее приложение на Workers
  • выбрать адаптер и конфигурацию для фреймворка
  • проверить локальную сборку и запуск Worker

Примеры запросов агенту

  • Настрой проект Astro для сборки и развёртывания на Cloudflare Workers.
  • Перенеси приложение SvelteKit на Cloudflare Workers и проверь локальный запуск.
  • Проверь конфигурацию Workers в проекте на React Router.

Как установить frameworks-on-cloudflare

1Через Skills CLI (Vercel)

npx skills add cloudflare/skills --skill frameworks-on-cloudflare -a claude-code

2Вручную: положить файлы

~/.claude/skills/frameworks-on-cloudflare/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/frameworks-on-cloudflare/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о frameworks-on-cloudflare

Как установить frameworks-on-cloudflare в Claude Code?

Выполни npx skills add cloudflare/skills --skill frameworks-on-cloudflare -a claude-code. Файл скилла появится по пути ~/.claude/skills/frameworks-on-cloudflare/SKILL.md.

Что делает frameworks-on-cloudflare?

Скилл помогает настроить приложения на веб-фреймворках для Cloudflare Workers: выбирает инструкции по адаптеру и конфигурации, проверкам и локальному запуску.

Что делать, если в проекте уже есть конфигурация Wrangler?

Сохранить Wrangler и загрузить скилл wrangler. Команды cf init ., cf dev, cf build и cf deploy для такого проекта не запускать.

Исходный текст

SKILL.md · Apache-2.0
---
name: frameworks-on-cloudflare
description: Build, migrate, and deploy web-framework applications on Cloudflare Workers. Use when a framework project such as Astro, SvelteKit, React Router, TanStack Start, Nuxt, Hono, or a React or Vue SPA targets Cloudflare, or when a framework repository contains Workers deployment configuration.
---

# Build with frameworks on Cloudflare

Use the framework as the primary development interface and Cloudflare Workers as the deployment target. Serve static sites and SPA output with [Workers Static Assets](https://developers.cloudflare.com/workers/static-assets/index.md). Do not select Pages templates, Pages deployment commands, or Pages-specific presets for new applications. Preserve existing Pages deployments during unrelated maintenance.

## Route the project

1. Inspect the repository before changing it. Identify the framework, installed version, package manager, rendering mode, existing adapter, and Cloudflare configuration: `cloudflare.config.ts`, or `wrangler.jsonc`, `wrangler.json`, or `wrangler.toml`.
2. Preserve the user's framework choice. Determine whether the task starts a new project, adapts an existing project, or changes only application code.
3. Read only the matching row below, its Workers framework guide, and the framework's own agent guidance.
4. Set up the project for its state:
   - **New project:** follow the framework's Workers guide for project creation. The guides currently create the project with C3 and configure it for Wrangler; this is an exception to the `cloudflare` skill's default of `cf` for new projects, because the `cf` docs do not yet cover creating framework projects. After creation, the project has Wrangler configuration, so the next bullet applies.
   - **Existing project with Wrangler configuration:** keep Wrangler and load the `wrangler` skill. Follow the framework guide for adapter and configuration changes. Do not run `cf init .`, `cf dev`, `cf build`, or `cf deploy` in it.
   - **Existing project with no Cloudflare configuration:** use `cf`, which detects supported frameworks and configures them; see [Start from an existing project](https://developers.cloudflare.com/cf/get-started/first-worker/index.md#start-from-an-existing-project) and the `cf-cli` skill. Detection does not mean the project builds. If the build fails or the framework is not supported, follow the framework guide's manual setup.
5. Change only the adapter, runtime, build, and deployment configuration the integration requires. Inspect generated package scripts, run the framework's checks and build, then verify the Worker locally before deployment.

| Framework | Workers setup | Official upstream agent guidance |
| --- | --- | --- |
| Next.js | Load the `nextjs-on-cloudflare` skill. | Listed in that skill. |
| TanStack Start | Follow the [Workers guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/tanstack-start/index.md), which uses the Cloudflare Vite plugin. Distinguish Start from standalone TanStack Router. | Use [TanStack Intent](https://tanstack.com/intent/latest/docs/getting-started/quick-start-consumers) to discover and load installed package skills, including [Start's deployment guidance](https://github.com/TanStack/router/blob/main/packages/start-client-core/skills/start-core/deployment/SKILL.md). |
| React Router | Identify Framework, Data, or Declarative mode. Follow the [Workers guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/react-router/index.md) for full-stack setup. SPA mode is not supported with the Cloudflare Vite plugin, and prerendering has version requirements; check the guide before choosing either. | Load the official [React Router skill](https://github.com/remix-run/react-router/blob/main/.agents/skills/react-router/SKILL.md), its matching mode reference, and installed package docs when available. |
| SvelteKit | Follow the [Workers guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/sveltekit/index.md), which uses `@sveltejs/adapter-cloudflare`. | Use [Svelte's official skills](https://svelte.dev/docs/ai/skills) and [AI setup guidance](https://svelte.dev/docs/ai/instructions). |
| Hono | Choose an API-only Worker or a frontend plus API. The [Cloudflare guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/hono/index.md) covers Hono with a React SPA; use [Hono's Workers guide](https://hono.dev/docs/getting-started/cloudflare-workers) for an API-only app. | Load the application skill from [honojs/skills](https://github.com/honojs/skills). |
| Astro | Distinguish fully prerendered output from on-demand rendering: a static site deploys as static assets, and on-demand rendering uses `@astrojs/cloudflare`. Follow the [Workers guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/astro/index.md). | Use Astro's [official AI guidance and docs MCP](https://docs.astro.build/en/guides/build-with-ai/). |
| Nuxt | Follow the [Workers guide](https://developers.cloudflare.com/workers/framework-guides/web-apps/more-web-frameworks/nuxt/index.md) for the current Nitro integration and bindings. | Use the [Nuxt docs MCP](https://nuxt.com/docs/4.x/guide/ai/mcp); load the [Nuxt UI skill](https://ui.nuxt.com/getting-started/ai/mcp) only when using Nuxt UI. |
| React or Vue SPA | Follow the [React + Vite](https://developers.cloudflare.com/workers/framework-guides/web-apps/react/index.md) or [Vue](https://developers.cloudflare.com/workers/framework-guides/web-apps/vue/index.md) Workers guide. Distinguish a client-only SPA from a full-stack framework. | Use the chosen framework's official guidance for application development. |

For other frameworks, start from the [framework guides index](https://developers.cloudflare.com/workers/framework-guides/index.md).

## Skill feedback

If the user reports that this skill gave incorrect or outdated guidance, or is missing information, read [references/skill-feedback.md](references/skill-feedback.md).

© cloudflare · Apache-2.0 · cloudflare/skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
cloudflare-workers-frameworks secondsky Скилл cloudflare-workers-frameworks подсказывает агенту, как поднять Hono, Remix, Next.js, Astro, SvelteKit, Qwik или Nuxt на Cloudflare Workers, и разбирает типовые ошибки сборки. CX Codex +1 328установок cloudflare-pages devops-skills Разворачивает статические сайты и fullstack-приложения на Cloudflare Pages. Помогает настроить edge-функции и превью для веток. CX Codex +1 371установок assuredworkloads-frameworks-navigator официальный google Скилл assuredworkloads-frameworks-navigator для Claude Code, Gemini CLI и Codex сопоставляет требования к рабочей нагрузке с фреймворками Data Boundary в Google Cloud. CX Codex +1 191установок sentry-cloudflare-sdk getsentry Скилл sentry-cloudflare-sdk изучает проект Cloudflare и помогает настроить Sentry: мониторинг ошибок, трассировку и дополнительные функции наблюдаемости. CX Codex +1 2 800установок cloudflare-troubleshooting daymade Скилл cloudflare-troubleshooting для диагностики конфигурации Cloudflare через API: находит причину редирект-петель, ошибок SSL и DNS, а не гадает. CX Codex +1 1 000установок cloudflare-tunnel okou-ai Скилл cloudflare-tunnel для запросов к сервисам за Cloudflare Access через заголовки аутентификации. CX Codex +1 912установок

Из того же набора23

Весь набор →
k2 Скилл k2 для Claude Code помогает настраивать и диагностировать Cloudflare K2 и K2 Streams. Он подключается к задачам по созданию потоков, записи и чтению событий. CX Codex +1 37 900установок basin Скилл для построения и отладки аналитических workflows в Cloudflare Basin. Помогает потокировать данные в R2 Iceberg-таблицы, управлять каталогами и выполнять распределённые SQL-запросы. CX Codex +1 37 800установок workers-profiling Скилл workers-profiling для анализа использования CPU и памяти в развёрнутых Cloudflare Workers и Durable Objects. Помогает найти узкие места в коде и предложить оптимизацию. CX Codex +1 30 100установок cf-cli Скилл cf-cli для Claude Code помогает агенту находить и запускать команды Cloudflare через cf и выбирать между cf и Wrangler. Из терминала он работает с Workers и ресурсами Cloudflare. CX Codex +1 29 100установок gateway-workers Скилл gateway-workers для разработки, отладки и ревью Cloudflare Workers, которые запускаются в Forward-действиях Gateway HTTP-политик. Помогает работать с GatewayMiddleware, типами контекста и продолжением запроса. CX Codex +1 25 500установок workers-development Скилл workers-development для Claude Code помогает запускать и отлаживать Cloudflare Workers локально и разбирать production-сбои. Включается по запросу о запуске или диагностике Worker. CX Codex +1 8 200установок cloudflare-app-bootstrap Скилл cloudflare-app-bootstrap для Claude Code связывает привязки, секреты и начальные данные Cloudflare Workers для проверки локальных запросов. CX Codex +1 8 000установок cloudflare Набор навыков и встроенный MCP-сервер для разработки под стек Cloudflare в Claude Code. Помогает настраивать Workers, Durable Objects, хранилища и правила безопасности. ★ 3 424звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой