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:
- Pexels API — Free stock photos. Requires
pexels_api_keyin config. - fal.ai — AI-generated images. Requires
fal_api_keyin 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.