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/analyze-usage.sh

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

# Analyze Usage Script - Cloudflare Images
# Query API for storage usage, delivered images, and estimated costs
#
# 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'
BLUE='\033[0;34m'
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

echo -e "${GREEN}Fetching Cloudflare Images Usage Stats...${NC}\n"

# Fetch usage stats
RESPONSE=$(curl -s -w "\n%{http_code}" -X GET \
  "https://api.cloudflare.com/client/v4/accounts/${CF_ACCOUNT_ID}/images/v1/stats" \
  -H "Authorization: Bearer ${CF_API_TOKEN}")

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

if [ "$HTTP_CODE" -ne 200 ]; then
  echo -e "${RED}✗ Failed to fetch usage stats (HTTP $HTTP_CODE)${NC}"
  echo -e "${YELLOW}Response: $BODY${NC}"
  exit 1
fi

# Parse stats using jq or fallback
if command -v jq &> /dev/null; then
  # Parse with jq
  TOTAL_STORED=$(echo "$BODY" | jq -r '.result.count.current // 0')
  TOTAL_ALLOWED=$(echo "$BODY" | jq -r '.result.count.allowed // 100000')

  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Storage Statistics${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${YELLOW}Images Stored:${NC}      $TOTAL_STORED"
  echo -e "${YELLOW}Storage Limit:${NC}      $TOTAL_ALLOWED"
  echo -e "${YELLOW}Storage Used:${NC}       $(echo "scale=2; $TOTAL_STORED * 100 / $TOTAL_ALLOWED" | bc)%"

  # Calculate estimated monthly cost (Images API pricing)
  # $5 per 100,000 images stored
  STORAGE_COST=$(echo "scale=2; $TOTAL_STORED / 100000 * 5" | bc)

  echo ""
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Estimated Monthly Costs${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${YELLOW}Storage Cost:${NC}       \$$STORAGE_COST (at \$5/100k stored)"

  # Note: Delivery cost requires analytics data which may not be available via stats API
  echo -e "${YELLOW}Delivery Cost:${NC}      Check Analytics dashboard"
  echo -e "${GREEN}                      (\$1/100k delivered)${NC}"

  echo ""
  echo -e "${YELLOW}Transformations:${NC}    Check Analytics dashboard"
  echo -e "${GREEN}                      (\$0.50/1k transforms)${NC}"
  echo -e "${GREEN}                      (100k/month free per zone)${NC}"

  echo ""
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Storage Quota Status${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"

  # Calculate remaining storage
  REMAINING=$(( TOTAL_ALLOWED - TOTAL_STORED ))
  PERCENT_USED=$(echo "scale=2; $TOTAL_STORED * 100 / $TOTAL_ALLOWED" | bc)

  if (( $(echo "$PERCENT_USED >= 90" | bc -l) )); then
    echo -e "${RED}⚠ WARNING: Storage quota at ${PERCENT_USED}%!${NC}"
    echo -e "${RED}   Only $REMAINING images remaining.${NC}"
    echo -e "${YELLOW}   Consider upgrading or cleaning up unused images.${NC}"
  elif (( $(echo "$PERCENT_USED >= 70" | bc -l) )); then
    echo -e "${YELLOW}⚠ Notice: Storage quota at ${PERCENT_USED}%.${NC}"
    echo -e "${YELLOW}   $REMAINING images remaining.${NC}"
  else
    echo -e "${GREEN}✓ Storage quota healthy (${PERCENT_USED}% used).${NC}"
    echo -e "${GREEN}   $REMAINING images remaining.${NC}"
  fi

  # Recommendations
  echo ""
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Recommendations${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"

  if (( TOTAL_STORED > 10000 )); then
    echo -e "${YELLOW}→${NC} Use variants to reduce storage of multiple sizes"
    echo -e "${YELLOW}→${NC} Enable automatic format conversion (WebP/AVIF)"
    echo -e "${YELLOW}→${NC} Delete unused images to reduce costs"
  fi

  if (( $(echo "$PERCENT_USED < 10" | bc -l) )); then
    echo -e "${GREEN}→${NC} Low usage - you're on track for minimal costs"
  fi

  echo -e "${GREEN}→${NC} Monitor usage in Dashboard → Images → Analytics"
  echo -e "${GREEN}→${NC} Set up billing alerts for cost control"

else
  # Fallback without jq
  echo -e "${YELLOW}Note: Install 'jq' for better output formatting${NC}\n"

  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Usage Statistics${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo ""
  echo -e "${YELLOW}Raw Response:${NC}"
  echo "$BODY"
fi

echo ""
echo -e "${BLUE}═══════════════════════════════════════${NC}"
echo -e "${GREEN}Usage analysis complete!${NC}"
echo -e "${BLUE}═══════════════════════════════════════${NC}"
echo ""
echo -e "${YELLOW}For detailed analytics:${NC}"
echo -e "  Dashboard → Images → Analytics"
echo -e "  https://dash.cloudflare.com/?to=/:account/images/analytics"

# Drop secrets from the shell environment now that the curl call is 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