Cloudflare Manager

--- name: Cloudflare Manager description: Comprehensive Cloudflare account management for deploying Workers, KV Storage, R2, Pages, DNS, and Routes. Use when deploying cloudflare services, managing worker containers, configuring KV/R2 storage, or setting up DNS/routing. Requires CLOUDFLAREAPIKEY in .env and Bun runtime with dependencies installed. --- # Cloudflare Manager Comprehensive Cloudflare service management skill that enables deployment and configuration of Workers, KV Storage, R2 buckets, Pages, DNS records, and routing. Automatically validates API credentials, extracts deployment URLs, and provides actionable error messages. ## Initial Setup Before using this skill for the first time: 1. Install Dependencies ``bash cd ~/.claude/skills/cloudflare-manager bun install ` 2. **Configure API Key** Create a .env file in your project root: `bash CLOUDFLARE_API_KEY=your_api_token_here CLOUDFLARE_ACCOUNT_ID=your_account_id # Optional, auto-detected ` **Getting your API token**: - Visit https://dash.cloudflare.com/profile/api-tokens - Click "Create Token" - Use "Edit Cloudflare Workers" template (or create custom token) - Required permissions: - Account > Workers Scripts > Edit - Account > Workers KV Storage > Edit - Account > Workers R2 Storage > Edit - Account > Cloudflare Pages > Edit - Zone > DNS > Edit (if using custom domains) 3. **Validate Credentials** Run validation to verify your API key and check permissions: `bash cd ~/.claude/skills/cloudflare-manager bun scripts/validate-api-key.ts ` **Expected output**: ` ✅ API key is valid! ℹ️ Token Status: active ℹ️ Account: Your Account Name (abc123...) 🔑 Granted Permissions: ✅ Workers Scripts: Edit ✅ Workers KV Storage: Edit ✅ Workers R2 Storage: Edit ` **Troubleshooting validation**: - If validation fails with 401/403: Check your API token is correct in .env - If validation fails with network error: Check internet connection - Use --no-cache flag to force fresh validation: bun scripts/validate-api-key.ts --no-cache ## Current API Permissions <!-- PERMISSIONS_START --> Run bun scripts/validate-api-key.ts to populate this section with your current permissions. <!-- PERMISSIONS_END --> ## Quick Start Guide ### Deploy a Worker Container To deploy a new worker container sandbox: `bash # Using the skill bun scripts/workers.ts deploy worker-name ./worker-script.js ` **What happens**: - Creates new worker container - Deploys JavaScript/TypeScript code - Automatically extracts and returns Cloudflare-generated URL (e.g., https://worker-name.username.workers.dev) - Returns worker ID and configuration **Example conversation**: ` User: "Set up and deploy a new cloudflare worker container sandbox named 'api-handler' and return the URL" Claude: [Deploys worker using bun scripts/workers.ts deploy api-handler ./worker.js] Returns URL: https://api-handler.username.workers.dev ` **Exit codes**: - 0: Success - worker deployed and URL returned - 1: Failure - check error message for details **Performance**: Deployment typically completes in 2-5 seconds ### Create and Use KV Storage To create a KV namespace and store data: `bash # Create namespace bun scripts/kv-storage.ts create-namespace user-sessions # Returns: Namespace ID (e.g., abc123def456) # Save this ID for binding to workers # Write key-value pair bun scripts/kv-storage.ts write <namespace-id> "session:user123" '{"userId":"123","token":"abc"}' # Read value bun scripts/kv-storage.ts read <namespace-id> "session:user123" # Returns: {"userId":"123","token":"abc"} # List all keys (useful for debugging) bun scripts/kv-storage.ts list-keys <namespace-id> # Delete a key bun scripts/kv-storage.ts delete <namespace-id> "session:user123" ` **Important**: KV storage uses eventual consistency. Writes may take up to 60 seconds to propagate globally. For immediate reads, use the same edge location where you wrote the data. ### Create R2 Bucket and Upload Files To create an R2 bucket and manage objects: `bash # Create bucket bun scripts/r2-storage.ts create-bucket media-assets # Upload file bun scripts/r2-storage.ts upload media-assets ./images/logo.png logo.png # List objects bun scripts/r2-storage.ts list-objects media-assets # Download object bun scripts/r2-storage.ts download media-assets logo.png ./downloaded-logo.png ` ### Deploy to Cloudflare Pages To deploy a static site or application to Pages: ``bash # Create Pages project (or get existing project info) bun scripts/pages.ts deploy my-app ./dist # Returns: https://my-app.pages.dev # Set environment variable bun scripts/pages.ts set-env my-app API_URL https://api.example.com # Set environment variable for specific environment bun scripts/pages.ts set-env my-app DEBUG true --env preview # Get deployment URL bun scripts/pages.ts get-url my-app