# Cloudflare Guide

> Use this skill when the user asks about "Cloudflare Workers", "Cloudflare Pages", "Wrangler configuration", "R2", "D1", "KV", "Durable Objects", "Workers AI", or any Cloudflare deployment/development question. It uses the cloudflare-docs-fetcher agent to fetch official documentation, keeping the main context clean.

- Skill: `tomevault-io/cloudflare-guide` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/cloudflare-guide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/cloudflare-guide/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/cloudflare-guide

---


# Cloudflare Development Assistant

## Core Principle

**Use the `cloudflare-docs-fetcher` agent to fetch and analyze official Cloudflare documentation.**

This keeps the main conversation context clean while ensuring answers are based on the latest official documentation.

## How to Use

When a user asks a Cloudflare-related question, spawn the `cloudflare-docs-fetcher` agent:

```
Task(
  subagent_type: "general-purpose",
  description: "Fetch Cloudflare docs for [brief topic]",
  prompt: "User question: [THE EXACT USER QUESTION]"
)
```

The agent will:
1. Determine which official docs URL to fetch
2. Fetch and analyze the documentation
3. Return a concise answer with exact syntax from the docs

## When to Trigger

Trigger this skill when the user mentions:
- **Workers**: runtime, handlers, bindings, Wrangler
- **Pages**: deployment, build config, Pages Functions
- **Storage**: R2, D1, KV, Durable Objects, Queues
- **AI**: Workers AI, AI Gateway, Agents SDK, Vectorize
- **Config**: `wrangler.toml`, `wrangler.jsonc`, compatibility flags
- **Deployment**: `wrangler deploy`, `wrangler dev`, environments

## Quick Commands (No Fetch Needed)

These common commands don't require documentation lookup:

```bash
# Create new project
npm create cloudflare@latest

# Local development  
npx wrangler dev

# Deploy
npx wrangler deploy        # Workers
npx wrangler pages deploy  # Pages

# Manage secrets
npx wrangler secret put <KEY>

# D1 database
npx wrangler d1 create <NAME>
npx wrangler d1 execute <DB> --command "SQL"

# KV namespace
npx wrangler kv:namespace create <NAME>

# R2 bucket
npx wrangler r2 bucket create <NAME>
```

## Example Interaction

**User**: "How do I add a D1 database binding to my Worker?"

**Your action**:
```
Task(
  subagent_type: "general-purpose", 
  description: "Fetch D1 binding docs",
  prompt: "User question: How do I add a D1 database binding to my Worker?"
)
```

**Agent returns** (concise answer with exact wrangler.toml syntax)

**You**: Provide the answer to the user, citing the official source.

## What NOT to Do

1. ❌ **Don't WebFetch in main process** - Use the agent to keep context clean
2. ❌ **Don't guess config syntax** - Let the agent fetch current docs
3. ❌ **Don't skip for "simple" questions** - Cloudflare APIs change frequently

## Additional Resources

- **`../agents/cloudflare-docs-fetcher.md`** - The agent that fetches official docs
- **`references/official-sources.md`** - Complete URL index

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/royisme) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->