Document Tools

Tools for reading and writing document formats (PDF, images, Excel).

read_pdf

Extract text content from a PDF file.

Parameter	Type	Description
path	string	Path to PDF file
pages	string	Page range (e.g., "1-5", "3", optional)

Classification: Host

Return shape:

{
  "status": "success",
  "stdout": "extracted text from PDF pages",
  "exit_code": 0,
  "duration_ms": 200
}

read_image

Read an image file and return its contents for analysis.

Parameter	Type	Description
path	string	Path to image file

Classification: Host

Supported formats: PNG, JPEG, BMP, GIF, TIFF, WebP

Return shape:

{
  "status": "success",
  "stdout": "image description or base64 data",
  "image_b64": "base64 encoded image",
  "exit_code": 0,
  "duration_ms": 50
}

read_excel

Read data from an Excel spreadsheet.

Parameter	Type	Description
path	string	Path to Excel file
sheet	string	Sheet name (optional, defaults to first sheet)
range	string	Cell range (e.g., "A1:D10", optional)

Classification: Host

Supported formats: .xlsx, .xls, .csv

Return shape:

{
  "status": "success",
  "stdout": "tabular data as formatted text",
  "exit_code": 0,
  "duration_ms": 100
}

write_excel

Write data to an Excel spreadsheet.

Parameter	Type	Description
path	string	Output file path
data	array	Array of row arrays
sheet	string	Sheet name (optional)

Classification: Host (path-checked)

Return shape:

{
  "status": "success",
  "stdout": "Excel file written successfully",
  "exit_code": 0,
  "duration_ms": 150
}

convert_document

Convert a document to another format. Provided by the office-documents built-in skill.

Parameter	Type	Description
input_path	string	Absolute path to the source document
output_format	string	Target format: "pdf", "csv", "png", "jpg", "html" (default: "pdf")
output_path	string	Where to save the result (optional — defaults to input file with new extension)
sheet_name	string	For spreadsheets, which sheet to convert (optional — defaults to active/first sheet)

Classification: Host (skill tool)

Conversion methods (auto-detected by priority):

Priority	Method	Platforms	Formats	Notes
1	Microsoft Office COM	Windows	PDF	Best quality for Office files
2	LibreOffice headless	All	PDF, CSV, PNG, JPG, HTML	Install LibreOffice for broadest support
3	Python (openpyxl + fpdf2)	All	PDF, CSV	Fallback, basic formatting

Return shape:

{
  "status": "success",
  "output_path": "/path/to/output.pdf",
  "method": "office_com",
  "input_format": "xlsx",
  "output_format": "pdf",
  "duration_ms": 3500,
  "voice_message": "Converted to pdf successfully."
}

Notes:

• Automatically detects the best conversion method available on the system
• Returns install_hint when a required Python package is missing (e.g., pip install fpdf2)
• Requires load_skill(skill_name="office-documents") before first use

---

Related: Core Tools · File Tools