How do I install the Cloudflare skill?

Run npx skillmds@latest add kai-cli/cloudflare in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cloudflare safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cloudflare?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cloudflare free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cloudflare?

kai-cli (@kai-cli) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cloudflare by kai-cli — Agent Skill

Name: Cloudflare
Author: kai-cli

File contents

Customization

Before executing, check for user customizations at: ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/Cloudflare/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

Output text notification:

Running the **WorkflowName** workflow in the **Cloudflare** skill to ACTION...

This is not optional. Execute this curl command immediately upon skill invocation.

Cloudflare Skill

Deploy and manage Cloudflare Workers, MCP servers, and Pages.

Workflow Routing

When executing a workflow, output this notification directly:

Running the **WorkflowName** workflow in the **Cloudflare** skill to ACTION...

Create MCP server or Worker → Workflows/Create.md
Troubleshoot deployment issues → Workflows/Troubleshoot.md

Quick Reference

Account ID: Set via CF_ACCOUNT_ID environment variable
Worker URL format: https://[worker-name].[your-subdomain].workers.dev

Deployment Commands

Workers Deployment

# Unset tokens that interfere with wrangler login-based auth
(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && wrangler deploy)

Pages Deployment

🚨 CRITICAL: ALL env tokens lack Pages permissions. MUST unset them to use OAuth:

# ALWAYS unset tokens for Pages - OAuth login works, tokens don't
(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && npx wrangler pages deploy dist --project-name=PROJECT_NAME --commit-dirty=true)

Known Pages Projects:

Project	Directory	Deploy Command
[project]	`~/Projects/[project]`	`(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && npx wrangler pages deploy dist --project-name=[project] --commit-dirty=true)`

Critical Notes

Workers: Unset CF_API_TOKEN and CLOUDFLARE_API_TOKEN before deploying - they interfere with wrangler login-based auth
Pages: 🚨 UNSET ALL TOKENS - None of the API tokens have Pages permissions. OAuth-based wrangler login is the ONLY method that works.

Examples

Example 1: Deploy a Worker

User: "deploy the MCP server to Cloudflare"
→ Invokes CREATE workflow
→ Unsets env tokens, runs wrangler deploy
→ "Deployed to https://mcp-server.[subdomain].workers.dev"

Example 2: Deploy Pages site

User: "deploy my-app to Cloudflare"
→ Builds dist/, unsets tokens
→ Runs wrangler pages deploy
→ "Deployed my-app to Cloudflare Pages"

Example 3: Fix deployment error

User: "Cloudflare deploy is failing with auth error"
→ Invokes TROUBLESHOOT workflow
→ Identifies token interference
→ "Fixed - tokens were overriding OAuth. Redeployed successfully."

---name: cloudflaredescription: Deploy Cloudflare Workers/Pages. USE WHEN Cloudflare, worker, deploy, Pages, MCP server. SkillSearch('cloudflare') for docs.---## Customization**Before executing, check for user customizations at:**`~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/Cloudflare/`If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.2. **Output text notification**: ``` Running the **WorkflowName** workflow in the **Cloudflare** skill to ACTION... ```**This is not optional. Execute this curl command immediately upon skill invocation.**# Cloudflare SkillDeploy and manage Cloudflare Workers, MCP servers, and Pages.## Workflow Routing**When executing a workflow, output this notification directly:**```Running the **WorkflowName** workflow in the **Cloudflare** skill to ACTION...``` - **Create** MCP server or Worker → `Workflows/Create.md` - **Troubleshoot** deployment issues → `Workflows/Troubleshoot.md`## Quick Reference- **Account ID:** Set via `CF_ACCOUNT_ID` environment variable- **Worker URL format:** `https://[worker-name].[your-subdomain].workers.dev`## Deployment Commands### Workers Deployment```bash# Unset tokens that interfere with wrangler login-based auth(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && wrangler deploy)```### Pages Deployment**🚨 CRITICAL: ALL env tokens lack Pages permissions. MUST unset them to use OAuth:**```bash# ALWAYS unset tokens for Pages - OAuth login works, tokens don't(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && npx wrangler pages deploy dist --project-name=PROJECT_NAME --commit-dirty=true)```**Known Pages Projects:**| Project | Directory | Deploy Command ||---------|-----------|----------------|| [project] | `~/Projects/[project]` | `(unset CF_API_TOKEN && unset CLOUDFLARE_API_TOKEN && npx wrangler pages deploy dist --project-name=[project] --commit-dirty=true)` |## Critical Notes- **Workers:** Unset `CF_API_TOKEN` and `CLOUDFLARE_API_TOKEN` before deploying - they interfere with wrangler login-based auth- **Pages:** 🚨 **UNSET ALL TOKENS** - None of the API tokens have Pages permissions. OAuth-based wrangler login is the ONLY method that works.## Examples**Example 1: Deploy a Worker**```User: "deploy the MCP server to Cloudflare"→ Invokes CREATE workflow→ Unsets env tokens, runs wrangler deploy→ "Deployed to https://mcp-server.[subdomain].workers.dev"```**Example 2: Deploy Pages site**```User: "deploy my-app to Cloudflare"→ Builds dist/, unsets tokens→ Runs wrangler pages deploy→ "Deployed my-app to Cloudflare Pages"```**Example 3: Fix deployment error**```User: "Cloudflare deploy is failing with auth error"→ Invokes TROUBLESHOOT workflow→ Identifies token interference→ "Fixed - tokens were overriding OAuth. Redeployed successfully."```

Frequently asked questions

Cloudflare