Agent skill

Minio Uploader

by xiaoyuge886 in xiaoyuge886/aigc

简化版MinIO文件上传工具,支持一键上传文件到MinIO对象存储并获取访问链接. An agent skill from xiaoyuge886/aigc.

MITAuto-check: notesDocuments & Office

Install Minio Uploader

skills CLI
$ npx skills add xiaoyuge886/aigc --skill minio-uploader -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install xiaoyuge886/aigc minio-uploader --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/xiaoyuge886/aigc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/minio_uploader .claude/skills/minio-uploader && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
minio-uploader
GitHub stars
198
Token cost
~641 tokens
SKILL.md length
146 words
Files
2
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

简化版MinIO文件上传工具,支持一键上传文件到MinIO对象存储并获取访问链接. An agent skill from xiaoyuge886/aigc.

  • Works in 5 steps: 总是先检查文件是否存在再执行上传 → 使用有意义的对象名称,例如:reports/2025-01-analysis.pdf → 对于大文件,提示用户上传可能需要一些时间 → …
  • Documents & Office work in your project
  • SKILL.md covers 🎯 工作流程, 📋 使用场景, 🔧 配置说明 and 💡 最佳实践, plus 2 more sections
  • Runs Python scripts from its folder; calls python and pip; needs MINIO_ACCESS_KEY and MINIO_SECRET_KEY

What it does

Minio Uploader is an agent skill from xiaoyuge886/aigc. 简化版MinIO文件上传工具,支持一键上传文件到MinIO对象存储并获取访问链接

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `simple_minio_uploader.py`).

It sits in Documents & Office. The repository describes itself as: AIGC 智能 Agent 平台是一个强大的 AI 应用框架,通过集成 Claude AI 模型和丰富的技能生态系统,为用户提供智能化、场景化的 AI 解决方案。平台采用前后端分离架构,支持多租户、会话管理、技能扩展等企业级特性。 The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/minio-uploader”

Requirements

  • Python 3
  • A credential in MINIO_ACCESS_KEY
  • A credential in MINIO_SECRET_KEY
  • Pre-approved tools (allowed-tools): Read, Write, Bash, Glob

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 总是先检查文件是否存在再执行上传
  2. 使用有意义的对象名称,例如:reports/2025-01-analysis.pdf
  3. 对于大文件,提示用户上传可能需要一些时间
  4. 返回链接时,同时说明链接的用途(预览或下载)
  5. 中文文件名会自动处理 URL 编码,无需担心

What it can do on your machine

Read from SKILL.md and the folder at commit e970014. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MINIO_ACCESS_KEY
    • MINIO_SECRET_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Minio Uploader loads about 641 tokens when it runs. Until then it costs about 14 tokens; SKILL.md has 146 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~14
When it runs · the whole SKILL.md, loaded when a task matches
~641

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash, Glob

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from xiaoyuge886/aigc at commit e970014, republished under its MIT licence (© xiaoyuge886). 146 words, ~641 tokens.

Download SKILL.mdSave it as .claude/skills/minio-uploader/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
minio-uploader
description
简化版MinIO文件上传工具,支持一键上传文件到MinIO对象存储并获取访问链接
allowed-tools
Read, Write, Bash, Glob

MinIO 文件上传器 (MinIO Uploader)

专业的MinIO对象存储上传工具,帮助您快速将文件上传到MinIO并生成可访问的链接。

🎯 工作流程

当用户要求上传文件到 MinIO 时,请按照以下步骤执行:

步骤 1: 确认文件路径
  • 使用 ls 或 Read 工具确认文件存在
  • 获取文件的完整路径
  • 检查文件大小和类型
步骤 2: 执行上传命令

使用以下 Python 命令上传文件:

bash
python /Users/hehe/pycharm_projects/aigc/.claude/skills/minio_uploader/simple_minio_uploader.py <文件路径> [对象名称] [force_download] [存储桶]

