Skip to main content
Craft Agent includes built-in tools for working with common document formats. Convert between formats, extract text, merge files, create reports, and process images — all from within your conversation.

​
Quick Reference

ToolWhat it doesFormats
markitdownConvert any document to Markdown.docx, .xlsx, .pptx, .pdf, .html, .ipynb, and more
pdf-toolExtract text, merge, split, get info.pdf
xlsx-toolRead, write, export spreadsheets.xlsx, .csv
docx-toolCreate and edit Word documents.docx
pptx-toolRead and inspect presentations.pptx
img-toolResize, convert, get metadata.png, .jpg, .webp, .gif, .svg
doc-diffCompare two documentsAny two files
ical-toolRead and parse calendar files.ics

​
Common Tasks

​
Convert a Document to Text

The most common operation — extract readable text from any document: 
"Read this Word document and summarise it"
"What's in this Excel file?"
"Extract the text from this PDF"
The agent uses markitdown as a universal converter. It handles Word documents, Excel spreadsheets, PowerPoint presentations, PDFs, HTML files, and Jupyter notebooks — converting them all to readable Markdown.

​
Work with PDFs

"Merge these three PDFs into one"
"Extract pages 5-10 from this report"
"How many pages is this PDF?"
The pdf-tool can extract text, merge multiple PDFs, split pages, and get file information (page count, metadata, file size).

​
Process Spreadsheets

"Read the Sales sheet from this Excel file"
"Export this data to a new Excel file"
"Convert this CSV to Excel"
The xlsx-tool reads and writes Excel files, supports multiple sheets, and can export data to CSV.

​
Create Word Documents

"Create a Word document from this meeting summary"
"Turn this markdown into a .docx file"
The docx-tool creates Word documents from text or Markdown content, with support for titles, headings, and basic formatting.

​
Process Images

"Resize this image to 800px wide"
"Convert this PNG to JPEG"
"What are the dimensions of this image?"
The img-tool handles resizing, format conversion, and metadata extraction for common image formats.

​
Compare Documents

"What changed between these two versions of the contract?"
"Compare the old and new spec documents"
The doc-diff tool compares two documents and shows the differences — useful for reviewing revisions, contract changes, or spec updates.

​
Parse Calendar Files

"What events are in this .ics file?"
"Read my exported calendar"
The ical-tool parses .ics calendar files and extracts event details (title, date, time, location, attendees).
All document tools support --help for detailed usage information. If you’re curious about what a specific tool can do, just ask: “What can the pdf-tool do?”
If the agent encounters a binary file it can’t read natively (like .docx or .pptx), it automatically falls back to markitdown to convert the document to readable text. You don’t need to do anything — just ask the agent to read the file.
When the agent creates or converts documents, the output files are saved in the current working directory (or a path you specify). The agent will tell you the exact file path after creation.
Absolutely. You can ask for multi-step workflows like “Read this PDF, extract the financial data, and create an Excel spreadsheet with just the quarterly revenue figures.” The agent will use multiple tools in sequence.