Cloud Storage

When to Use

User needs to upload, download, sync, or manage files across cloud storage providers. Agent handles multi-provider operations with cost awareness.

Quick Reference

Scope

This skill covers operational cloud storage tasks across providers:

• S3, GCS, Azure Blob, Backblaze B2, Cloudflare R2
• Google Drive, Dropbox, OneDrive, iCloud

For storage architecture decisions, see storage skill.

For S3-specific deep patterns, see s3 skill.

Critical Rules

1. Verify operations completed — API 200 ≠ success; check file exists with correct size/checksum
2. Calculate ALL costs before large transfers — egress fees often exceed storage costs; check costs.md
3. Never delete without backup verification — confirm backup exists AND is restorable before removing source
4. Handle partial failures — long operations fail mid-way; implement checkpoints and resume logic
5. Rate limits vary wildly — Google 750GB/day upload, Dropbox batch limits, S3 3500 PUT/s per prefix

Authentication Traps

• OAuth tokens expire — refresh before long operations, not during
• Service account ≠ user account — different quotas, permissions, audit trails
• Wrong region/endpoint — S3 bucket in eu-west-1 won't work with s3.amazonaws.com
• MFA required — some operations need session tokens, plan for interactive auth

Multi-Provider Gotchas

Before Any Bulk Operation

• [ ] Estimated time calculated (size ÷ bandwidth)
• [ ] Rate limits checked for both source AND destination
• [ ] Cost estimate including egress + API calls
• [ ] Checkpoint/resume strategy for failures
• [ ] Verification method defined (checksum, count, spot-check)