presentation-master

What this skill does

# Presentation Master

World-class presentation creation skill that embodies best practices from presentation masters and adapts to your needs.

## Philosophy

**Key Innovation**: This isn't just a presentation generator—it's a presentation *coach* that teaches world-class design while creating slides.

Principles from:
- **Garr Reynolds** (Presentation Zen) - Simplicity and visual storytelling
- **Nancy Duarte** (Resonate) - Story structure and audience as hero
- **Guy Kawasaki** - 10/20/30 rule (10 slides, 20 minutes, 30pt fonts)
- **Seth Godin** - 6 words maximum per slide
- **TED** - Visual-first, minimal text, high impact
- **Edward Tufte** - Data integrity and information design
- **Steve Jobs** - Rule of Three and surprise moments

## Workflow: Guided Creation with Checkpoints

### Phase 1: Discovery & Context Analysis

**User provides**: Topic + Audience + Duration

**Skill analyzes**:
- Presentation type (board update, keynote, training, TED-style)
- Audience level (technical, executive, general public)
- Key message and desired transformation
- Story framework recommendation

**Checkpoint 1**: Present 3 structure options with rationale → user approves

### Phase 2: Content Development

**Skill develops**:
- Research topic if needed (web search, Obsidian knowledge)
- Extract maximum 10 core concepts (Kawasaki rule)
- Apply "what is / what could be" alternation (Duarte)
- Draft slide outline with one concept per slide
- Identify slides needing visuals

**Checkpoint 2**: Present outline + visual plan → user approves

### Phase 3: Visual Strategy

**Skill proposes** for each visual slide:
- Image type (infographic, photo, diagram, data visualization)
- Visual concept/metaphor
- Aesthetic direction (colors from brand, style, mood)
- Estimated generation cost ($0.13-$0.24 per image)

**Checkpoint 3**: Present visual strategy → user approves images to generate

### Phase 4: Generation & Validation

**Skill executes**:
1. Generate approved images in parallel using image-gen skill
2. Build slides using selected adapter (PPTX/Google Slides/Canva)
3. Apply design rules automatically:
   - 30pt+ fonts minimum
   - <6 words per slide (Godin standard)
   - High contrast (4.5:1 minimum)
   - No bullet points
   - No paragraphs
4. Run validation scoring (0-100 scale)
5. Generate quality report

**Checkpoint 4**: Present presentation + quality report → user reviews

### Phase 5: Iteration & Refinement (if needed)

**Skill refines**:
- Apply requested changes
- Re-validate quality score
- Save final presentation to Obsidian Research folder
- Document learnings and metadata

## Validation Scoring (0-100)

### CRITICAL Violations (Auto-fail)
- Font size < 30pt
- >10 core concepts
- Bullet points detected
- Paragraphs (>2 consecutive sentences)
- Poor contrast ratio (<4.5:1)
- Default template usage

### WARNING Flags
- >6 words per slide
- >15 slides for 20-min presentation
- No images in presentation
- Text-heavy slides (>3 lines)
- Inconsistent fonts (>2 families)
- Low-resolution images

### Quality Score Breakdown
- **Simplicity** (10pts): Word count, visual clutter
- **Visual Dominance** (10pts): Image quality, text-to-visual ratio
- **Story Structure** (10pts): Narrative arc, emotional beats
- **One Idea/Slide** (10pts): Concept clarity
- **Typography** (8pts): Size, consistency
- **Layout** (7pts): Hierarchy, whitespace, alignment
- **Color/Contrast** (7pts): Readability, brand consistency
- **Media Quality** (8pts): Image resolution, relevance
- **Cognitive Load** (20pts): Mayer's 12 multimedia principles
- **Data Integrity** (10pts): Tufte principles (if data present)

**Target Score**: 85+ for high-quality presentations

## Slide Pattern Library

### Six Core Patterns

1. **Title Slide** - Minimal text, strong visual, sets tone
2. **One Big Idea** - Single word/number/image, max 6 words
3. **Visual + Caption** - Large high-quality image, short caption
4. **Data Visualization** - Charts following Tufte principles (maximize data-ink ratio)
5. **Timeline/Process** - Linear flow, minimal text per step
6. **Transition/Section Break** - Single word or phrase, signals shift

