Mineru Converter

PDF转Markdown工具,基于MinerU和方案A++策略,完全封装的CLI工具+Skill,自动清理临时文件,支持单文件和批量处理

40 stars 6 forksDocuments & Office Files

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add CSlawyer1985/mineru-converter-skill --skill mineru-converter
Manual install
git clone --depth 1 https://github.com/CSlawyer1985/mineru-converter-skill.git /tmp/mineru-converter-skill
mkdir -p ~/.claude/skills
cp -r /tmp/mineru-converter-skill/. ~/.claude/skills/mineru-converter

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# MinerU PDF转换器

## 快速开始

### 使用方式1:Claude自然语言调用
用户: "处理这个PDF文件"
Claude: [自动调用mineru-cli,处理完成后清理临时文件]

### 使用方式2:直接命令行调用
```bash
# 直接调用Skill中的CLI
/Users/CS/.claude/skills/mineru-converter/bin/mineru-cli convert file.pdf -o output/

# 或创建符号链接后简化调用
mineru-cli convert file.pdf -o output/
```

## 核心特性
✅ **完全封装**:CLI工具集成在Skill目录内,零外部依赖
✅ **方案A++策略**:每文件独立进程,自动内存释放
✅ **自动清理**:只保留最终MD文件,临时文件自动删除
✅ **灵活输出**:可指定输出目录,默认为PDF所在目录
✅ **错误重试**:自动重试3次,提高成功率
✅ **进度监控**:实时反馈处理状态和性能指标

## 技术架构
- **Skill位置**: `/Users/CS/.claude/skills/mineru-converter/`
- **CLI工具**: `bin/mineru-cli`(集成在skill内)
- **核心库**: `lib/*.sh`(processor.sh, cleanup.sh, validator.sh, logger.sh)
- **虚拟环境**: `env/mineru_venv/`(封装在skill内)
- **参考脚本**: `scripts/*.sh`(封装在skill内)
- **处理策略**: 方案A++(单文件独立进程 + GPU加速1GB)

## 目录结构

```
mineru-converter/
├── SKILL.md          # 本文件
├── README.md         # 详细使用文档
├── bin/
│   └── mineru-cli    # CLI主入口
├── lib/              # 核心库
│   ├── processor.sh  # 核心处理逻辑
│   ├── cleanup.sh    # 清理工具
│   ├── validator.sh  # 文件验证
│   └── logger.sh     # 日志管理
├── env/
│   └── mineru_venv/  # Python虚拟环境(封装)
├── scripts/          # 参考脚本(封装)
│   ├── batch_mineru_safe.sh
│   ├── batch_mineru_medium.sh
│   └── batch_mineru_mild.sh
├── config/
│   └── default.conf  # 默认配置
└── references/       # 参考资料
    └── mineru-official-docs.md
```

## 一键安装

```bash
# 创建符号链接到PATH(推荐)
ln -s /Users/CS/.claude/skills/mineru-converter/bin/mineru-cli \
      /usr/local/bin/mineru-cli

# 验证安装
mineru-cli --version
```
Read the full skill on GitHub

Details

Skill name
mineru-converter
Repo updated
2 February 2026

FAQ

What does the Mineru Converter skill do?

PDF转Markdown工具,基于MinerU和方案A++策略,完全封装的CLI工具+Skill,自动清理临时文件,支持单文件和批量处理

How do I install the Mineru Converter skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add CSlawyer1985/mineru-converter-skill --skill mineru-converter. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Mineru Converter popular?

It lives in CSlawyer1985/mineru-converter-skill, which has 40 GitHub stars and 6 forks.

Related skills

Skill Gateway

44

buraksu42/skill-gateway

Skill Gateway — Rule all skills. PRIORITY: Consult this skill BEFORE any other skill for ANY task-oriented request. Skill Gateway is the router that decides which skill(s) to use. Trigger for: ANY file creation (docs, PDFs, slides, spreadsheets), ANY coding/building task, ANY design/creative request, ANY data analysis or automation, ANY "how do I", "can Claude", "is there a skill for", "help me with" question, ANY vague or ambiguous request. Also trigger when user asks "which skill", "find a skill", wants to automate something, or describes a problem/workflow. ONLY skip for pure conversational

Documents & Office Files

Research Report Reader

44

silentdog918/research-report-reader-skill

**投研报告精读助手**:系统化阅读、提炼和分析投资研究报告(券商研报、行业报告、宏观策略报告等)。 - 必须触发场景:用户上传PDF研究报告并要求阅读、分析、总结、精读、提炼要点时自动激活。 - 也适用于:用户说"帮我读报告"、"分析这几篇研报"、"研报精读"、"总结一下这些报告"、"报告的核心观点是什么"、"这些报告值得读吗"、"帮我看看这些PDF"等。 - 即使用户没有明确说"研报",只要上传了看起来像投资研究报告的PDF文件并要求分析或总结,也应触发。 - 当用户上传多篇报告时,不仅逐篇分析,还会做跨报告交叉比对并推荐精读篇目。

Documents & Office Files

Tianji

37

Ficere/tianji

天机:八字、紫微、称骨、星座与姓名民俗分析,支持 1–8 人真太阳时排盘、个人与场景合盘及固定金墨风 Markdown/HTML/PDF 报告。仅用于明确命理请求;普通关系、工作、亲子咨询不触发。

Documents & Office Files

Deck Dna

47

opitaru-sys/deck-dna

Build a brand-accurate PPTX deck from your own reference decks - extracted design DNA, a calibrated word budget, real backgrounds/fonts embedded so it renders identically anywhere, and a render-QA loop. Use whenever a deliverable is a slide deck that needs to look like your real client/brand decks, not a generic template.

Documents & Office Files

Zan HTML to Ppt

38

wangzan101/html-to-ppt-pdf

把 guizang-ppt-skill 生成的 HTML 横向翻页 deck 转成 deck.pdf 和 deck.pptx,供线下演讲、加速器/评委上传、印刷等场子使用。**只要用户提到 HTML deck 转 PPT、deck 导出 PowerPoint、网页 PPT 转 pptx、HTML 转 PowerPoint、把幻灯片/演讲材料/演示文件做成离线版、需要 .pptx 上传,就用这个 skill**,即使用户没说 "guizang" 字样。产出是图片型 PPTX(每页一张 PNG 满版,视觉 100% 还原但内文不可编辑)。

Documents & Office Files

PDF Converter

55

tanis90/pdf-converter-mineru

PDF converter powered by MinerU — convert PDF to Word, Markdown, HTML, LaTeX, or plain text. Also handles image-to-text OCR, scanned document recognition, and Office formats (DOCX, PPTX, Excel). Supports 80+ languages. Use this skill when the user wants to convert, extract, read, parse, or summarize any PDF or document. Also applies when the user shares a PDF file or link and asks about its content, needs tables or formulas extracted, wants PDF OCR, or says things like 'turn this into a doc' or 'what does this paper say'.

Documents & Office Files

Browse the most popular Claude skills, all documents & office files skills, or write your own with the skills generator.