TengJiao33/ChemVellum / skills/mineru-precise-parse-chemvellum
mineru-precise-parse-chemvellum
VerifiedParse local literature PDFs under a ChemVellum checkout into Markdown with the MinerU precise parsing batch API. Use when Codex needs to batch-convert a chemistry review library, preserve full MinerU zip sidecars, keep extracted images and JSON outputs, and skip files that were already parsed unless a force rerun is explicitly requested.
MinerU Precise Parse for ChemVellum
Use this skill when the task is to convert a local PDF library into review-ready Markdown with the MinerU precise parsing API.
This skill is for batch parsing only. It uploads local PDFs to MinerU, waits for batch completion, downloads the result zip for each PDF, extracts full.md, rewrites image paths, and writes a local manifest.
Default Paths
- input root:
<review-root>/chem_papers - skill root:
<review-root>/skills/mineru-precise-parse-chemvellum - output root:
<review-root>/mineru-outputs
The parser scans the input root recursively for *.pdf files and ignores the skill directory and output directory.
Auth
Token resolution order:
--token <token>MINERU_API_TOKEN- the untracked local file
config/mineru_api_token.txt
Never commit a token. Prefer MINERU_API_TOKEN; use the local config file only
when an environment variable is impractical.
Default Behavior
Parsing is incremental by default:
- if
mineru-outputs/markdown/<slug>.mdalready exists, skip that PDF - reparse only when the user explicitly wants a rerun and
--forceis passed
Commands
Parse the whole local library:
python3 scripts/parse_chemvellum_pdfs.py
Parse only one or two files as a smoke test:
python3 scripts/parse_chemvellum_pdfs.py --limit 2
Force a full rerun:
python3 scripts/parse_chemvellum_pdfs.py --force
Parse a specific subtree:
python3 skills/mineru-precise-parse-chemvellum/scripts/parse_chemvellum_pdfs.py --input-dir chem_papers
Parse one specific PDF:
python3 skills/mineru-precise-parse-chemvellum/scripts/parse_chemvellum_pdfs.py --pdf chem_papers/example.pdf
Parse an explicit batch without scanning unrelated PDFs:
python3 skills/mineru-precise-parse-chemvellum/scripts/parse_chemvellum_pdfs.py \
--pdf chem_papers/web-imports/paper-1.pdf \
--pdf chem_papers/web-imports/paper-2.pdf \
--batch-size 10
Outputs
The skill writes:
mineru-outputs/markdown/*.mdmineru-outputs/extracted/<slug>/mineru-outputs/raw_zips/*.zipmineru-outputs/manifest.jsonmineru-outputs/runs/<run_id>.json
manifest.json is the latest-run pointer. Every actual parsing invocation also
writes a timestamp-and-process run manifest under runs/, so a later invocation
does not erase the earlier execution record. The Markdown copies are the main deliverable.
The extracted directories keep full.md, images, and MinerU sidecar JSON for downstream chunking, provenance, and figure extraction.
Boundary
Use this skill only for PDF-to-Markdown conversion.
Do not use it to:
- clean or rewrite the parsed Markdown
- synthesize the review itself
- treat MinerU output as already validated evidence
- replace later chunking, indexing, or citation-grounding stages
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |