document-skills

# Document Skills An umbrella skill covering real, structured file manipulation for the four major office document formats — actual files, not text approximations of them. ## Format-specific coverage ### PDF - Extract text, tables, and images from existing PDFs, including OCR for scanned documents. - Fill PDF forms programmatically. - Create new PDFs, merge/split/rotate pages, add watermarks, encrypt/decrypt. ### DOCX - Read and extract structured content (headings, tables, tracked changes, comments) from Word documents. - Create professional documents with proper structure: headings, table of contents, page numbers, styles — not just plain paragraphs. - Edit existing documents in place (find-and-replace, image insertion/replacement) while preserving formatting. ### XLSX - Read and clean messy tabular data (misaligned headers, malformed rows) into a proper structured spreadsheet. - Compute formulas, add charts, and format existing spreadsheets. - Create new spreadsheets/models from other data sources. ### PPTX - Read and extract text/notes from existing slide decks, including speaker notes and comments. - Create new decks with proper slide structure and layouts. - Edit existing presentations, including working with templates (.potx) and layouts. ## Core principle For all four formats, work happens through real file manipulation (via the appropriate scripts/libraries for each format), producing an actual downloadable file — never simulate a document's contents as plain text or markdown when a real file of the correct type was requested, since that isn't usable the way the real format is (openable in Word/Excel/PowerPoint/a PDF viewer, preserving formatting, formulas, slide structure, etc.). ## Workflow 1. Identify the format involved (from the file the user uploaded, or from what they want produced). 2. Read the relevant format-specific approach before starting — each format has different libraries, quirks, and constraints that materially affect output quality. 3. For edits: work on the actual uploaded file, preserving everything not explicitly being changed. 4. For creation: build the file with proper structure for its format (real headings in DOCX, real formulas in XLSX, real slide layouts in PPTX, real form fields in PDF) rather than a flat, unstructured approximation. 5. Deliver the actual file to the user, not a text description of what it would contain.