What problem does it solve?
Converting heterogeneous documents (PDF, Word, Excel) into clean, machine-readable text for RAG pipelines and knowledge bases usually requires juggling multiple parsers and handling failures manually. This Skill automates multi-format document parsing with a three-level fallback chain, outputting structured Markdown, metadata, and a confidence score.
Core Features & Use Cases
- Three-Level Parser Fallback: Tries MinerU first for layout fidelity, falls back to PyMuPDF for fast PDF parsing, then pdfplumber for table and text extraction.
- Structured Output: Returns Markdown body, metadata (title, page count, table count, author), a 0-1 confidence score, and the name of the parser that succeeded.
- Failure Handling: Marks unparseable files for manual review instead of returning partial results, and chunks oversized pages to avoid memory overflow.
- Use Case: When building an enterprise knowledge base, feed scanned contracts and reports through this Skill to obtain confidence-scored Markdown that downstream retrieval and extraction stages can consume directly.
Quick Start
Run the script with python skills/doc-parse/scripts/run_doc_parse.py to parse the input documents and write the structured results to examples/snse_survey/skill_outputs/doc_parse.json.