mineru — Claude Code skill: what it does, how to install
This skill uses MinerU to read, parse, search, OCR, and cite local documents. It fits PDFs, scans, tables, and long files.
npx skills add opendatalab/MinerU --skill mineru -a claude-codeWhat mineru does
The skill directs the agent to the mineru command-line tool for local document work. MinerU parses PDFs, images, Word, PowerPoint, and Excel files, plus RTF, OpenDocument, EPUB, OFD, HTML, MHTML, CSV, and TSV. The agent can read results in parts, search processed documents, and retrieve page or block images.
MinerU returns stable page and block locators for follow-up reads and citations. The skill covers OCR, tables, formulas, and complex page layouts; it is not a RAG framework or vector database. It requires the MinerU CLI at version >=4.0,<5 and Python >=3.10,<3.15. Without a compatible CLI version, the skill's commands cannot run.
What it helps with
- read a local PDF and answer questions about it
- OCR scanned pages or document images
- extract tables and formulas from a file
- continue through a long document from a page locator
- search documents that MinerU has already processed
Example prompts for the agent
- Read
contract.pdfand list its termination conditions. - OCR
report.jpg, then find every mention of amounts and dates. - Continue from the returned document locator and cite the relevant page.
How to install mineru
1Skills CLI (Vercel)
npx skills add opendatalab/MinerU --skill mineru -a claude-code2Manually: put the files in place
~/.claude/skills/mineru/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mineru/
1Skills CLI (Vercel)
npx skills add opendatalab/MinerU --skill mineru -a codex2Manually: put the files in place
.agents/skills/mineru/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add opendatalab/MinerU --skill mineru -a cursor2Manually: put the files in place
.cursor/skills/mineru/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install opendatalab/MinerU mineru2Manually: put the files in place
.github/skills/mineru/SKILL.md1Skills CLI (Vercel)
npx skills add opendatalab/MinerU --skill mineru -a gemini-cli2Platform CLI
gemini skills install https://github.com/opendatalab/MinerU --path skills/mineruManually: put the files in place
.devin/skills/mineru/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add opendatalab/MinerU --skill mineru -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mineru
How do I install mineru in Claude Code?
Run npx skills add opendatalab/MinerU --skill mineru -a claude-code, then check ~/.claude/skills/mineru/SKILL.md.
What does the mineru skill do?
It tells the agent to use mineru for reading, OCR, parsing, searching, and citing local documents. Page and block locators support follow-up reads.
Which files can mineru parse?
The skill covers PDFs, images, Word, PowerPoint, Excel, RTF, OpenDocument, EPUB, OFD, HTML, MHTML, CSV, and TSV. Plain-text files such as .txt and .md are read directly.
