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

workers-development — скилл для Claude Code: отладка Workers

Скилл workers-development для Claude Code помогает запускать и отлаживать Cloudflare Workers локально и разбирать production-сбои. Включается по запросу о запуске или диагностике Worker.

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

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

Что делает workers-development

Скилл помогает запускать Cloudflare Workers существующей командой проекта: cf dev, скриптом Wrangler или Cloudflare Vite plugin. Для локальных привязок он использует Local Explorer: там можно читать и заполнять данные KV, R2, D1, SQLite-backed Durable Objects и Workflows, а также запускать Cron-обработчики.

Local Explorer собирает трассировки и логи локальных вызовов, включая операции с привязками. Для Worker в production скилл направляет отладку к Workers observability: там доступны логи, трассировки и метрики. Если к проекту подключён Cloudflare MCP server, его можно использовать для поиска и вызова операций Workers Observability API.

Привязка с remote: true обращается к настоящему production-ресурсу даже при локальном запуске Worker; такие вызовы тоже попадают в трассировки.

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

  • запустить Worker локальной командой проекта
  • прочитать или заполнить данные локальных привязок
  • найти трассировку и логи локального запроса
  • разобрать логи, трассировки или метрики Worker в production
  • запустить Cron-обработчик локально

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

  • Запусти мой Cloudflare Worker локально и проверь запрос, который возвращает ошибку.
  • Посмотри трассировки локального Worker и найди операции с привязками.
  • Разбери логи и метрики развёрнутого Worker за нужный период.

Как установить workers-development

1Через Skills CLI (Vercel)

npx skills add cloudflare/skills --skill workers-development -a claude-code

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

~/.claude/skills/workers-development/SKILL.md

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

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

Вопросы о workers-development

Как установить workers-development в Claude Code?

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

Что делает workers-development?

Помогает запускать и отлаживать Cloudflare Workers локально через инструменты проекта, а для production направляет к Workers observability. Local Explorer позволяет изучать данные привязок, трассировки и логи.

Что произойдёт, если локальная привязка настроена как remote?

Worker обратится к реальному развёрнутому ресурсу, а вызов появится в трассировках. Скилл предлагает определить такие привязки до чтения или записи данных.

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

SKILL.md · Apache-2.0
---
name: workers-development
description: Run, inspect, and debug Cloudflare Workers during local development with cf dev, wrangler dev, or the Cloudflare Vite plugin, using Local Explorer to read and seed binding data and query local traces and logs. Also routes production debugging to Workers observability. Use for debugging requests whether or not the project uses Wrangler.
---

# Workers development and debugging

Use the project's existing tooling, scripts, and configuration. Installed help, the Local Explorer API schema, and current docs describe the supported operations; read them rather than guessing endpoints or flags.

| Need | Tools and discovery |
| --- | --- |
| Run locally | Use the project's existing dev command: `cf dev` in a `cf` project, otherwise the Wrangler or Cloudflare Vite dev script. See [local development](https://developers.cloudflare.com/workers/local-development/index.md). |
| Inspect or seed local binding data | [Local Explorer](https://developers.cloudflare.com/workers/local-development/local-explorer/index.md) is a UI and API for local KV, R2, D1, SQLite-backed Durable Objects, and Workflows, and can trigger Cron handlers. Open `/cdn-cgi/local/explorer` on the dev server's origin. |
| Debug local requests | Local Explorer captures traces and logs from every local invocation, including binding operations, without code changes. Check traces before adding logging. |
| Debug a deployed Worker | Choose logs, traces, or metrics with [Workers observability](https://developers.cloudflare.com/workers/observability/index.md), or the `cloudflare` skill's observability reference when installed. If the Cloudflare MCP server is connected (bundled with this plugin), use `search` to find the [Workers Observability API](https://developers.cloudflare.com/api/resources/workers/subresources/observability/index.md) operations, then `execute` to call them, scoped to the target account, Worker, and time window. |

## Use the Local Explorer API

When the dev server detects an AI agent, including under `cf dev`, it prints a hint with the API URL and relevant endpoints. Fetch the OpenAPI specification from `/cdn-cgi/local/explorer/api` on the dev server's origin, then extract only the operations the task needs. If no hint appears, request that URL directly. If the API or an operation is missing, compare the installed Wrangler or Vite plugin version against the requirements in the Local Explorer docs.

Bindings are simulated locally by default, but a binding set to `remote: true` reaches the real deployed resource while the Worker runs locally. Traces also capture those remote calls. Identify which bindings are remote before seeding or writing data.

## 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

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

Все скиллы по теме «Бэкенд и API» →
cloudflare-workers devops-skills Помогает писать и деплоить edge-функции на Cloudflare Workers через Wrangler. Закрывает API, cron-задачи и middleware. CX Codex +1 352установок cloudflare-workers-observability secondsky Скилл cloudflare-workers-observability для Claude Code: наблюдаемость Cloudflare Workers — структурированные логи, Analytics Engine, Tail Workers, метрики, алерты. Разбирает падение воркера в проде без видимых логов. CX Codex +1 322установок cloudflare-workers-performance secondsky Скилл cloudflare-workers-performance для Claude Code, Codex, Cursor и других редакторов помогает ускорить Cloudflare Workers, снизить задержки и уложиться в лимиты CPU. CX Codex +1 337установок cloudflare-knowledge JosiahSiegel Скилл cloudflare-knowledge для Claude Code открывает справочные файлы о Workers, Pages, R2, D1, Workers AI и Zero Trust для настройки Cloudflare. CX Codex +1 139установок cloudflare-deploy github.com/openai/skills Скилл cloudflare-deploy для Claude Code, который берёт на себя деплой приложений и инфраструктуры на Cloudflare через Workers, Pages и связанные сервисы. Активируется, когда нужно опубликовать, захостить или настроить проект на платформе. CX Codex +1 ★ 7 191звёзд репо cloudflare sanjeed5 Задаёт стандарты разработки под Cloudflare Workers и Pages в Cursor. Помогает писать stateless-код для edge-рантайма, подключать базы данных и следить за размером бандла. CX Codex +1 ★ 3 589звёзд репо

Из того же набора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установок frameworks-on-cloudflare Скилл frameworks-on-cloudflare для Claude Code помогает собирать и переносить веб-приложения на Cloudflare Workers. Включается, когда проект на Astro, SvelteKit, Nuxt или другом поддерживаемом фреймворке нацелен на Workers. CX Codex +1 8 100установок 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звёзд репо

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

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