Skip to content

4thel00z/s5cmd-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 

Repository files navigation

s5cmd-skill

A Claude Code skill that teaches the agent s5cmd — blazing-fast, massively parallel S3 data movement — so it reaches for the right command instead of slow aws s3 loops.

s5cmd Claude Code Skill Type: reference License: MIT


Why this skill?

  • Picks the fast path — nudges Claude toward s5cmd (10–30× faster than aws s3) for bulk S3 transfers instead of boto3 loops
  • 🎯 Grounded in the binary — every command and flag is lifted straight from s5cmd --help (v2.3.0), not model memory
  • 🌀 Full surface — all subcommands: ls cp mv rm mb rb sync du cat pipe select run head presign bucket-version
  • 🪤 Knows the traps — wildcard quoting, global-vs-command flag placement, --numworkers vs --concurrency, sync --delete previews
  • 🔌 Endpoint-aware — MinIO, Ceph, Cloudflare R2, GCS, Backblaze B2, Wasabi, and other S3-compatible stores
  • Tested — validated with a retrieval scenario before shipping (per the writing-skills TDD method)

What triggers it

Claude loads the skill on S3 data-movement concerns: copying, uploading, downloading, moving, syncing, listing, or deleting objects; transfers that are too slow via aws s3 / boto3; batching thousands of operations; streaming with cat/pipe; SQL select over CSV/JSON/Parquet; presigned URLs; object metadata (head); storage usage (du); bucket management — or any mention of s5cmd itself.

Install

The skill is a single SKILL.md. Drop it where your agent discovers skills:

git clone https://github.com/4thel00z/s5cmd-skill ~/skills/s5cmd-skill
ln -sfn ~/skills/s5cmd-skill ~/.claude/skills/s5cmd

You also need the s5cmd binary on PATH:

brew install peak/tap/s5cmd          # macOS
# or: go install github.com/peak/s5cmd/v2@master
s5cmd version                         # expect v2.3.0+

Layout

s5cmd-skill/
  SKILL.md     # the skill: frontmatter triggers + command reference
  README.md    # this file

A taste of what it knows

# Download a whole prefix from a custom endpoint, fast (always quote the glob!)
s5cmd --endpoint-url https://minio.lan:9000 cp "s3://data/raw/*" ./raw/

# Mirror with deletions — preview first
s5cmd --dry-run sync --delete ./out/ s3://backups/

# Delete 50k keys from a list, in parallel
cat keys.txt | awk '{print "rm s3://bucket/" $0}' | s5cmd run

# Stream a download straight into S3, no local disk
curl -sL https://example.com/file | s5cmd pipe s3://bucket/file

License

MIT


Teaches the agent to move bytes at wire speed. 🚀

About

Claude Code skill for s5cmd — blazing-fast, massively parallel S3 data movement. Teaches the agent every s5cmd subcommand, grounded in v2.3.0 --help.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors