MinerU PDF Converter

Bash CLI wrapper meant to convert PDFs to Markdown via a bundled MinerU venv

Tested · Didn't pass

Test report

Verdict
Tested · Didn't pass
Tested
Jul 17, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 7e7d382

The skill's own CLI is dead on arrival: running bin/mineru-cli aborts at line 14 with 'lib/logger.sh: No such file or directory' because the entire lib/ folder and the env/mineru_venv Python environment it sources are excluded by .gitignore and never shipped. The docs advertise 'fully encapsulated, zero external dependencies' and hardcode /Users/CS/... install paths, yet none of the core libraries or the MinerU engine are present, so no PDF can be converted. Nothing to measure against a baseline because it cannot run at all.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 3/5
  • Triggers reliably 4/5
  • Output vs. baseline 1/10
  • Docs & honesty 1/5

What MinerU PDF Converter does

A shell CLI that claims to convert single or batched PDFs to Markdown using MinerU with automatic temp-file cleanup. Advertised as fully self-contained with zero external dependencies. In practice the engine it needs is not shipped in the repo.

How to install MinerU PDF Converter

git clone https://github.com/CSlawyer1985/mineru-converter-skill
mkdir -p ~/.claude/skills
cp -r mineru-converter-skill ~/.claude/skills/mineru-converter

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger MinerU PDF Converter

  • /mineru-converter Bash CLI wrapper meant to convert PDFs to Markdown via a bundled MinerU venv

It also activates on plain-language prompts like these:

  • Convert this PDF into Markdown using MinerU
  • Batch convert these research PDFs into Markdown files
  • Turn my scanned PDF report into clean Markdown text

Frequently asked questions

Is the MinerU PDF Converter skill free?
Yes. The skill itself is free from CSlawyer1985/mineru-converter-skill. SkillProof publishes the install command and an independent test verdict at no cost.
Does MinerU PDF Converter work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 17, 2026. Verdict: Tested · Didn't pass. The skill's own CLI is dead on arrival: running bin/mineru-cli aborts at line 14 with 'lib/logger.sh: No such file or directory' because the entire lib/ folder and the env/mineru_venv Python environment it sources are excluded by .gitignore and never shipped. The docs advertise 'fully encapsulated, zero external dependencies' and hardcode /Users/CS/... install paths, yet none of the core libraries or the MinerU engine are present, so no PDF can be converted. Nothing to measure against a baseline because it cannot run at all.
How do I install MinerU PDF Converter?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use MinerU PDF Converter with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.