officebeats Runtime Compatibility: Use the active runtime and its positively detected capabilities; inherit its model unless an evaluated local promotion exists.
Document Exporter Skill
Use this skill when the user requests a PDF, Word Doc, PowerPoint, Excel export, or "Export" of a markdown file.
Capabilities
- Markdown → HTML → PDF: Creates a self-contained HTML file, then uses Headless Chrome to print to PDF.
- Markdown → DOCX (via OfficeCLI): Creates a real Word document with proper formatting.
- Markdown → PPTX (via OfficeCLI): Creates a PowerPoint presentation from structured content.
- Markdown → XLSX (via OfficeCLI): Creates an Excel workbook from tabular data.
Format Selection
| User Says | Action |
|---|---|
| "PDF", "print" | Use existing HTML/PDF pipeline (Steps 1-4 below) |
| "Word", "DOCX", "document" | Delegate to office-cli skill |
| "PowerPoint", "PPTX", "deck", "presentation", "slides" | Delegate to office-cli skill |
| "Excel", "XLSX", "spreadsheet", "tracker" | Delegate to office-cli skill |
| "export" (no format specified) | Ask user; default PPTX for presentations, DOCX for docs, PDF for reports |
PDF Pipeline Instructions
1. Locate the Markdown File
Ensure you have the absolute path to the .md file.
2. Generate HTML (Intermediate Step)
Run the md_to_pdf.py script located in scripts/.
python3 .agent/skills/document-exporter/scripts/md_to_pdf.py [INPUT_MD] [OUTPUT_HTML]
3. Convert to PDF (Final Step)
Use Headless Chrome to convert the HTML to PDF.
# macOS
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless --disable-gpu --print-to-pdf="[OUTPUT_PDF]" "[OUTPUT_HTML]"
# Windows
& "C:\Program Files\Google\Chrome\Application\chrome.exe" --headless --disable-gpu --print-to-pdf="[OUTPUT_PDF]" "[OUTPUT_HTML]"
4. Verify & Notify
- Check the file size of the PDF (should be > 100KB if images are included).
- Notify user with the file path.
Office Format Instructions
For DOCX, PPTX, or XLSX exports, load and follow the office-cli skill:
.agent/skills/office-cli/SKILL.md
The office-cli skill has complete workflows for:
- Creating PowerPoint decks with slides, shapes, tables, charts, and images
- Creating Word documents with paragraphs, styles, tables, and images
- Creating Excel workbooks with data, formulas, charts, and pivot tables
Quick Delegation Example
# User wants a PowerPoint from a markdown outline:
# 1. Parse the markdown headings as slide titles
# 2. Parse bullet points as slide content
# 3. Use officecli batch mode for performance
officecli create output.pptx
officecli batch output.pptx --commands '[
{"command":"add","parent":"/","type":"slide","props":{"title":"Slide Title from H1"}},
{"command":"add","parent":"/slide[1]","type":"shape","props":{"text":"Content from bullets","x":"2cm","y":"5cm","w":"22cm","h":"12cm","font":"Arial","size":"18"}}
]' --json