### Adaptive Pattern Selection

**Board/Executive Update**: Patterns 3, 4, 6 (data-focused, professional)
**Keynote/TED-style**: Patterns 1, 2, 3 (story-focused, visual-first)
**Training/Education**: Patterns 4, 5 (process-focused, clarity)
**Pitch/Demo**: Patterns 2, 3, 4 (impact-focused, evidence-based)

## Story Frameworks

### Nancy Duarte's Sparkline
- Alternate "what is" (current reality) with "what could be" (aspiration)
- Build tension through contrast between present and future
- End with transformation and new reality

### The Rule of Three (Steve Jobs)
- Break presentation into 3 main sections
- 3 key features/points per section
- Memorable and dramatic

### TED Structure
- Hook (first 30 seconds) - Grab attention
- Personal connection - Why this matters to you
- Core idea with evidence - The meat
- Call to action - What next
- Strong close - Never end with Q&A

## Output Format Support

### Current: PPTX (Phase 1)
- Uses existing pptx skill
- Direct PptxGenJS API for simple slides
- html2pptx.js for complex layouts
- Saves to Obsidian Research folder
- Generates quality validation report

### Coming: Google Slides (Phase 2)
- Google Slides API v1
- Integrates with google-workspace skill
- Supports all 3 accounts (psd, kh, hrg)
- Returns shareable link

### Future: Canva (Phase 3)
- Canva REST API
- Auto-apply brand kits
- Returns shareable link

## Image Generation Integration

### Intelligent Visual Recommendations

For each slide, analyzes:
- **Numeric data** → Infographic recommendation
- **Abstract concepts** → Conceptual image/metaphor (especially for keynotes)
- **Concrete examples** → Photo/realistic imagery
- **Processes/flows** → Diagram recommendation
- **Trends/comparisons** → Chart/data visualization

### Prompt Generation (6-Step Process)

From image-gen skill:
1. Extract narrative from slide content
2. Choose visual concept/metaphor
3. Apply aesthetic (brand colors, presentation style)
4. Construct detailed prompt
5. Execute generation
6. Validate output

### Cost Management
- Show total estimated cost before generating
- Allow opt-out of specific images
- Cache generated images for reuse
- Track spending in presentation metadata

### Naming Convention
```
{presentation-id}-slide-{number}-{type}.png

Examples:
cybersecurity-2025-slide-02-threat-timeline.png
port-ai-2025-slide-04-breakthroughs.png
```

## Brand Integration

Automatically detects and applies branding:
- **PSD presentations**: Use psd-brand-guidelines skill (Sea Glass, Pacific, etc.)
- **Personal presentations**: Use personal brand (if defined)
- **Client presentations**: Custom brand kit (future)

Applies to:
- Color palettes
- Typography choices
- Logo placement
- Overall aesthetic

## Learning & Metadata Tracking

After each presentation, save metadata to Obsidian:

```json
{
  "presentation_id": "cybersecurity-2025-board",
  "type": "board-update",
  "audience": "school-board",
  "duration": "15min",
  "slides": 10,
  "quality_score": 91,
  "images_generated": 7,
  "generation_cost": 0.94,
  "validation_warnings": 1,
  "user_edits": ["slide-8-wording"],
  "effectiveness": "approved-minor-changes",
  "created": "2025-11-24",
  "tools_used": ["research", "image-gen", "pptx"],
  "learnings": "Board prefers data charts over concept graphics"
}
```

## Integration with Existing Skills

**Dependencies**:
- `image-gen` - Visual content generation
- `pptx` - PowerPoint creation (Phase 1)
- `google-workspace` - Google Slides (Phase 2)
- `psd-brand-guidelines` - Brand colors/logos
- `research` - Content development
- `obsidian-manager` - Knowledge storage

**Coordination Pattern**:
```
presentation-master (orchestrator)
├── calls research for content depth
├── calls image-gen for visuals
├── calls pptx/slides/canva adapter for output
├── calls psd-brand-guidelines for colors/logos
└── calls obsidian-