workers-development — скилл для Claude Code: отладка Workers
Скилл workers-development для Claude Code помогает запускать и отлаживать Cloudflare Workers локально и разбирать production-сбои. Включается по запросу о запуске или диагностике Worker.
Apache-2.0 8 200 установок ★ 3 424 обновлён 2026-10-19
npx skills add cloudflare/skills --skill workers-development -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/workers-development/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/workers-development/
1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill workers-development -a codex2Вручную: положить файлы
.agents/skills/workers-development/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill workers-development -a cursor2Вручную: положить файлы
.cursor/skills/workers-development/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cloudflare/skills skills/workers-development2Вручную: положить файлы
.github/skills/workers-development/SKILL.md1Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill workers-development -a gemini-cli2Командой платформы
gemini skills install https://github.com/cloudflare/skills --path skills/workers-developmentВручную: положить файлы
.devin/skills/workers-development/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cloudflare/skills --skill workers-development -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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