r2-storage Skill

Manage Cloudflare R2 buckets and objects via the S3-compatible API. Uses boto3 under the hood.

When to Use This Skill

Use this skill whenever Marouane needs to:

• Upload files to R2 (backups, assets, media)
• Download files from R2
• List bucket contents
• Delete objects
• Generate temporary pre-signed URLs for sharing

Credentials

Set via environment variables (defaults are pre-configured for Marouane's account):

CLI Usage

# Upload
python3 scripts/r2.py upload myfile.txt my-bucket
python3 scripts/r2.py upload myfile.txt my-bucket --key folder/myfile.txt

# Download
python3 scripts/r2.py download my-bucket/folder/myfile.txt ./local-copy.txt

# List
python3 scripts/r2.py list my-bucket
python3 scripts/r2.py list my-bucket --prefix folder/

# Delete
python3 scripts/r2.py delete my-bucket/folder/myfile.txt

# Pre-signed URL (default 1h)
python3 scripts/r2.py presign my-bucket/folder/myfile.txt
python3 scripts/r2.py presign my-bucket/folder/myfile.txt --expires 86400

Python Import Usage

from scripts.r2 import upload, download, list_objects, delete, presign

# Upload
upload("local.txt", "my-bucket", key="optional/key.txt")

# List
objects = list_objects("my-bucket", prefix="folder/")
for obj in objects:
    print(obj["key"], obj["size"])

# Pre-signed URL
url = presign("my-bucket", "folder/file.txt", expires=3600)

Requirements

• Python 3.8+
• boto3 (python3-boto3 on Ubuntu — already installed on vps118558)

Notes

• Cloudflare R2 is S3-compatible; standard boto3 patterns apply.
• Pre-signed URLs work for GET requests only (public download links).
• The region_name="auto" is required for R2 compatibility.