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/validate-variants.sh

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

# Validate Variants Script - Cloudflare Images
# List all configured variants and check variant count
#
# 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[0;' # 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 Variants...${NC}\n"

# Fetch variants from API
RESPONSE=$(curl -s -w "\n%{http_code}" -X GET \
  "https://api.cloudflare.com/client/v4/accounts/${CF_ACCOUNT_ID}/images/v1/variants" \
  -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 variants (HTTP $HTTP_CODE)${NC}"
  echo -e "${YELLOW}Response: $BODY${NC}"
  exit 1
fi

# Check if jq is available for pretty JSON parsing
if command -v jq &> /dev/null; then
  # Parse with jq
  VARIANT_COUNT=$(echo "$BODY" | jq '.result.variants | length')
  VARIANTS=$(echo "$BODY" | jq -r '.result.variants | keys[]')

  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Variant Summary${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${YELLOW}Total Variants:${NC} $VARIANT_COUNT / 100 (max)"

  # Show warning if approaching limit
  if [ "$VARIANT_COUNT" -ge 80 ]; then
    echo -e "${RED}⚠ WARNING: Approaching variant limit!${NC}"
    echo -e "${RED}   You can create only $((100 - VARIANT_COUNT)) more variants.${NC}"
  elif [ "$VARIANT_COUNT" -ge 50 ]; then
    echo -e "${YELLOW}⚠ Notice: You have used $VARIANT_COUNT of 100 variants.${NC}"
  else
    echo -e "${GREEN}✓ Variant usage is healthy.${NC}"
  fi

  echo ""
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Configured Variants${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"

  # Display each variant with details
  for VARIANT in $VARIANTS; do
    VARIANT_DATA=$(echo "$BODY" | jq -r ".result.variants[\"$VARIANT\"]")

    # Extract variant options
    WIDTH=$(echo "$VARIANT_DATA" | jq -r '.options.width // "auto"')
    HEIGHT=$(echo "$VARIANT_DATA" | jq -r '.options.height // "auto"')
    FIT=$(echo "$VARIANT_DATA" | jq -r '.options.fit // "scale-down"')
    QUALITY=$(echo "$VARIANT_DATA" | jq -r '.options.quality // "85"')

    echo -e "\n${GREEN}Variant:${NC} $VARIANT"
    echo -e "  ${YELLOW}Width:${NC}   $WIDTH"
    echo -e "  ${YELLOW}Height:${NC}  $HEIGHT"
    echo -e "  ${YELLOW}Fit:${NC}     $FIT"
    echo -e "  ${YELLOW}Quality:${NC} $QUALITY"
  done

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

  # Simple count using grep
  VARIANT_COUNT=$(echo "$BODY" | grep -o '"id":"[^"]*"' | wc -l | tr -d ' ')

  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${BLUE}Variant Summary${NC}"
  echo -e "${BLUE}═══════════════════════════════════════${NC}"
  echo -e "${YELLOW}Total Variants:${NC} $VARIANT_COUNT / 100 (max)"

  # Show warning if approaching limit
  if [ "$VARIANT_COUNT" -ge 80 ]; then
    echo -e "${RED}⚠ WARNING: Approaching variant limit!${NC}"
  elif [ "$VARIANT_COUNT" -ge 50 ]; then
    echo -e "${YELLOW}⚠ Notice: You have used $VARIANT_COUNT of 100 variants.${NC}"
  else
    echo -e "${GREEN}✓ Variant usage is healthy.${NC}"
  fi

  echo ""
  echo -e "${YELLOW}Raw Response:${NC}"
  echo "$BODY"
fi

echo ""
echo -e "${BLUE}═══════════════════════════════════════${NC}"
echo -e "${GREEN}Variant validation complete!${NC}"
echo -e "${BLUE}═══════════════════════════════════════${NC}"

# 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