ppt-speech-writer

Generate evidence-grounded speaker notes for PowerPoint decks and inject them into the notes pane.

457|17|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/AI272/speaker --skill ppt-speech-writer-ai272
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ppt-speech-writer
Source: https://github.com/AI272/speaker/tree/main/ppt-speech-writer
Command: npx skills add https://github.com/AI272/speaker --skill ppt-speech-writer-ai272

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx, Pillow, python-docx, tesseract, and includes scripts (resource) components.

What problem does it solve? Writing speaker notes from a .pptx usually relies only on text boxes, missing charts, tables, SmartArt, screenshots, and text embedded in images, which leads to inaccurate or invented narration. This Skill reads the real deck through structured extraction, slide rendering, region-scoped OCR, and vision review, then writes notes grounded in every visible element and injects the clean script back into PowerPoint. ## Core Features & Use Cases - Multi-source slide evidence: Combines python-pptx extraction, raw OOXML text, rendered slide PNGs, and image-region OCR into a per-slide visible-element inventory. - Pause-aware pacing model: Budgets words or Chinese characters per slide using realistic speaking rates (110 wpm English, 165 chars/min Chinese) with reserved time for transitions and pauses. - Complete deliverables: Produces a .pptx with clean notes injected, a full rehearsal document (.docx or .md), and an optional vision-review packet. - Use Case: A researcher has a 15-minute conference talk deck with dense result charts. The Skill inspects every chart axis and value, drafts a ~1,300-word script within budget, and delivers a ready-to-present PowerPoint with notes. ## Quick Start Use the ppt-speech-writer skill to write speaker notes for my deck 'thesis-defense.pptx' for a 15-minute English talk and inject them into the PowerPoint notes pane.

Frequently Asked Questions about ppt-speech-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate speaker notes for a PowerPoint presentation?

Provide the .pptx file, target duration, and output language. The skill extracts structured content, renders each slide, runs OCR on image regions, reviews visuals, then writes per-slide notes and injects a clean version into the PowerPoint notes pane.

How do I add notes to a PowerPoint notes pane with Python?

The inject_notes.py script uses python-pptx to write notes into each slide's notes_text_frame. It supports replace, append, and skip-if-present modes, reading slide-numbered notes from a JSON file and warning about out-of-range entries.

Can speaker notes handle charts, SmartArt, and screenshots in slides?

Yes. The skill extracts chart titles, axes, series, and values from OOXML, pulls SmartArt text from raw XML, and OCRs picture regions on rendered slides. Visually complex slides require a vision-capable review before notes are written.

Does it support Chinese speaker notes?

Yes. The output language is explicitly confirmed before drafting, and Chinese notes are budgeted at 165 characters per minute rather than word count. Technical terms like AUROC can stay in English while grammar follows Chinese.

What happens if LibreOffice or tesseract is not installed?

Rendering falls back from LibreOffice to macOS qlmanage, and missing tesseract skips OCR in favor of XML and vision review. Missing Pillow downgrades region OCR to full-slide OCR, and missing python-docx produces a Markdown rehearsal document instead.

Why do generated talks overrun their time limit?

Raw word counts ignore pauses and transitions. This skill reserves time for slide transitions, [PAUSE] markers, and a 10-15% buffer, so a 15-minute English talk targets roughly 1,300-1,400 words instead of 1,800.