Initial commit

skills/presentation-master/SKILL.md

@@ -0,0 +1,449 @@
+---
+name: presentation-master
+description: World-class presentation creation embodying principles from Garr Reynolds, Nancy Duarte, Guy Kawasaki, Seth Godin, and TED
+triggers:
+  - "create presentation"
+  - "make presentation"
+  - "build presentation"
+  - "design deck"
+  - "make slides"
+  - "create slides"
+  - "build deck"
+  - "presentation for"
+  - "slides for"
+allowed-tools: Read, Write, Bash, WebSearch, Skill, AskUserQuestion
+version: 1.0.0
+---
+
+# 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-manager to save final + metadata
+```
+
+## Usage Examples
+
+### Example 1: Board Update
+```
+User: "Create presentation on cybersecurity trends for school board, 15 minutes"
+
+Geoffrey: I'll create a board update presentation on cybersecurity trends.
+
+**Context Analysis**
+- Type: Board/Executive Update
+- Audience: School board (non-technical)
+- Duration: 15 minutes
+- Purpose: Inform + Recommend action
+
+**Recommended Structures**
+1. Problem → Solution → Action (8 slides)
+2. Current State → Trends → Implications → Recommendations (10 slides) ⭐
+3. Story: Recent incident → Broader context → Our response (7 slides)
+
+Which structure resonates?
+
+[User selects #2]
+
+**Draft Outline** (10 slides, one concept each)
+1. Title: Cybersecurity Trends 2025
+2. Current Threat Landscape [visual: threat timeline]
+3. Trend 1: AI-Powered Attacks [visual: concept illustration]
+4. Trend 2: Ransomware Evolution [visual: data chart]
+5. Trend 3: Supply Chain Risks [visual: network diagram]
+6. Impact on Education Sector [visual: stat infographic]
+7. Our Current Posture [visual: assessment chart]
+8. Gaps & Vulnerabilities [text-focused, high contrast]
+9. Recommended Actions [visual: roadmap]
+10. Investment & Timeline [visual: budget chart]
+
+**Visual Strategy**
+- 7 images recommended
+- Estimated cost: $0.94 (2K resolution)
+- Mix: 3 infographics, 2 charts, 1 diagram, 1 illustration
+
+Approve and proceed?
+
+[User approves]
+
+Generating 7 visuals in parallel...
+✓ All generated (0.94 total)
+
+Building presentation with PSD brand colors...
+Validating against best practices...
+
+**Quality Score: 91/100**
+✓ All fonts 36pt+
+✓ Avg 4.2 words/slide
+✓ High contrast (8.5:1)
+✓ Story arc present
+✓ Cognitive load optimized
+⚠ Slide 8 has 7 words (rec: 6 max)
+
+Created: /Obsidian/Research/cybersecurity-trends-2025-board.pptx
+```
+
+### Example 2: Keynote
+```
+User: "Create keynote on future of education for conference, 30 minutes"
+
+Geoffrey: I'll create a TED-style keynote on the future of education.
+
+**Context Analysis**
+- Type: Keynote/TED-style
+- Audience: Education professionals + parents
+- Duration: 30 minutes
+- Purpose: Inspire + Shift perspective
+
+**Recommended Structures** (Nancy Duarte's Sparkline)
+1. What education is today → What it could be → Transformation (12 slides) ⭐
+2. Steve Jobs Rule of Three: Past → Present → Future (9 slides)
+3. Hero's Journey: Problem → Trials → New reality (10 slides)
+
+Which framework?
+
+[Continues with guided creation...]
+```
+
+## Quality Checklist
+
+Before presenting to user, verify:
+
+**Content**
+- [ ] One main idea per slide
+- [ ] Clear story arc (beginning/middle/end)
+- [ ] Audience positioned as hero
+- [ ] Emotional connection established
+- [ ] Maximum 10 core concepts
+
+**Design**
+- [ ] All fonts 30pt+ minimum
+- [ ] High contrast (4.5:1+)
+- [ ] No bullet points
+- [ ] No paragraphs
+- [ ] Maximum 6 words per slide (or justified exception)
+- [ ] All images high-resolution
+- [ ] Consistent fonts/colors/alignment
+- [ ] No transitions or animations
+
+**Data Visualization** (if applicable)
+- [ ] Lie factor 0.95-1.05
+- [ ] Maximum data-ink ratio
+- [ ] Clear, detailed labeling
+- [ ] No chart junk (3D effects, unnecessary borders)
+
+**Structure**
+- [ ] Follows chosen framework (Duarte/Jobs/TED)
+- [ ] Creates tension and resolution
+- [ ] Includes surprise/memorable moments
+- [ ] Ends strong (not with Q&A)
+- [ ] Appropriate length for time
+
+## Advanced Features
+
+### Context Detection
+
+Automatically infers presentation type from cues:
+- "board meeting" → Board update (data-focused)
+- "keynote" or "conference" → Keynote (story-focused)
+- "training" or "workshop" → Educational (process-focused)
+- "pitch" or "investor" → Pitch (evidence-focused)
+
+### Smart Defaults
+
+Based on detected type:
+- **Board update**: 10 slides, 8 with visuals, professional tone
+- **Keynote**: 12-15 slides, minimal text, emotional arc
+- **Training**: 15-20 slides, process diagrams, step-by-step
+- **Pitch**: 10 slides (Kawasaki rule), data-driven, ROI focus
+
+### Accessibility
+
+Ensures presentations are accessible:
+- High contrast text (4.5:1 minimum, aim for 7:1)
+- Large fonts (30pt minimum, 36pt+ preferred)
+- Clear hierarchy and flow
+- Alt text for images (future enhancement)
+
+## Limitations & Future Enhancements
+
+**Current Limitations**:
+- No animation support (by design - Godin principle)
+- No video embedding yet (future enhancement)
+- No speaker notes generation (Phase 2)
+- No slide master editing (uses templates)
+
+**Future Enhancements**:
+- Auto-generate speaker notes from slide content
+- Suggest rehearsal timing
+- A/B test different structures
+- Track presentation effectiveness scores
+- Build personal pattern library from successful presentations
+
+## References
+
+Full principles documentation in:
+- `principles/masters.md` - Expert best practices
+- `principles/validation-rules.md` - Quality scoring system
+- `principles/slide-patterns.md` - Template library
+- `principles/story-frameworks.md` - Narrative structures
+
+Scripts and adapters:
+- `scripts/analyze-context.js` - Type detection
+- `adapters/pptx-adapter.js` - PowerPoint output
+- `adapters/slides-adapter.js` - Google Slides (Phase 2)
+- `adapters/canva-adapter.js` - Canva (Phase 3)
+
+---
+
+**Remember**: The best presentations are simple, visual, story-driven, and focused on the audience's transformation—not the speaker's information.