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

scripts/test-upload.sh

View on GitHub
#!/usr/bin/env bash

# Test Upload Script - Cloudflare Images
# Tests API connectivity with a sample image upload
#
# Secrets loading: .env is sourced into the current shell only (set -a / set +a),
# not splashed into the environment of every child process via `export $(xargs)`.
# This avoids leaking CF_API_TOKEN into `ps`/child envs and respects shell
# quoting in the .env file. Secrets are unset at end of script.
# Your .env file should be mode 0600 (chmod 600 .env) since it holds API tokens.

set -e

# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color

# Load environment variables from .env if it exists.
# Use POSIX sourcing (set -a) rather than the legacy xargs-based export
# pattern so values with spaces, quotes, or special chars are handled
# correctly and we never pipe secret material through xargs.
if [ -f .env ]; then
  set -a
  . ./.env
  set +a
fi

# Check required environment variables
if [ -z "$CF_ACCOUNT_ID" ]; then
  echo -e "${RED}Error: CF_ACCOUNT_ID not set${NC}"
  echo "Set it in .env or export CF_ACCOUNT_ID=your_account_id"
  exit 1
fi

if [ -z "$CF_API_TOKEN" ]; then
  echo -e "${RED}Error: CF_API_TOKEN not set${NC}"
  echo "Set it in .env or export CF_API_TOKEN=your_api_token"
  exit 1
fi

# Check if test image exists
TEST_IMAGE="${1:-test-image.jpg}"

if [ ! -f "$TEST_IMAGE" ]; then
  echo -e "${YELLOW}No test image found. Creating a 1x1 pixel test image...${NC}"

  # Create a minimal test image (1x1 pixel JPEG)
  echo -e "${YELLOW}Creating test-image.jpg...${NC}"
  echo '/9j/4AAQSkZJRgABAQEASABIAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEB' | base64 -d > test-image.jpg
  TEST_IMAGE="test-image.jpg"
fi

echo -e "${GREEN}Testing Cloudflare Images API...${NC}\n"

# Test 1: Upload image
echo -e "${YELLOW}Test 1: Uploading test image ($TEST_IMAGE)...${NC}"

RESPONSE=$(curl -s -w "\n%{http_code}" -X POST \
  "https://api.cloudflare.com/client/v4/accounts/${CF_ACCOUNT_ID}/images/v1" \
  -H "Authorization: Bearer ${CF_API_TOKEN}" \
  -F "file=@${TEST_IMAGE}")

HTTP_CODE=$(echo "$RESPONSE" | tail -n 1)
BODY=$(echo "$RESPONSE" | sed '$d')

if [ "$HTTP_CODE" -eq 200 ]; then
  echo -e "${GREEN}✓ Upload successful (HTTP $HTTP_CODE)${NC}"

  # Extract image ID
  IMAGE_ID=$(echo "$BODY" | grep -o '"id":"[^"]*"' | head -1 | cut -d'"' -f4)

  if [ -n "$IMAGE_ID" ]; then
    echo -e "${GREEN}  Image ID: $IMAGE_ID${NC}\n"

    # Test 2: Verify image is accessible
    echo -e "${YELLOW}Test 2: Verifying image accessibility...${NC}"

    # Get account hash from response
    ACCOUNT_HASH=$(echo "$BODY" | grep -o '"accountHash":"[^"]*"' | cut -d'"' -f4)

    if [ -n "$ACCOUNT_HASH" ]; then
      IMAGE_URL="https://imagedelivery.net/${ACCOUNT_HASH}/${IMAGE_ID}/public"

      # Try to fetch the image
      IMAGE_HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$IMAGE_URL")

      if [ "$IMAGE_HTTP_CODE" -eq 200 ]; then
        echo -e "${GREEN}✓ Image accessible at: $IMAGE_URL${NC}\n"
      else
        echo -e "${RED}✗ Image not accessible (HTTP $IMAGE_HTTP_CODE)${NC}\n"
      fi
    fi

    # Test 3: Delete test image (cleanup)
    echo -e "${YELLOW}Test 3: Cleaning up (deleting test image)...${NC}"

    DELETE_RESPONSE=$(curl -s -w "\n%{http_code}" -X DELETE \
      "https://api.cloudflare.com/client/v4/accounts/${CF_ACCOUNT_ID}/images/v1/${IMAGE_ID}" \
      -H "Authorization: Bearer ${CF_API_TOKEN}")

    DELETE_HTTP_CODE=$(echo "$DELETE_RESPONSE" | tail -n 1)

    if [ "$DELETE_HTTP_CODE" -eq 200 ]; then
      echo -e "${GREEN}✓ Test image deleted${NC}\n"
    else
      echo -e "${YELLOW}⚠ Could not delete test image (HTTP $DELETE_HTTP_CODE)${NC}"
      echo -e "${YELLOW}  You may need to delete it manually: $IMAGE_ID${NC}\n"
    fi

    echo -e "${GREEN}═══════════════════════════════════════${NC}"
    echo -e "${GREEN}All tests passed! ✓${NC}"
    echo -e "${GREEN}Cloudflare Images API is working correctly.${NC}"
    echo -e "${GREEN}═══════════════════════════════════════${NC}"

  else
    echo -e "${RED}✗ Could not extract image ID from response${NC}"
    echo -e "${YELLOW}Response: $BODY${NC}"
    exit 1
  fi
else
  echo -e "${RED}✗ Upload failed (HTTP $HTTP_CODE)${NC}"
  echo -e "${YELLOW}Response: $BODY${NC}"
  exit 1
fi

# Drop secrets from the shell environment now that the curl calls are done.
unset CF_ACCOUNT_ID CF_API_TOKEN
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