minio_skill

Overview

This skill provides S3-compatible MinIO object storage operations via the MinIO Client (mc) and curl. It covers bucket management, file upload/download, object listing/search, pre-signed URL generation, and sync/mirroring workflows. Use it to automate storage tasks and share files securely without exposing credentials.

How this skill works

The skill uses mc to communicate with MinIO endpoints, handling authentication and request signing automatically once an alias is configured. It can also generate pre-signed URLs for curl-based uploads and downloads, and supports direct API calls using AWS Signature V2 when mc is unavailable. Commands include bucket creation, object copy/remove, stat, find, mirror, and mc share for temporary links.

When to use it

• Upload or download files to any S3-compatible endpoint.
• Create, list, inspect, or delete buckets and objects.
• Provide temporary, expiring access to objects via pre-signed URLs.
• Sync or mirror local directories with remote buckets for backups.
• Search or filter objects by name, size, or modification date.

Best practices

• Install and use mc for most operations to avoid manual signing errors.
• Store credentials in environment variables and configure an mc alias once.
• Use pre-signed URLs for external access and set the shortest practical expiry (max 7 days).
• Follow bucket naming rules: lowercase, 3–63 chars, no underscores or consecutive dots.
• Use mc mirror --watch for continuous one-way backups and verify integrity periodically.

Example use cases

• Automate nightly backups by mirroring a local folder to a MinIO bucket.
• Generate a time-limited download link to share a large file with a contractor.
• List and prune objects older than X days using mc find and rm in a script.
• Upload files from CI/CD pipelines using pre-signed upload URLs and curl.
• Host public assets by setting a bucket to anonymous download for CDN consumption.