菜单
Use when extracting PDF documents to markdown with mineru-open-api. Use when agent chooses flash-extract for documents over 20 pages or when auth failure occurs during extraction.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when writing, revising, or auditing a standalone Markdown explanation of a research paper. Produces image-supported, source-verified explanations for an average reader in the paper's field, prioritizes the paper's mechanisms and algorithms over background or benchmark dumps, checks appendices/code/official web resources, follows md-report-writer information-density rules, and runs separate Reviewer and Reader subagents.
Use when generating a physics or engineering experiment report from measured data and reference materials — orchestrates Theory, Data Analysis, Plotting, and Report sub-agents to produce a compiled LaTeX PDF. Also use for any sub-task in that pipeline: deriving formulas, analyzing lab data, plotting measurements with theory overlay, or writing/compiling the report.
Use when creating LaTeX Beamer presentation slides from documents, especially for academic presentations. Use when source document contains structured content with sections, subsections, or clear hierarchical organization that should be preserved in slides.
Professional LaTeX experiment report writing assistant for physics and engineering. Focuses on narrative flow, coherent explanations, proper academic style, structured content, and LaTeX best practices.
Use when writing math textbook content in XeLaTeX, including definitions, theorems, proofs, and section formatting in English or Chinese.
Use when enhancing existing lecture notes with multiple course source materials (recordings, PPT slides, existing notes)
| name | mineru |
| description | Use when extracting PDF documents to markdown with mineru-open-api. Use when agent chooses flash-extract for documents over 20 pages or when auth failure occurs during extraction. |
Use the extract command (not flash-extract) for PDF to Markdown conversion. The user has already configured API credentials, so precision extraction is available. Flash-extract is a 20-page preview tool, not for production use.
⚠️ Default Behavior for this Skill: Always use -o parameter to output to a file. While mineru-open-api extract defaults to stdout, this skill requires file output to preserve assets and avoid terminal clutter.
| Scenario | Command | Notes |
|---|---|---|
| Extract to file (Recommended) | mineru-open-api extract file.pdf -o ./out/ | Default for this skill - saves with assets |
| Extract to stdout | mineru-open-api extract file.pdf | Outputs to terminal - NOT recommended |
| Batch processing | mineru-open-api extract *.pdf -o ./results/ | Multiple files at once |
| Specific format | mineru-open-api extract file.pdf -f md,html | Multiple output formats |
| Page range | mineru-open-api extract file.pdf --pages 1-50 | Extract specific pages |
digraph mineru_flowchart {
"Need to extract PDF?" [shape=diamond];
"Document <= 20 pages AND no API configured?" [shape=diamond];
"Use flash-extract" [shape=box, style=dashed];
"Use extract command" [shape=box];
"Auth fails?" [shape=diamond];
"Prompt user: Configure API token" [shape=box];
"Need to extract PDF?" -> "Document <= 20 pages AND no API configured?";
"Document <= 20 pages AND no API configured?" -> "Use flash-extract" [label="yes (preview only)"];
"Document <= 20 pages AND no API configured?" -> "Use extract command" [label="no (most cases)"];
"Use extract command" -> "Auth fails?";
"Auth fails?" -> "Prompt user: Configure API token" [label="yes"];
}
| Feature | extract | flash-extract |
|---|---|---|
| Auth Required | Yes | No |
| Max Pages | 600 | 20 |
| Max File Size | 200MB | 10MB |
| Formats | md, json, html, latex, docx | md only |
| Assets | Full images, tables, formulas | Placeholders only |
| Use Case | Production extraction | Quick preview only |
# Extract to directory with all assets (RECOMMENDED)
mineru-open-api extract document.pdf -o ./output/
# Extract multiple formats
mineru-open-api extract document.pdf -o ./out/ -f md,html,latex
# Extract to stdout (markdown) - NOT recommended, use only for debugging
mineru-open-api extract document.pdf
# Multiple PDFs
mineru-open-api extract *.pdf -o ./results/
# From file list
mineru-open-api extract --list files.txt -o ./results/
If mineru-open-api extract fails with authentication error:
Inform the user:
The extract command requires API authentication. Please configure your MinerU API token:
mineru-open-api auth
After configuring the token, extraction will work for documents up to 600 pages and 200MB.
Do NOT fallback to flash-extract without warning. Flash-extract has a 20-page limit and will truncate larger documents.
| Mistake | Problem | Fix |
|---|---|---|
Not using -o parameter | Outputs to terminal, loses assets, clutters console | Always use -o to save to file |
| Using flash-extract for large PDFs | 20-page hard limit, truncates content | Always use extract for production |
| Flashing because "faster" | Preview quality, missing assets | User configured API — use it |
| Silent fallback to flash | Data loss without warning | Prompt user to configure auth |
| Extracting without checking page count | Unknown if content is complete | Verify document size first |
[Image: 1] instead of actual images