paw-tools-presentation

Presentation Maker

Overview

Transforms marketing strategies, plans, and reports into polished HTML presentations using McKinsey Pyramid Principle / SCR (Situation-Complication-Resolution) structure. Act as a presentation strategist who understands both visual communication and executive-level storytelling.

What it does: Ingests marketing content (from paw-mkt-* skills or raw input), structures it into SCR format, generates a professional HTML document with Chart.js visualizations and hero images.

How it works: Three-stage progressive flow — ingest → structure → generate. Each stage completes before the next begins.

Output: Standalone HTML file with embedded CSS, Chart.js, and a PDF download button at {project-root}/.pawbytes/tools-output/presentations/. Each presentation has unique visual character — design adapts to content type, audience, and brand signals rather than following a rigid template.

On Activation

Load available config from {project-root}/.pawbytes/config/config.yaml and {project-root}/.pawbytes/config/config.user.yaml. If config is present, extract:

• communication_language (default: English)
• document_output_language (default: English)

Read brand config from {project-root}/.pawbytes/tools-output/paw-mkt-setup/brand-config.json if available — use for colors, typography, and brand voice.

Default output path: {project-root}/.pawbytes/tools-output/presentations/ (or presentation_output_folder from config)

Headless Mode

When invoked with --headless or -H:

• Skip user review of outline
• Use sensible defaults for all choices
• Generate complete HTML output without interaction
• Read brand config if available, otherwise use professional defaults

Stages

Stage 1: Ingest Content

Load ./references/01-ingest.md

Input sources:

• Marketing content from paw-mkt-* skills (passed as --from-skill <skill-name>)
• File path to markdown/text document
• Raw text provided directly

Progression: Content ingested and understood → proceed to Structure

Stage 2: Structure Outline

Load ./references/02-outline.md

Outcome: McKinsey SCR/Pyramid outline presented for user review. User can edit, add, remove, or restructure sections.

Progression: User approves outline → proceed to Generate

Stage 3: Generate HTML

Load ./references/03-generate.md

Outcome: Complete HTML document with:

• Professional styling aligned with brand (if configured)
• Chart.js visualizations for data
• Hero/cover images (Pexels API or Gen AI)
• PDF download button via window.print()

External Skills Used

• paw-mkt-setup — Brand config source (optional integration)

Output

Location: {presentation_output_folder} or {project-root}/.pawbytes/tools-output/presentations/{slugified-title}.html

Filename convention: Slugified version of the presentation title.

Image Sources

Two options available:

1. Pexels API — Free stock photos. Requires pexels_api_key in config.
2. fal.ai — AI-generated images. Requires fal_api_key in config.

If no API keys configured, use professional placeholder or prompt user to provide images.

Charts

Chart.js is embedded directly in HTML output. Supported types:

• Bar charts (comparisons)
• Line charts (trends over time)
• Pie/doughnut charts (proportions, market share)
• Scatter plots (correlations)

See ./references/chart-patterns.md for implementation patterns.