参数说明:

  • <文件路径>: 必需,要上传的文件完整路径
  • [对象名称]: 可选,MinIO 中的存储路径(默认使用原文件名)
  • [force_download]: 可选,是否强制下载(true/false,默认 false)
  • [存储桶]: 可选,存储桶名称(默认:agentic)
步骤 3: 验证上传结果
  • 检查命令输出中的"上传成功"消息
  • 获取返回的公开访问链接
  • 如需要,使用 list_files() 验证文件已上传
步骤 4: 返回结果给用户
  • 提供公开访问链接
  • 显示文件信息(大小、类型等)
  • 说明如何使用链接

📋 使用场景

场景 1: 上传单个文件(最常见)

用户请求: "上传这个文件到 MinIO" AI 应该执行:

bash
# 1. 先确认文件存在
ls -lh <文件路径>

# 2. 执行上传
python /Users/hehe/pycharm_projects/aigc/.claude/skills/minio_uploader/simple_minio_uploader.py <文件路径>
场景 2: 上传到指定路径

用户请求: "上传报告到 reports/ 目录" AI 应该执行:

bash
python /Users/hehe/pycharm_projects/aigc/.claude/skills/minio_uploader/simple_minio_uploader.py <文件路径> reports/<文件名>
场景 3: 上传并生成下载链接

用户请求: "上传文件并提供下载链接" AI 应该执行:

bash
python /Users/hehe/pycharm_projects/aigc/.claude/skills/minio_uploader/simple_minio_uploader.py <文件路径> <对象名称> true
场景 4: 批量上传多个文件

用户请求: "上传所有 PDF 文件" AI 应该执行:

