059 Process 7ca32cc7

PDF Processing Route

Process existing PDFs using Python CLI tools (pikepdf + pdfplumber).

Step 0: Check & Install Dependencies (Do First)

Run immediately before using pdf.py commands—package installation takes time.

/app/.kimi/skills/pdf/scripts/setup.sh

The script only checks status, does not auto-install. If missing, install manually:

• Python 3: brew install python3 (macOS) / apt install python3 (Ubuntu)
• Dependencies: pip install pikepdf pdfplumber --user

Command Reference

python3 /app/.kimi/skills/pdf/scripts/pdf.py <command> <subcommand> [options]

Output Format

All commands output JSON:

// Success
{"status": "success", "data": {...}}

// Error (to stderr)
{"status": "error", "error": "ErrorType", "message": "Description", "hint": "Suggestion"}

Exit Codes

Form Filling Workflow

Step 1: Check form fields

python3 /app/.kimi/skills/pdf/scripts/pdf.py form info input.pdf

Output example:

{
  "status": "success",
  "data": {
    "has_fields": true,
    "count": 5,
    "fields": [
      {"id": "name", "type": "text", "page": 1},
      {"id": "agree", "type": "checkbox", "states": ["/Yes", "/Off"], "checked_value": "/Yes", "page": 1},
      {"id": "country", "type": "dropdown", "options": [{"value": "US", "label": "US"}, {"value": "CN", "label": "CN"}], "page": 1}
    ]
  }
}

Step 2: Fill form

python3 /app/.kimi/skills/pdf/scripts/pdf.py form fill input.pdf -o output.pdf -d '{"name": "John", "agree": "true", "country": "US"}'

Field Value Rules

Important: For checkbox fields, use "true" or "false" as string values. The script automatically converts them to the correct PDF values (/Yes, /On, /Off, etc.).

Text and Table Extraction

Extract text:

python3 /app/.kimi/skills/pdf/scripts/pdf.py extract text document.pdf
python3 /app/.kimi/skills/pdf/scripts/pdf.py extract text document.pdf -p 1-3    # Pages 1-3 only
python3 /app/.kimi/skills/pdf/scripts/pdf.py extract text document.pdf -p 1,3,5  # Specific pages

Extract tables:

python3 /app/.kimi/skills/pdf/scripts/pdf.py extract table document.pdf

Output includes structured table data:

{
  "total_pages": 10,
  "extracted_pages": 10,
  "total_tables": 3,
  "tables": [
    {
      "page": 1,
      "table_index": 0,
      "rows": 5,
      "cols": 3,
      "data": [["Header1", "Header2", "Header3"], ["A", "B", "C"], ...]
    }
  ]
}

Page Operations

Merge PDFs:

python3 /app/.kimi/skills/pdf/scripts/pdf.py pages merge a.pdf b.pdf c.pdf -o merged.pdf

Split PDF:

python3 /app/.kimi/skills/pdf/scripts/pdf.py pages split document.pdf -o ./output_dir/

Rotate pages:

python3 /app/.kimi/skills/pdf/scripts/pdf.py pages rotate document.pdf 90 -o rotated.pdf
python3 /app/.kimi/skills/pdf/scripts/pdf.py pages rotate document.pdf 180 -o rotated.pdf -p 1-3  # Specific pages

Crop pages:

python3 /app/.kimi/skills/pdf/scripts/pdf.py pages crop document.pdf 50,50,550,750 -o cropped.pdf

Box format: left,bottom,right,top in points (1 inch = 72 points).

Metadata Operations

Read metadata:

python3 /app/.kimi/skills/pdf/scripts/pdf.py meta get document.pdf

Set metadata:

python3 /app/.kimi/skills/pdf/scripts/pdf.py meta set document.pdf -o output.pdf -d '{"Title": "My Document", "Author": "John Doe"}'

Supported fields: Title, Author, Subject, Keywords, Creator, Producer

Office to PDF Conversion

Trigger: User requests converting PPTX, DOCX, XLSX, or other Office documents to PDF Use case: Preserve original formatting, layout, fonts; suitable for batch conversion

Requires: LibreOffice installed

python3 /app/.kimi/skills/pdf/scripts/pdf.py convert input.docx -o output.pdf

Or use LibreOffice directly for batch conversion:

soffice --headless --convert-to pdf --outdir ./output *.pptx *.docx

Supported formats: .docx, .doc, .odt, .rtf, .pptx, .ppt, .odp, .xlsx, .xls, .ods, .csv, .txt, .html

Script Reference

Tech Stack

Important Notes

Password-Protected PDFs

Not supported. The CLI commands do not support encrypted PDFs. If user provides a password-protected PDF, inform them that this feature is not available and suggest they decrypt the PDF first using other tools.

Large File Handling

Memory usage: Roughly 2-3x file size. For a 100MB PDF, expect ~300MB RAM usage.

Error Recovery

If a command fails mid-operation:

• Merge: Partial output may exist, delete and retry
• Split: Some pages may be written, check output directory
• Form fill: Original file unchanged (writes to new file)