How do I install the Minio Share skill?

Run npx skillmds@latest add dvcrn/minio-share 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 Minio Share safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Minio Share?

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 Minio Share free to use?

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

Who published Minio Share?

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

Minio Share by dvcrn — Agent Skill

Name: Minio Share
Rating: 4.2 (5 reviews)
Author: dvcrn

Minio Share

Upload files to MinIO object storage and generate shareable links with Markdown formatting. Use when users ask to send files, share files, upload files, download videos, or get a download link for files. Supports custom filenames from titles and provides formatted output with clickable links and media previews. Requires MINIO_API_URL, MINIO_CONSOLE_URL, MINIO_ACCESS_KEY, MINIO_SECRET_KEY, and MINIO_BUCKET environment variables.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

MinIO Share

Upload files to MinIO and generate shareable links for users with Markdown formatting.

Requirements

Ensure these environment variables are set:

MINIO_API_URL - MinIO S3 API endpoint (e.g., https://minio-api.example.com)
MINIO_CONSOLE_URL - MinIO Web Console URL (e.g., https://minio.example.com)
MINIO_ACCESS_KEY - MinIO access key
MINIO_SECRET_KEY - MinIO secret key
MINIO_BUCKET - Default bucket name for uploads

Installation

Install the minio Python package if not already available:

pip install minio

Usage

Basic Upload

Upload a file with Markdown output:

python3 scripts/minio_upload.py /path/to/file.txt

Use Title as Filename

Upload with a custom title (sanitized for safe filenames):

python3 scripts/minio_upload.py /path/to/video.mp4 --title "My Video Title"

This will save the file as My_Video_Title.mp4 (special characters replaced with underscores).

Custom Object Name

Specify a custom name for the uploaded object:

python3 scripts/minio_upload.py /path/to/file.txt --name custom-name.pdf

Adjust Link Expiry

Change the presigned URL expiry time (default: 7 days):

python3 scripts/minio_upload.py /path/to/file.txt --expiry 30

JSON Output

Get structured output:

python3 scripts/minio_upload.py /path/to/file.txt --json

Plain Text Output

Get just the URL:

python3 scripts/minio_upload.py /path/to/file.txt

Workflow

When a user asks to send/share/upload a file or download a video:

Check environment variables - Verify MINIO_* variables are set
Download the file (if it's a URL) to a temporary location
Upload the file using scripts/minio_upload.py:
- For videos: Use --title "Video Title" to set a meaningful filename
- For images: They will be displayed inline with Markdown
- For videos: A video player will be included in the output
Copy the Markdown output to your response

Filename Sanitization

When using --title, the script automatically:

Replaces illegal characters (< > : " / \ | ? *) with underscores
Collapses multiple spaces/underscores
Trims to 100 characters max
Preserves Chinese characters, letters, numbers

Output Formats

Markdown Output (Default)

Provides rich formatting with:

File information (name, size, expiry)
Inline image preview (for image files)
Video player (for video files)
Clickable download link
Console preview link
Plain text URL for copying

Example Markdown Output

📄 **文件名**: `sample.mp4`
📦 **大小**: 44.51 MB
⏱️ **链接有效期**: 7 天

🌐 **[sample.mp4](...)**

Error Handling

Common issues:

Missing environment variables - Check all MINIO_* vars are set
Bucket doesn't exist - Ensure MINIO_BUCKET exists or create it first
File not found - Verify the file path is correct
Connection error - Check MINIO_API_URL is accessible
SSL errors - Use --insecure flag if needed (not recommended for production)

---name: minio-sharedescription: Upload files to MinIO object storage and generate shareable links with Markdown formatting. Use when users ask to send files, share files, upload files, download videos, or get a download link for files. Supports custom filenames from titles and provides formatted output with clickable links and media previews. Requires MINIO_API_URL, MINIO_CONSOLE_URL, MINIO_ACCESS_KEY, MINIO_SECRET_KEY, and MINIO_BUCKET environment variables.---# MinIO ShareUpload files to MinIO and generate shareable links for users with Markdown formatting.## RequirementsEnsure these environment variables are set:- `MINIO_API_URL` - MinIO S3 API endpoint (e.g., `https://minio-api.example.com`)- `MINIO_CONSOLE_URL` - MinIO Web Console URL (e.g., `https://minio.example.com`)- `MINIO_ACCESS_KEY` - MinIO access key- `MINIO_SECRET_KEY` - MinIO secret key- `MINIO_BUCKET` - Default bucket name for uploads## InstallationInstall the minio Python package if not already available:```bashpip install minio```## Usage### Basic UploadUpload a file with Markdown output:```bashpython3 scripts/minio_upload.py /path/to/file.txt```### Use Title as FilenameUpload with a custom title (sanitized for safe filenames):```bashpython3 scripts/minio_upload.py /path/to/video.mp4 --title "My Video Title"```This will save the file as `My_Video_Title.mp4` (special characters replaced with underscores).### Custom Object NameSpecify a custom name for the uploaded object:```bashpython3 scripts/minio_upload.py /path/to/file.txt --name custom-name.pdf```### Adjust Link ExpiryChange the presigned URL expiry time (default: 7 days):```bashpython3 scripts/minio_upload.py /path/to/file.txt --expiry 30```### JSON OutputGet structured output:```bashpython3 scripts/minio_upload.py /path/to/file.txt --json```### Plain Text OutputGet just the URL:```bashpython3 scripts/minio_upload.py /path/to/file.txt```## WorkflowWhen a user asks to send/share/upload a file or download a video:1. **Check environment variables** - Verify MINIO_* variables are set2. **Download the file** (if it's a URL) to a temporary location3. **Upload the file** using `scripts/minio_upload.py`: - For videos: Use `--title "Video Title"` to set a meaningful filename - For images: They will be displayed inline with Markdown - For videos: A video player will be included in the output4. **Copy the Markdown output** to your response## Filename SanitizationWhen using `--title`, the script automatically:- Replaces illegal characters (`< > : " / \ | ? *`) with underscores- Collapses multiple spaces/underscores- Trims to 100 characters max- Preserves Chinese characters, letters, numbers## Output Formats### Markdown Output (Default)Provides rich formatting with:- File information (name, size, expiry)- Inline image preview (for image files)- Video player (for video files)- Clickable download link- Console preview link- Plain text URL for copying### Example Markdown Output```markdown📄 **文件名**: `sample.mp4`📦 **大小**: 44.51 MB⏱️ **链接有效期**: 7 天🌐 **[sample.mp4](...)**```## Error HandlingCommon issues:- Missing environment variables - Check all MINIO_* vars are set- Bucket doesn't exist - Ensure MINIO_BUCKET exists or create it first- File not found - Verify the file path is correct- Connection error - Check MINIO_API_URL is accessible- SSL errors - Use `--insecure` flag if needed (not recommended for production)

Frequently asked questions