Professional PDF Generator

Generate branded PDF documents using your company's visual identity.

Token Budget: ~3,000 tokens per generation

Reference: See reference.md for CSS/HTML templates.

Bespoke Configuration

On first use (or via /configure-pdf), CIPS prompts for brand settings.

Brand Configuration Wizard

Q1: "What's your company name?"
    → Free text input

Q2: "What's your brand colour scheme?"
    Options:
    - "Minimal (grayscale)" → #EAEAEA, #333333
    - "Professional blue" → #0066CC, #333333
    - "Warm orange" → #ea580c, #1a1a1a (Recommended)
    - "Custom colours" → Prompts for hex codes

Q3: "What typography style?"
    Options:
    - "Swiss Minimalism (system fonts)" (Recommended)
    - "Corporate (Arial + Times)"
    - "Modern (Inter + Georgia)"

Q4: "Include logo in header?"
    Options:
    - "Yes" → Prompts for logo path
    - "No"

Q5: "Footer text?"
    → Free text (e.g., "Confidential - {COMPANY_NAME}")

Configuration Storage

Saves to: ~/.claude/config/pdf-branding.json

{
  "company_name": "Your Company",
  "colours": {
    "accent": "#ea580c",
    "text": "#1a1a1a",
    "background": "#EAEAEA",
    "border": "#d1d5db"
  },
  "typography": "swiss",
  "logo_path": null,
  "footer": "Confidential - Your Company"
}

Design System

Colour Palette (Defaults)

Typography

Page Layout

• Size: A4 (210mm x 297mm)
• Margins: 2cm top/bottom, 2.5cm left/right
• Header: Document title (uppercase monospace)
• Footer: Page number + company name

Generation Workflow

Step 1: Check Configuration

config_path = "~/.claude/config/pdf-branding.json"
if not exists(config_path):
    run_brand_wizard()  # AskUserQuestion flow

Step 2: Generate HTML

1. Load CSS template from reference.md
2. Replace placeholders with config values
3. Insert content using structure template
4. Save as .html file

Step 3: Generate PDF

weasyprint document.html document.pdf

Alternative:

pandoc document.html -o document.pdf --pdf-engine=weasyprint

Dependencies (One-time)

brew install pandoc
pip3 install weasyprint

Document Types

Technical Reference

Structure:

• Overview with benefits table
• Component inventory
• Usage patterns with code
• Best practices
• Quick reference table

Blog Article

Structure:

• Problem statement
• Solution with steps
• Results table
• Key takeaways

Slash Commands

/generate-pdf "Title"              # Generate with current config
/generate-pdf "Title" --output ~/  # Specify output directory
/configure-pdf                     # Re-run brand wizard

Implementation (AskUserQuestion)

When config missing, use this flow:

// Q1: Company name
AskUserQuestion({
  questions: [{
    question: "What's your company name for PDF branding?",
    header: "Company",
    options: [
      { label: "Personal/Individual", description: "No company branding" },
      { label: "Enter company name", description: "Provide custom name" }
    ],
    multiSelect: false
  }]
});

// Q2: Colour scheme
AskUserQuestion({
  questions: [{
    question: "What colour scheme for your documents?",
    header: "Colours",
    options: [
      { label: "Warm orange", description: "#ea580c accent - Swiss Minimalism (Recommended)" },
      { label: "Professional blue", description: "#0066CC accent - Corporate feel" },
      { label: "Minimal grayscale", description: "#666666 accent - Clean and neutral" },
      { label: "Custom colours", description: "Provide your own hex codes" }
    ],
    multiSelect: false
  }]
});

// Q3: Typography
AskUserQuestion({
  questions: [{
    question: "What typography style?",
    header: "Fonts",
    options: [
      { label: "Swiss Minimalism", description: "System fonts, clean and modern (Recommended)" },
      { label: "Corporate", description: "Arial headings, Times body" },
      { label: "Modern", description: "Inter headings, Georgia body" }
    ],
    multiSelect: false
  }]
});

Token Budget

Migration from Legacy PDF Skill

If migrating from the old skill:

1. Your existing documents remain unchanged
2. Run /configure-pdf to set up your branding
3. New documents use your config

Skill Status: Active Version: 1.0.0 Bespoke: Yes (configurable branding)