PDF Generator Skill

Generate professionally branded PDFs from markdown documents.

Trigger

User runs /pdf [file] or asks to "generate PDF", "convert to PDF", or "create PDF".

Usage

# Single file
/pdf content/case-studies/project.md

# With custom output
/pdf proposal.md ~/Desktop/client-proposal.pdf

# HTML (for browser printing)
/pdf --html document.md

Workflow

1. Validate Input

• Check file exists
• Verify it's a markdown file
• Check PDF generator is set up

2. Generate PDF

Run the generator script:

./tools/pdf-generator/generate-pdf.sh [input] [output]

3. Report Results

• Confirm PDF location
• Open PDF (on macOS)
• Report any errors

Common Tasks

Convert Case Study

./tools/pdf-generator/generate-pdf.sh content/case-studies/[name].md

Output: tools/pdf-generator/output/[name].pdf

Convert Proposal

./tools/pdf-generator/generate-pdf.sh clients/[client]/proposal.md

Batch Convert

./tools/pdf-generator/generate-pdf.sh --batch content/case-studies/

HTML Fallback

If no PDF engine is installed:

./tools/pdf-generator/generate-pdf.sh --html document.md

Then print to PDF from browser.

Customization

Brand Colors

Edit tools/pdf-generator/templates/styles.css:

:root {
  --primary: #552cd5;    /* Your brand color */
  --accent: #0ea5e9;     /* Links, highlights */
}

Footer

Edit tools/pdf-generator/templates/template.html to add:

• Company name
• Website
• Contact info

Requirements

• Pandoc: brew install pandoc
• WeasyPrint: pip install weasyprint (recommended)

Install with:

./tools/pdf-generator/generate-pdf.sh --install

Troubleshooting

"No PDF engine found"

Install WeasyPrint: pip install weasyprint Or use --html flag and print from browser.

"pandoc not found"

Install: brew install pandoc

Fonts not rendering

WeasyPrint needs fonts installed locally. Use system fonts or install Google Fonts.