🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Document Handler
πŸ¦€ ClawHub

Document Handler

by @neckr0ik

Read, extract text and metadata, and convert documents in formats like PDF, DOCX, XLSX, PPTX, EPUB, RTF, and OpenDocument.

Versionv1.0.0
Downloads812
Installs3
#legal
TERMINAL
clawhub install document-handler

πŸ“– About This Skill

name: document-handler description: Read, extract, and convert document files (PDF, DOCX, XLSX, PPTX, EPUB, RTF, ODT, ODS, ODP). Use when working with any document format: extracting text, metadata, converting formats, or processing content. Triggers on mentions of document files, file paths with document extensions, or requests to read/convert documents.

Document Handler

Extract text, metadata, and content from any document format.

Supported Formats

| Format | Extensions | Text Extract | Metadata | Convert | |--------|------------|--------------|----------|---------| | PDF | .pdf | βœ… pdftotext | βœ… pdfinfo | βœ… pdftoppm | | Word | .docx | βœ… unzip + xml | βœ… | βœ… | | Excel | .xlsx | βœ… unzip + xml | βœ… | βœ… | | PowerPoint | .pptx | βœ… unzip + xml | βœ… | βœ… | | EPUB | .epub | βœ… unzip + html | βœ… | βœ… | | RTF | .rtf | βœ… textutil | βœ… | βœ… | | OpenDocument | .odt, .ods, .odp | βœ… unzip + xml | βœ… | βœ… |

Quick Commands

PDF

# Extract text
pdftotext -layout input.pdf output.txt
Get metadata

pdfinfo input.pdf
Convert to images (for OCR or viewing)

pdftoppm -png input.pdf output_prefix
Extract specific pages

pdftotext -f 5 -l 10 -layout input.pdf output.txt

DOCX/XLSX/PPTX (Office Open XML)

# Extract text from DOCX
unzip -p input.docx word/document.xml | sed 's/<[^>]*>//g' | tr -s ' \n'
Extract text from XLSX (all sheets)

unzip -p input.xlsx xl/sharedStrings.xml | sed 's/<[^>]*>//g' | tr -s '\n'
Extract text from PPTX

unzip -p input.pptx ppt/slides/*.xml | sed 's/<[^>]*>//g' | tr -s ' \n'
Get metadata

unzip -p input.docx docProps/core.xml

RTF (macOS)

# Convert RTF to plain text
textutil -convert txt input.rtf -output output.txt
Convert RTF to HTML

textutil -convert html input.rtf -output output.html

EPUB

# Extract and read EPUB content
unzip -l input.epub                    # List contents
unzip -p input.epub "*.html" | lynx -stdin -dump  # Text via lynx
unzip -p input.epub "*.xhtml" | sed 's/<[^>]*>//g'  # Raw text

OpenDocument (ODT/ODS/ODP)

# Extract text from ODT
unzip -p input.odt content.xml | sed 's/<[^>]*>//g' | tr -s ' \n'
Extract from ODS

unzip -p input.ods content.xml | sed 's/<[^>]*>//g'
Get metadata

unzip -p input.odt meta.xml

Scripts

extract_document.sh

Extracts text and metadata from any supported document format.

~/Dropbox/jarvis/skills/document-handler/scripts/extract_document.sh

Output:

  • Text content to stdout
  • Metadata as JSON comments

    • pdf_to_images.sh

    Converts PDF pages to images for OCR or visual processing.

    ~/Dropbox/jarvis/skills/document-handler/scripts/pdf_to_images.sh   [dpi]

    Workflow

    1. Identify format β€” Check file extension 2. Extract text β€” Use appropriate tool 3. Get metadata β€” Author, date, pages, etc. 4. Process content β€” Summarize, search, transform

    Notes

  • PDFs with scanned images need OCR (pdftoppm + tesseract)
  • Encrypted PDFs require password
  • Complex formatting may be lost in text extraction
  • For tables in PDFs, consider tabula or camelot

    • πŸ“‹ Tips & Best Practices

  • PDFs with scanned images need OCR (pdftoppm + tesseract)
  • Encrypted PDFs require password
  • Complex formatting may be lost in text extraction
  • For tables in PDFs, consider tabula or camelot