bash
# 1. 先找到所有 PDF 文件
ls <目录>/*.pdf

# 2. 逐个上传
for file in <目录>/*.pdf; do
    python /Users/hehe/pycharm_projects/aigc/.claude/skills/minio_uploader/simple_minio_uploader.py "$file"
done

🔧 配置说明

环境变量配置(推荐):

  • MINIO_ENDPOINT: MinIO 服务地址(默认:http://localhost:9000)
  • MINIO_ACCESS_KEY: 访问密钥(默认:minioadmin)
  • MINIO_SECRET_KEY: 密钥(默认:minioadmin)
  • MINIO_BUCKET_NAME: 默认存储桶(默认:agentic)
  • MINIO_SECURE: 是否使用 HTTPS(默认:false)
  • MINIO_REGION: AWS 区域(默认:us-east-1)

支持的文件类型:

  • 文档:PDF, DOC, DOCX, TXT, MD, HTML
  • 表格:XLS, XLSX, CSV
  • 图片:JPG, PNG, GIF, SVG
  • 其他:ZIP, JSON, XML 等

💡 最佳实践

  1. 总是先检查文件是否存在再执行上传
  2. 使用有意义的对象名称,例如:reports/2025-01-analysis.pdf
  3. 对于大文件,提示用户上传可能需要一些时间
  4. 返回链接时,同时说明链接的用途(预览或下载)
  5. 中文文件名会自动处理 URL 编码,无需担心

⚠️ 注意事项

  • 确保 boto3 包已安装(pip install boto3)
  • 文件路径必须是绝对路径或相对于当前目录的路径
  • 默认生成的链接是公开访问的,任何人都可以访问
  • 如果需要私有访问,请使用预签名 URL 功能

📤 返回给用户的格式

上传成功后,请按以下格式返回结果:

✅ 文件上传成功!

📄 文件信息:
- 文件名:[文件名]
- 文件大小:[大小]
- 文件类型:[类型]

🔗 公开访问链接:
[链接地址]

💡 提示:
- 点击链接可直接预览/下载
- 链接永久有效(除非删除文件)

现在开始使用吧!请告诉我您要上传哪个文件。

© xiaoyuge886, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in .claude/skills/minio_uploader of xiaoyuge886/aigc.

  • SKILL.md
  • simple_minio_uploader.py

Open the folder on GitHubat commit e970014

Compare with similar skills

Minio Uploader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Minio Uploader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minio Uploader this skillxiaoyuge886/aigc198—~641Automated safety check: NotesMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

More from xiaoyuge886/aigc

All 9 skills in this repo
  • Docs Management

    xiaoyuge886/aigc

    Single source of truth and librarian for ALL Claude official documentation.

    198 GitHub stars~7.8k tokensUpdated 2 mo ago
    Auto-check: notes
  • Xagent

    xiaoyuge886/aigc

    XAgent是一个智能跨域分析助手,基于SOP驱动的规划、多工具协调和多层次数据分析框架,提供专业的商业智能和数据分析能力。当用户需要进行数据分析、业务分析、生成报告或需要结构化的问题解决方案时使用。

    198 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Data Analysis

    xiaoyuge886/aigc

    Perform data analysis tasks including data cleaning, statistical analysis, visualization, and insight generation.

    198 GitHub stars~794 tokensUpdated 2 mo ago
    Auto-check passed
  • 投资尽调报告专业生成工具。当用户需要撰写投资尽调报告、尽职调查报告、投资分析报告时使用此skill。支持处理Excel财务数据、PDF文档等多种格式数据源,自动生成包含执行摘要、业务分析、财务分析、风险提示、投资建议等核心章节的专业报告。无论用户明确要求"写报告"还是提到"分析投资标的"、"评估项目"、"做DD"等相关需求时,都应使用此skill。

    198 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Todo Master

    xiaoyuge886/aigc

    专业的待办事项管理技能,指导如何有效使用 TodoWrite 工具进行任务规划、进度跟踪和状态管理。当用户需要处理复杂任务、多步骤工作流或需要任务规划时使用。

    198 GitHub stars~972 tokensUpdated 2 mo ago
    Auto-check: notes
  • Stripe Best Practices

    xiaoyuge886/aigc

    Best practices for building Stripe integrations. An agent skill from xiaoyuge886/aigc.

    198 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

Questions about Minio Uploader

What does Minio Uploader do?

简化版MinIO文件上传工具,支持一键上传文件到MinIO对象存储并获取访问链接. An agent skill from xiaoyuge886/aigc. Minio Uploader is an agent skill from xiaoyuge886/aigc.

When should I use Minio Uploader?

Minio Uploader fits situations like: documents & Office work in your project.

How do I install Minio Uploader in Claude Code?

Run `npx skills add xiaoyuge886/aigc --skill minio-uploader -a claude-code`. Or copy the skill folder (.claude/skills/minio_uploader in xiaoyuge886/aigc) into .claude/skills/minio-uploader in your project. Claude Code loads it when a task matches its description.

How do I install Minio Uploader in Codex?

Run `npx skills add xiaoyuge886/aigc --skill minio-uploader -a codex`. Or copy the skill folder (.claude/skills/minio_uploader in xiaoyuge886/aigc) into .agents/skills/minio-uploader in your project. Codex loads it when a task matches its description.

Can I use Minio Uploader in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xiaoyuge886/aigc --skill minio-uploader -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minio-uploader, .gemini/skills/minio-uploader, .github/skills/minio-uploader and .opencode/skills/minio-uploader in your project.

What does Minio Uploader need to run?

Going by SKILL.md and its folder, Minio Uploader needs Python for the scripts in its folder, the command-line tools its instructions call (python and pip) and credentials named MINIO_ACCESS_KEY and MINIO_SECRET_KEY. Our summary lists: Python 3; A credential in MINIO_ACCESS_KEY; A credential in MINIO_SECRET_KEY. Its frontmatter pre-approves these tools: Read, Write, Bash, Glob.

Does Minio Uploader access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Minio Uploader safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Minio Uploader use?

Minio Uploader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Minio Uploader use?

About 641 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Minio Uploader?

Skills that share tags, products or a category with Minio Uploader: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minio Uploader?

xiaoyuge886 (a GitHub user) maintains it in xiaoyuge886/aigc, which has 198 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on July 14, 2026.

Source: xiaoyuge886/aigc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.