GuruDevvv/my-claude-skills / external/ppt-creator
ppt-creator
VerifiedCreate professional slide decks from topics or documents. Generates structured content with data-driven charts, speaker notes, and complete PPTX files. Applies persuasive storytelling principles (Pyramid Principle, assertion-evidence). Supports multiple formats (Marp, PowerPoint). Use for presentations, pitches, slide decks, or keynotes.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.4 KB |
| SKILL.md | skill md | 11.2 KB |
| references/CHECKLIST.md | markdown | 12.1 KB |
| references/EXAMPLES.md | markdown | 19.2 KB |
| references/INTAKE.md | markdown | 7.2 KB |
| references/ORCHESTRATION_DATA_CHARTS.md | markdown | 4.3 KB |
| references/ORCHESTRATION_OVERVIEW.md | markdown | 8.2 KB |
| references/ORCHESTRATION_PPTX.md | markdown | 21.7 KB |
| references/RUBRIC.md | markdown | 16.2 KB |
| references/STYLE-GUIDE.md | markdown | 15.4 KB |
| references/TEMPLATES.md | markdown | 14.5 KB |
| references/VIS-GUIDE.md | markdown | 17.5 KB |
| references/WORKFLOW.md | markdown | 21.8 KB |
| scripts/chartkit.py | script | 4.0 KB |
| КАК_ИСПОЛЬЗОВАТЬ.md | markdown | 576 B |
references/CHECKLIST.md
View on GitHub# Pre-Flight Checklist
> **Purpose**: Final quality assurance before delivery. Use this checklist **before** running the full RUBRIC.md scoring. This ensures all required elements are present and obvious issues are caught early.
---
## How to Use This Checklist
1. **When**: Run this checklist after completing WORKFLOW Stage 7 (before final scoring)
2. **Method**: Go through each section; check ✓ or note issues
3. **Threshold**: All items in sections 1-5 must be ✓ before delivery; section 6-7 are optional enhancements
4. **Time**: ~5-10 minutes for a 12-15 slide deck
---
## Section 1: Content Completeness
### Slide Count & Structure
- [ ] **Total slide count** matches target range (typically 12-15 slides for 15-20 min presentation)
- [ ] **Cover slide** present with title, subtitle, date, presenter
- [ ] **Table of Contents** present and matches actual sections
- [ ] **Main content slides** (evidence/argument slides) present
- [ ] **Conclusion slide** present with clear call-to-action (CTA)
- [ ] **Backup slides** (if needed) clearly marked "Backup—not presented"
**If any unchecked**: Add missing slides or adjust scope.
---
### Intake & Assumptions
- [ ] **INTAKE.md questions** answered or defaulted (all 10 items)
- [ ] **Assumptions documented** in `/output/notes.md` (if defaults were used)
- [ ] **User's original request** recorded in archive.txt or notes
**If any unchecked**: Review INTAKE.md and document assumptions.
---
## Section 2: Story & Structure
### Pyramid Principle
- [ ] **Main conclusion** stated on cover slide (assertion sentence)
- [ ] **3-5 first-level reasons** identified and each has a section
- [ ] **Evidence slides** support each reason (2-3 slides per reason)
- [ ] **Logical flow**: Conclusion → Reasons → Evidence (not evidence → conclusion)
**If any unchecked**: Revise structure per WORKFLOW Stage 2.
---
### Slide Headings (Assertion-Evidence)
- [ ] **All slide headings are assertion sentences** (testable claims, not topic labels)
- ✅ Example: "Finer grind size extracts flavors faster"
- ❌ Counter-example: "Grind Size" or "Background"
- [ ] **Headings are complete sentences** (subject + verb + object)
- [ ] **Headings match the evidence** shown on the slide
**Quick Test**: Can you agree or disagree with each heading? (If no → it's a topic label, needs revision)
**If any unchecked**: Convert topic labels to assertion sentences (see TEMPLATES.md).
---
## Section 3: Evidence & Data
### Evidence for Claims
- [ ] **Every assertion slide** has supporting evidence (chart, table, example, case study, or diagram)
- [ ] **No unsupported claims** (all "X is true" statements backed by data/citations)
- [ ] **Placeholder charts** (if data unavailable) include:
- Chart type (e.g., "line chart", "bar chart")
- Axes and variables (e.g., "X: month, Y: revenue")
- Required data fields (e.g., "Need: month, revenue_usd")
**If any unchecked**: Add evidence or create detailed placeholders.
---
### Charts & Visualizations
- [ ] **Chart type matches message** (verified against VIS-GUIDE.md Chart Selection Dictionary)
- Trend over time → line/area chart
- Comparison → horizontal bar chart
- Composition → stacked bar / treemap
- Correlation → scatter plot
- [ ] **All charts have axis labels** (X-axis and Y-axis labeled with units)
- [ ] **All charts have data sources** cited in footer (e.g., "Source: XYZ, 2024")
- [ ] **All charts have alt text** for screen readers (brief description of insight)
- [ ] **Chart colors are colorblind-friendly** (avoid red+green; use blue+orange)
**If any unchecked**: Fix chart selection, labeling, or add missing elements.
---
## Section 4: Visual Design & Accessibility
### Typography
- [ ] **Heading font size** ≥ 34pt
- [ ] **Body font size** ≥ 18pt
- [ ] **Footer font size** ≥ 14pt (but not smaller)
- [ ] **Line spacing**: Headings 1.1×, body 1.3-1.5×
- [ ] **Fonts consistent** across all slides (same family for headings, same for body)
**If any unchecked**: Adjust font sizes per STYLE-GUIDE.md.
---
### Color & Contrast
- [ ] **Text contrast** ≥ 4.5:1 against background (normal text <18pt)
- [ ] **Large text contrast** ≥ 3:1 (headings ≥18pt or ≥14pt bold)
- [ ] **UI elements contrast** ≥ 3:1 (chart bars, icons, dividers)
- [ ] **Not relying on color alone** (patterns/labels added for charts with multiple series)
**How to check**: Use WebAIM Contrast Checker or browser DevTools.
**If any unchecked**: Adjust colors to meet WCAG AA standards (see STYLE-GUIDE.md).
---
### Layout & Spacing
- [ ] **Safe margins** ≥ 48px on all sides (content within safe zone)
- [ ] **Bullet points** limited to 3-5 per slide (not 8-10)
- [ ] **Word count** ≤ 70 words per slide (excluding chart labels and footer)
- [ ] **White space** ~40-50% of each slide (not crammed full)
- [ ] **Consistent alignment**: Headings and body text left-aligned (unless intentionally centered)
**If any unchecked**: Increase margins, reduce text, or split into multiple slides.
---
### Images & Alt Text
- [ ] **All images have alt text** (descriptive, 1-2 sentences)
- [ ] **All charts have alt text** (includes key insight, e.g., "Line chart showing 35% revenue growth Jan-Dec 2024")
- [ ] **Images not stretched or distorted** (maintain aspect ratio)
**If any unchecked**: Add alt text or fix image formatting.
---
## Section 5: Speaker Notes & Timing
### Speaker Notes Quality
- [ ] **Every slide has speaker notes** (except backup slides)
- [ ] **Notes are 45-60 seconds per slide** (read aloud to verify)
- [ ] **Notes use natural spoken language** (not bullet points or written prose)
- [ ] **Notes follow structure**: Opening → Core Assertion → Evidence Explanation → Transition
- [ ] **Notes include transitions** to next slide (e.g., "This leads us to...")
**If any unchecked**: Revise notes per WORKFLOW Stage 6.
---
### Total Timing
- [ ] **Total presentation time** matches target (e.g., 15 min = ~15 slides × 60 sec)
- [ ] **Timing buffer** included (5-10% slack for questions/pauses)
**Quick Calc**: Count slides (excluding cover, TOC, backup) × 60 sec = estimated time.
**If any unchecked**: Adjust slide count or speaker notes length.
---
## Section 6: Deliverables (Output Files)
### Required Files
- [ ] `/output/slides.md` exists and is properly formatted (Markdown with YAML frontmatter)
- [ ] `/output/notes.md` exists with full speaker script
- [ ] `/output/refs.md` exists with all citations and sources
- [ ] `/output/assets/` directory exists (even if empty)
- [ ] `/output/README.md` exists explaining file structure
**If any unchecked**: Generate missing files per WORKFLOW Stage 8.
---
### Optional Files (If Applicable)
- [ ] `/output/assets/*.png` charts generated (if data was provided and chartkit.py was used)
- [ ] `/output/presentation.pptx` exported (if python-pptx is available)
- If not available: Instructions for PPTX conversion included in notes.md
**If any unchecked**: Generate charts or add conversion instructions.
---
## Section 7: Polish & Enhancements (Optional but Recommended)
### Consistency Checks
- [ ] **Number formatting consistent**: Same decimal places for same metric (e.g., all percentages to 1 decimal)
- [ ] **Units consistent**: All currency in $ or all in €; don't mix
- [ ] **Date format consistent**: All "Jan 2024" or all "2024-01" (pick one)
- [ ] **Capitalization consistent**: Heading case for all slide titles
---
### Branding (If Applicable)
- [ ] **Brand colors applied** (if provided in INTAKE question 9)
- [ ] **Logo added** to cover slide and/or footer (if applicable)
- [ ] **Brand fonts used** (if specified)
**If unchecked and brand was specified**: Apply per STYLE-GUIDE customization section.
---
### Reuse Guide
- [ ] **"5-Step Reuse Guide" appended** to notes.md (helps user customize later)
- [ ] **chartkit.py usage examples** included (if charts were generated)
- [ ] **Markdown-to-PPTX conversion instructions** included (if PPTX not auto-generated)
**If any unchecked**: Add per WORKFLOW Stage 9.
---
## Section 8: Final Sanity Checks
### Links & References
- [ ] **All internal links work** (e.g., references to "See backup slide 14")
- [ ] **All chart/image paths correct** (no broken image links in slides.md)
- [ ] **All citations complete** (author, year, source name)
---
### Spelling & Grammar
- [ ] **Spell-check run** on all text (slides + notes)
- [ ] **Grammar checked** (especially speaker notes, which are full sentences)
- [ ] **Consistent terminology** (e.g., don't switch between "users" and "customers")
**Tool suggestions**: Grammarly, LanguageTool, or built-in spell-checker.
---
### Edge Cases
- [ ] **Long words or URLs** broken or shortened (avoid overflow)
- [ ] **Special characters** (©, ®, ™, °, etc.) display correctly
- [ ] **Non-English text** (if any) uses correct fonts and displays properly
---
## Checklist Summary
**Count your checks**:
- **Section 1 (Content)**: ___ / 9 items ✓
- **Section 2 (Structure)**: ___ / 8 items ✓
- **Section 3 (Evidence)**: ___ / 9 items ✓
- **Section 4 (Design)**: ___ / 18 items ✓
- **Section 5 (Notes)**: ___ / 7 items ✓
- **Section 6 (Deliverables)**: ___ / 7 items ✓
- **Section 7 (Polish)**: ___ / 7 items ✓ (optional)
- **Section 8 (Sanity)**: ___ / 6 items ✓
**TOTAL**: ___ / 64 core items (sections 1-6)
**PASSING CRITERIA**:
- **Sections 1-6**: All items ✓ (64/64 required)
- **Section 7-8**: Nice-to-have but not required for delivery
---
## What to Do If Items Are Unchecked
### Minor Issues (1-5 unchecked in sections 1-6)
**Action**: Fix the specific items now before moving to RUBRIC scoring.
**Example**:
- Missing alt text on 2 charts → Add alt text
- One topic-label heading → Convert to assertion sentence
- Font size 16pt on one slide → Increase to 18pt
---
### Moderate Issues (6-15 unchecked in sections 1-6)
**Action**: Prioritize the most impactful fixes first:
1. **Structure issues** (Section 2): Fix pyramid structure, convert headings
2. **Evidence gaps** (Section 3): Add missing charts or citations
3. **Accessibility** (Section 4): Fix contrast, font sizes
4. **Speaker notes** (Section 5): Revise timing or add transitions
**Estimated Time**: 15-30 minutes of fixes before re-running checklist.
---
### Major Issues (16+ unchecked in sections 1-6)
**Action**: Return to WORKFLOW Stage 3-4 and rebuild:
- If structure is broken (Section 2): Restart from Stage 3 (Outline)
- If evidence is weak (Section 3): Restart from Stage 4 (Evidence & Charts)
- If design is poor (Section 4): Apply STYLE-GUIDE systematically
**Estimated Time**: 1-2 hours of rework.
---
## After Checklist: Next Steps
Once all core items (Sections 1-6) are ✓:
1. **Proceed to RUBRIC.md** for detailed scoring (0-10 per item, total 100)
2. **If RUBRIC score ≥ 75**: Package deliverables and deliver
3. **If RUBRIC score < 75**: Apply top 3 improvements and re-score (max 2 iterations)
---
## Quick Reference: Most Common Issues
Based on typical PPT creation, here are the **top 10 most common checklist failures**:
1. ❌ **Slide headings are topic labels** (not assertion sentences) → Fix: Convert to testable claims
2. ❌ **Missing source citations on charts** → Fix: Add "Source: XYZ, 2024" in footer
3. ❌ **Font sizes too small** (body <18pt) → Fix: Increase to 18-22pt
4. ❌ **No alt text on charts** → Fix: Add brief description with key insight
5. ❌ **Poor contrast** (<4.5:1) → Fix: Darken text or lighten background
6. ❌ **Too many bullets** (>5 per slide) → Fix: Split into 2 slides or reduce
7. ❌ **No speaker notes** on some slides → Fix: Write 45-60 sec script per slide
8. ❌ **Assumptions not documented** (if defaults used) → Fix: Add to notes.md
9. ❌ **Chart type mismatch** (e.g., pie chart for 7 categories) → Fix: Use bar chart instead
10. ❌ **Inconsistent number formatting** (mixing "1.2M" and "850,000") → Fix: Use same abbreviation style
---
## Checklist Completion Log
**Presentation**: [Title]
**Date**: [YYYY-MM-DD]
**Checked by**: Claude
**Status**: [PASS / FAIL]
**Issues Found**: [Number]
**Issues Fixed**: [Number]
**Remaining**: [Number]
**Notes**:
- [List any issues not yet fixed]
- [Next steps or blockers]
---
**Next Steps**: After all checklist items are ✓, proceed to RUBRIC.md for full scoring.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |