wrangler

Run and troubleshoot Wrangler CLI commands for Cloudflare Workers deployment and configuration.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/jpmoya/claude-agents --skill wrangler-jpmoya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wrangler
Source: https://github.com/jpmoya/claude-agents/tree/main/skills/wrangler
Command: npx skills add https://github.com/jpmoya/claude-agents --skill wrangler-jpmoya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cloudflare Workers projects often break when developers rely on memorized Wrangler commands or outdated configuration syntax. This Skill ensures Wrangler CLI operations, config edits, and deployments use the project's actual installed version and current documentation, preventing misconfigurations, accidental resource changes, and failed deployments. ## Core Features & Use Cases - Version-Aware Command Execution: Inspects the project's package manager, installed Wrangler version, and config files, then runs commands through project scripts so flags match the local version. - Safe Configuration Changes: Edits wrangler.jsonc and bindings using the installed config schema, checks environment inheritance, and reconciles dashboard changes before deploying. - Deployment Validation: Uses wrangler deploy --dry-run, regenerates TypeScript types with wrangler types, and reports validation gaps. - Use Case: You need to add a KV binding to a staging environment. The Skill checks environment inheritance, verifies the resource identifier to avoid automatic provisioning, applies the change, and dry-runs the deploy. ## Quick Start Use the wrangler skill to add a KV namespace binding to my Worker's staging environment and validate the deploy with a dry run.

Frequently Asked Questions about wrangler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Cloudflare Worker with Wrangler?

Run wrangler deploy through the project's package scripts so it uses the locally installed Wrangler version. Validate first with wrangler deploy --dry-run using the intended config and environment, which checks the build and packaging without touching remote resources.

How do I add a binding to wrangler.jsonc?

Check the installed wrangler/config-schema.json under node_modules for fields supported by your version, then edit the config source rather than generated output. Verify environment inheritance and existing resource identifiers, since omitted identifiers can trigger automatic provisioning.

Does wrangler secret put deploy immediately?

Yes, wrangler secret put and secret delete create a version and deploy it immediately. Use the documented wrangler versions secret workflow when the secret change must be staged rather than deployed right away.

Why does my Wrangler command fail with unknown flags?

CLI flags and configuration fields change between Wrangler versions, so memorized syntax may not match your installed version. Check project-local wrangler --help and wrangler <command> --help, and avoid silently upgrading Wrangler to match current docs.

Can I use Wrangler with the Cloudflare Vite plugin environments?

Yes, select the environment via CLOUDFLARE_ENV at dev or build time with the Cloudflare Vite plugin. Deploy the resulting build directly, because setting an environment at deploy time does not retarget its flattened config.