Skip to content

TengJiao33/ChemVellum / skills/mineru-precise-parse-chemvellum

mineru-precise-parse-chemvellum

Verified

Parse 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:

  1. --token <token>
  2. MINERU_API_TOKEN
  3. 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>.md already exists, skip that PDF
  • reparse only when the user explicitly wants a rerun and --force is 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/*.md
  • mineru-outputs/extracted/<slug>/
  • mineru-outputs/raw_zips/*.zip
  • mineru-outputs/manifest.json
  • mineru-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
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall