document-quality-standardslisted

# Document Quality Standards Patterns that complement the official `document-skills` plugin. Apply these alongside xlsx, pdf, docx, and pptx skills. ## Visual-First Verification **Core principle**: Text extraction misses critical details. Always verify visually. > "Only do python printing as a last resort because you will miss important details with text extraction (e.g. figures, tables, diagrams)." ### The Render-Inspect-Fix Loop For ANY document operation (create, edit, convert): ``` 1. Generate/modify document 2. Convert to PNG: pdftoppm -png -r 150 document.pdf output 3. Visually inspect the PNG at 100% zoom 4. Fix any issues found 5. REPEAT until clean ``` **Never deliver a document without PNG verification.** This catches: - Clipped or overlapping text - Broken tables - Missing figures - Formatting inconsistencies - Orphans/widows - Unreadable characters ### Quick Conversion Commands ```bash # DOCX → PDF → PNG soffice --headless --convert-to pdf document.docx pdftoppm -png -r 150 document.pdf page # PDF → PNG directly pdftoppm -png -r 150 document.pdf page # PPTX → PDF → PNG soffice --headless --convert-to pdf presentation.pptx pdftoppm -png -r 150 presentation.pdf slide ``` ## Typography Hygiene ### Hyphen Safety **Never use non-breaking hyphens (U+2011)**. They cause rendering failures in many viewers. ```python # WRONG - may render as boxes or break layouts text = "co‑author" # U+2011 non-breaking hyphen # CORRECT - always use ASCII hyphen text =