Skip to content

secondsky/claude-skills / plugins/cloudflare-images/skills/cloudflare-images

cloudflare-images

Unverified

This skill should be used when the user asks to "upload images to Cloudflare", "implement direct creator upload", "configure image transformations", "optimize WebP/AVIF", "create image variants", "generate signed URLs", "add image watermarks", "integrate with Next.js/Remix", "configure webhooks", "debug CORS errors", "troubleshoot error 5408/9401-9413", or "build responsive images with Cloudflare Images API".

FileKindSize
SKILL.mdskill md13.9 KB
assets/diagrams/direct-upload-workflow.mdmarkdown5.0 KB
assets/diagrams/transformation-pipeline.mdmarkdown8.2 KB
assets/diagrams/variants-structure.mdmarkdown10.6 KB
examples/basic-upload/.env.exampleother474 B
examples/basic-upload/README.mdmarkdown6.5 KB
examples/basic-upload/package.jsonmanifest542 B
examples/basic-upload/public/index.htmlother12.7 KB
examples/basic-upload/src/index.tsscript2.7 KB
examples/basic-upload/wrangler.jsoncother378 B
examples/private-images/.env.exampleother631 B
examples/private-images/README.mdmarkdown12.5 KB
examples/private-images/package.jsonmanifest741 B
examples/private-images/public/index.htmlother18.0 KB
examples/private-images/src/index.tsscript5.2 KB
examples/private-images/wrangler.jsoncother427 B
examples/responsive-gallery/README.mdmarkdown4.3 KB
references/api-reference.mdmarkdown8.1 KB
references/content-credentials.mdmarkdown11.6 KB
references/custom-domains.mdmarkdown10.5 KB
references/direct-upload-complete-workflow.mdmarkdown11.2 KB
references/format-optimization.mdmarkdown7.2 KB
references/framework-integration.mdmarkdown15.4 KB
references/overlays-watermarks.mdmarkdown11.1 KB
references/polish-compression.mdmarkdown10.4 KB
references/responsive-images-patterns.mdmarkdown6.1 KB
references/setup-guide.mdmarkdown3.8 KB
references/signed-urls-guide.mdmarkdown7.5 KB
references/sourcing-kit.mdmarkdown15.0 KB
references/top-errors.mdmarkdown11.7 KB
references/transformation-options.mdmarkdown6.4 KB
references/variants-guide.mdmarkdown6.7 KB
references/webhooks-guide.mdmarkdown11.8 KB
scripts/analyze-usage.shexecutablescript6.6 KB
scripts/check-versions.shexecutablescript3.3 KB
scripts/generate-signed-url.shexecutablescript4.4 KB
scripts/test-upload.shexecutablescript4.4 KB
scripts/validate-variants.shexecutablescript5.2 KB
templates/batch-upload.tsscript7.8 KB
templates/direct-creator-upload-backend.tsscript5.4 KB
templates/direct-creator-upload-frontend.htmlother8.4 KB
templates/nextjs-integration.tsxother11.4 KB
templates/overlay-watermark.tsscript13.7 KB
templates/package.jsonmanifest387 B
templates/remix-integration.tsxother15.0 KB
templates/responsive-images-srcset.htmlother8.0 KB
templates/signed-urls-generation.tsscript6.6 KB
templates/transform-via-url.tsscript6.5 KB
templates/transform-via-workers.tsscript8.7 KB
templates/upload-api-basic.tsscript3.8 KB
templates/upload-via-url.tsscript4.9 KB
templates/variants-management.tsscript7.0 KB
templates/webhook-handler.tsscript8.8 KB
templates/wrangler-images-binding.jsoncother1.2 KB

references/setup-guide.md

View on GitHub
# Cloudflare Images Complete Setup Guide

Quick setup walkthrough for Cloudflare Images API and Transformations.

---

## Step 1: Enable Cloudflare Images

1. Log into Cloudflare Dashboard
2. Navigate to **Images**
3. Click **Enable**
4. Note your **Account ID** and **Account Hash**

---

## Step 2: Create API Token

1. Go to **API Tokens** in dashboard
2. Click **Create Token**
3. Grant **Cloudflare Images: Edit** permission
4. Save token securely (it won't be shown again)

**Required permissions:**
- Cloudflare Images: Edit

---

## Step 3: Upload First Image

### Via cURL:

```bash
curl --request POST \
  --url https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/images/v1 \
  --header 'Authorization: Bearer <API_TOKEN>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'file=@./photo.jpg'
```

### Via TypeScript:

```typescript
const formData = new FormData();
formData.append('file', file);

const response = await fetch(
  `https://api.cloudflare.com/client/v4/accounts/${ACCOUNT_ID}/images/v1`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    },
    body: formData
  }
);

const { result } = await response.json();
console.log('Image ID:', result.id);
console.log('URL:', result.variants[0]);
```

---

## Step 4: Serve Images

**Public images:**

```html
<img src="https://imagedelivery.net/<ACCOUNT_HASH>/<IMAGE_ID>/public" />
```

**With transformations:**

```html
<img src="https://imagedelivery.net/<ACCOUNT_HASH>/<IMAGE_ID>/width=800" />
```

---

## Step 5: Enable Image Transformations

For transforming any image (not just uploaded ones):

1. Dashboard → **Images** → **Transformations**
2. Select your zone (domain)
3. Click **Enable for zone**

Now you can transform any image on your domain:

```html
<img src="/cdn-cgi/image/width=800,quality=85/uploads/photo.jpg" />
```

---

## Step 6: Create Variants (Optional)

Variants are predefined transformations:

1. Dashboard → **Images** → **Variants**
2. Click **Create variant**
3. Name: `thumbnail` (or any name)
4. Configure: width=200, height=200, fit=cover
5. Save

Use in URLs:

```html
<img src="https://imagedelivery.net/<ACCOUNT_HASH>/<IMAGE_ID>/thumbnail" />
```

---

## Step 7: Direct Creator Upload (User Uploads)

For allowing users to upload without exposing API keys:

### Backend:

```typescript
const response = await fetch(
  `https://api.cloudflare.com/client/v4/accounts/${ACCOUNT_ID}/images/v2/direct_upload`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  }
);

const { result } = await response.json();
const uploadURL = result.uploadURL;

// Send uploadURL to frontend
return new Response(JSON.stringify({ uploadURL }));
```

### Frontend:

```typescript
const formData = new FormData();
formData.append('file', file);

await fetch(uploadURL, {
  method: 'POST',
  body: formData
});
```

**Load `references/direct-upload-complete-workflow.md` for complete implementation.**

---

## Production Checklist

- [ ] API token created and stored securely
- [ ] Account ID and Account Hash documented
- [ ] Direct upload CORS configured (if using from browser)
- [ ] Variants created for common sizes
- [ ] Image Transformations enabled for zones (if needed)
- [ ] Signed URLs configured for private images (if needed)
- [ ] Error handling implemented
- [ ] Rate limiting configured
- [ ] Batch upload logic implemented (if needed)
- [ ] Responsive images with srcset configured

---

## Official Documentation

- **Images Overview**: https://developers.cloudflare.com/images/
- **Upload API**: https://developers.cloudflare.com/images/upload-images/
- **Transformations**: https://developers.cloudflare.com/images/transform-images/
- **Direct Creator Upload**: https://developers.cloudflare.com/images/upload-images/direct-creator-upload/
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall