Document parse

Skill flywifi/educator-tools-k12-public/skills/atoms/document-parse

Parse a raw file (PDF, DOCX, XLSX, PPTX, HTML, or scanned image) into a structured document representation (UDOM). Use this atom when a workflow needs to extract text, tables, and layout from an uploaded or crawled file BEFORE applying governance or analysis. Do NOT use for web page scraping — this handles file-based documents only. Do NOT use for reading-level estimation (call atom-reading-level on the extracted text).From its SKILL.md

Install

npx -y skills add flywifi/educator-tools-k12-public --skill document-parse

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.8 KB, as published. Nobody here has run it

document-parse

Parse raw file bytes into a structured document representation (UDOM tree). Used by document-intelligence to separate file parsing from governance, and reusable by standards-updater or any skill that needs to extract content from uploaded documents.

Input

{
  "file_path": "/path/to/uploaded.pdf",
  "file_type": "pdf",
  "parser_hints": {"ocr_engine": "pytesseract", "lang": "en"},
  "confidence_threshold": 0.8
}

Output

{
  "tool": "document-parse",
  "udom": {"type": "document", "children": [{"type": "heading", "text": "Chapter 1"}, {"type": "paragraph", "text": "..."}]},
  "confidence": 0.95,
  "recovery_note": "Full text extraction; no OCR gaps",
  "parser_used": "PyMuPDF",
  "unrecovered_regions": [],
  "human_review_required": true
}

Do NOT use this atom for

Web page scraping (use source-crawl or feed-validate)
Reading level estimation (pass extracted text to atom-reading-level)
Document comparison or diff (this atom extracts, it does not compare)

Pipeline note

Follows references/method.md at the Ingestion step (raw file → UDOM). Output conforms to references/metadata-schema.md. Downstream steps (governance, analysis) are handled by the orchestrator. human_review_required: true — OCR/layout recovery is imperfect; teacher should verify critical content.