Add automatic Cloudflare skills installation for AI coding agents

[dario-piotrowicz]

Fixes https://jira.cfdata.org/browse/DEVX-2607

Wrangler now detects AI coding agent configuration directories (e.g. Claude Code, Cursor, Cline, Gemini CLI, OpenCode) and offers to install Cloudflare skill files from the cloudflare/skills GitHub repository. Users are prompted once interactively; subsequent runs skip the prompt. Use --experimental-force-skills-install (alias --x-force-skills-install) to install without prompting.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: self-explanatory UX improvement

A picture of a cute animal (not mandatory, but encouraged)

[changeset-bot]

🦋 Changeset detected

Latest commit: 861eb4a

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

✅ All changesets look good

[ask-bonk]

I'm Bonk, and I've done a quick review of your PR.

Review posted successfully on PR #13846 with two findings:

1. Network call before CI/interactivity checks (high severity) — downloadSkillsToTempDir() runs before the ci.isCI and isInteractive() guards. In CI or non-interactive environments where no metadata file exists yet but agent config dirs are present, this makes an unnecessary HTTP request to GitHub on every first invocation, adding latency before discarding the result. Suggestion posted to move the cheap checks before the download at agents-skills-install.ts:63-101.

2. Missing hidden: true on the global flag (low severity) — The experimental-force-skills-install option is missing hidden: true unlike the other experimental flags, so it will appear in --help output for every wrangler command. Suggestion posted at index.ts:533.

github run

[pkg-pr-new]

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@13846

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@13846

miniflare

npm i https://pkg.pr.new/miniflare@13846

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@13846

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@13846

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@13846

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@13846

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@13846

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@13846

wrangler

npm i https://pkg.pr.new/wrangler@13846

commit: 861eb4a

[workers-devprod]

Codeowners approval required for this PR:

• @cloudflare/wrangler

Show detailed file reviewers

• .changeset/agents-skills-install.md: [@cloudflare/wrangler]
• packages/wrangler/package.json: [@cloudflare/wrangler]
• packages/wrangler/src/tests/agents-skills-install.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/experimental-commands-api.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/register-yargs-command-skills.test.ts: [@cloudflare/wrangler]
• packages/wrangler/src/tests/vitest.setup.ts: [@cloudflare/wrangler]
• packages/wrangler/src/agents-skills-install.ts: [@cloudflare/wrangler]
• packages/wrangler/src/core/register-yargs-command.ts: [@cloudflare/wrangler]
• packages/wrangler/src/dev.ts: [@cloudflare/wrangler]
• packages/wrangler/src/index.ts: [@cloudflare/wrangler]
• packages/wrangler/src/metrics/send-event.ts: [@cloudflare/wrangler]
• packages/wrangler/src/yargs-types.ts: [@cloudflare/wrangler]
• pnpm-lock.yaml: [@cloudflare/wrangler]

[devin-ai-integration]

Devin Review found 2 potential issues.

View 5 additional findings in Devin Review.