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/generate-signed-url.sh

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

# Generate Signed URL Script - Cloudflare Images
# CLI tool to generate signed URLs for private images
#
# 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_IMAGES_SIGNING_KEY 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 a signing key.

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

# Usage
usage() {
  echo -e "${YELLOW}Usage:${NC} $0 <image-id> [variant] [expiry-seconds]"
  echo ""
  echo "Arguments:"
  echo "  image-id         Image ID (required)"
  echo "  variant          Variant name (default: public)"
  echo "  expiry-seconds   Expiry time in seconds (default: 3600 = 1 hour)"
  echo ""
  echo "Examples:"
  echo "  $0 2cdc28f0-017a-49c4-9ed7-87056c83901"
  echo "  $0 2cdc28f0-017a-49c4-9ed7-87056c83901 thumbnail"
  echo "  $0 2cdc28f0-017a-49c4-9ed7-87056c83901 public 7200"
  echo ""
  exit 1
}

# Check required environment variables
if [ -z "$CF_ACCOUNT_HASH" ]; then
  echo -e "${RED}Error: CF_ACCOUNT_HASH not set${NC}"
  echo "Set it in .env or export CF_ACCOUNT_HASH=your_account_hash"
  echo ""
  echo "Get it from: Dashboard → Images → Serving Images → Account Hash"
  exit 1
fi

if [ -z "$CF_IMAGES_SIGNING_KEY" ]; then
  echo -e "${RED}Error: CF_IMAGES_SIGNING_KEY not set${NC}"
  echo "Set it in .env or export CF_IMAGES_SIGNING_KEY=your_signing_key"
  echo ""
  echo "Get it from: Dashboard → Images → Signing Keys → Create Key"
  echo "Or generate with: openssl rand -hex 32"
  exit 1
fi

# Parse arguments
IMAGE_ID="$1"
VARIANT="${2:-public}"
EXPIRY_SECONDS="${3:-3600}"

if [ -z "$IMAGE_ID" ]; then
  usage
fi

echo -e "${GREEN}Generating Signed URL...${NC}\n"

# Calculate expiry timestamp (Unix epoch)
EXPIRY=$(( $(date +%s) + EXPIRY_SECONDS ))

# Data to sign: imageId/variant + expiry
DATA_TO_SIGN="${IMAGE_ID}/${VARIANT}${EXPIRY}"

# Generate HMAC-SHA256 signature
SIGNATURE=$(echo -n "$DATA_TO_SIGN" | openssl dgst -sha256 -hmac "$CF_IMAGES_SIGNING_KEY" -binary | base64)

# URL-encode the signature (replace + with -, / with _, remove =)
SIGNATURE_ENCODED=$(echo "$SIGNATURE" | tr '+/' '-_' | tr -d '=')

# Construct signed URL
SIGNED_URL="https://imagedelivery.net/${CF_ACCOUNT_HASH}/${IMAGE_ID}/${VARIANT}?exp=${EXPIRY}&sig=${SIGNATURE_ENCODED}"

# Calculate expiry date/time
EXPIRY_DATE=$(date -r $EXPIRY +"%Y-%m-%d %H:%M:%S %Z" 2>/dev/null || date -d @$EXPIRY +"%Y-%m-%d %H:%M:%S %Z" 2>/dev/null || echo "Unknown")

# Output
echo -e "${GREEN}Signed URL generated successfully!${NC}\n"
echo -e "${YELLOW}Image ID:${NC}      $IMAGE_ID"
echo -e "${YELLOW}Variant:${NC}       $VARIANT"
echo -e "${YELLOW}Expires In:${NC}    $EXPIRY_SECONDS seconds ($(($EXPIRY_SECONDS / 60)) minutes)"
echo -e "${YELLOW}Expires At:${NC}    $EXPIRY_DATE"
echo -e "${YELLOW}Signature:${NC}     $SIGNATURE_ENCODED"
echo ""
echo -e "${GREEN}Signed URL:${NC}"
echo "$SIGNED_URL"
echo ""

# Test if URL is accessible
echo -e "${YELLOW}Testing URL accessibility...${NC}"
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" "$SIGNED_URL")

if [ "$HTTP_CODE" -eq 200 ]; then
  echo -e "${GREEN}✓ URL is accessible (HTTP $HTTP_CODE)${NC}"
else
  echo -e "${RED}✗ URL is not accessible (HTTP $HTTP_CODE)${NC}"
  echo -e "${YELLOW}This may indicate:${NC}"
  echo -e "  - Image does not exist"
  echo -e "  - Image does not require signed URLs"
  echo -e "  - Incorrect signing key"
  echo -e "  - Invalid variant"
fi

echo ""
echo -e "${GREEN}═══════════════════════════════════════${NC}"
echo -e "${GREEN}Copy the URL above to use in your application${NC}"
echo -e "${GREEN}═══════════════════════════════════════${NC}"

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