How do I install the R2 Upload skill?

Run npx skillmds@latest add serejaris/r2-upload in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is R2 Upload safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with R2 Upload?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is R2 Upload free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published R2 Upload?

serejaris (@serejaris) published this skill. Their other Agent Skills are listed on their SkillMD profile.

R2 Upload by serejaris — Agent Skill

Name: R2 Upload
Author: serejaris

R2 Upload

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.

serejaris 6049457 11 files · 113.4 KB Updated Sep 17, 2026

File contents

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

---name: r2-uploaddescription: 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.---# Send Me My Files - R2 Upload with Short Lived Signed URLsUpload 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## ConfigurationCreate `~/.r2-upload.yml` (or set `R2_UPLOAD_CONFIG` env var):```yaml# Default bucket (used when no bucket specified)default: my-bucket# Bucket configurationsbuckets: 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 Setup1. Go to Cloudflare Dashboard → R22. Create a bucket3. Go to R2 API Tokens: `https://dash.cloudflare.com/<ACCOUNT_ID>/r2/api-tokens`4. Create a new API token - **Important:** Apply to specific bucket (select your bucket) - Permissions: Object Read & Write5. Copy the Access Key ID and Secret Access Key6. Use endpoint format: `https://<account_id>.r2.cloudflarestorage.com`7. Set `region: auto`### AWS S3 Setup```yamlaws-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```bashr2-upload /path/to/file.pdf# Returns: https://files.example.com/abc123/file.pdf?signature=...```### Upload with custom path```bashr2-upload /path/to/file.pdf --key uploads/2026/file.pdf```### Upload to specific bucket```bashr2-upload /path/to/file.pdf --bucket personal```### Custom expiration (default: 5 minutes)```bashr2-upload /path/to/file.pdf --expires 24hr2-upload /path/to/file.pdf --expires 1dr2-upload /path/to/file.pdf --expires 300 # seconds```### Public URL (no signature)```bashr2-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

Frequently asked questions