R2 upload

Skill zebbern/claude-code-guide/skills/r2-upload

Claude Code Guide - Setup, Commands, workflows, agents, skills & tips-n-tricks go from beginner to power user!

Install

npx -y skills add zebbern/claude-code-guide --skill r2-upload

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Upload files to Cloudflare R2, AWS S3, or any S3-compatible storage (like MinIO) and generate secure, time-limited presigned download links with configurable expiration, typically set to 5 minutes. Use when the user needs to upload a file to cloud storage and get a shareable link, or mentions R2, S3, presigned URLs, temporary links, or file uploads with expiration.

SKILL.md

3.5 KB, as published. Nobody here has run it

Send Me My Files - R2 Upload with Short Lived Signed URLs

Upload files to Cloudflare R2 or any S3-compatible storage and generate presigned download links.

Features

Upload files to R2/S3 buckets
Generate presigned download URLs (configurable expiration)
Support for any S3-compatible storage (R2, AWS S3, MinIO, etc.)
Multiple bucket configurations
Automatic content-type detection

Configuration

Create ~/.r2-upload.yml (or set R2_UPLOAD_CONFIG env var):

# Default bucket (used when no bucket specified)
default: my-bucket

# Bucket configurations
buckets:
  my-bucket:
    endpoint: https://abc123.r2.cloudflarestorage.com
    access_key_id: your_access_key
    secret_access_key: your_secret_key
    bucket_name: my-bucket
    public_url: https://files.example.com  # Optional: custom domain
    region: auto  # For R2, use "auto"

  # Additional buckets
  personal:
    endpoint: https://xyz789.r2.cloudflarestorage.com
    access_key_id: ...
    secret_access_key: ...
    bucket_name: personal-files
    region: auto

Cloudflare R2 Setup

Go to Cloudflare Dashboard → R2
Create a bucket
Go to R2 API Tokens: https://dash.cloudflare.com/<ACCOUNT_ID>/r2/api-tokens
Create a new API token
- Important: Apply to specific bucket (select your bucket)
- Permissions: Object Read & Write
Copy the Access Key ID and Secret Access Key
Use endpoint format: https://<account_id>.r2.cloudflarestorage.com
Set region: auto

AWS S3 Setup

aws-bucket:
  endpoint: https://s3.us-east-1.amazonaws.com
  access_key_id: ...
  secret_access_key: ...
  bucket_name: my-aws-bucket
  region: us-east-1

Usage

Upload a file

r2-upload /path/to/file.pdf
# Returns: https://files.example.com/abc123/file.pdf?signature=...

Upload with custom path

r2-upload /path/to/file.pdf --key uploads/2026/file.pdf

Upload to specific bucket

r2-upload /path/to/file.pdf --bucket personal

Custom expiration (default: 5 minutes)

r2-upload /path/to/file.pdf --expires 24h
r2-upload /path/to/file.pdf --expires 1d
r2-upload /path/to/file.pdf --expires 300  # seconds

Public URL (no signature)

r2-upload /path/to/file.pdf --public

Tools

r2_upload - Upload file and get presigned URL
r2_list - List recent uploads
r2_delete - Delete a file

Environment Variables

R2_UPLOAD_CONFIG - Path to config file (default: ~/.r2-upload.yml)
R2_DEFAULT_BUCKET - Override default bucket
R2_DEFAULT_EXPIRES - Default expiration in seconds (default: 300 = 5 minutes)

Notes

Uploaded files are stored with their original filename unless --key is specified
Automatic UUID prefix added to prevent collisions (e.g., abc123/file.pdf)
Content-Type automatically detected from file extension
Presigned URLs expire after the configured duration