All skills
dmccreary avatar

/textbook-to-presentation-generator

@d133ef8

Generates a lecture PowerPoint from an intelligent textbook using pptxgenjs — visual design, 4-act storytelling structure, and speaker notes. Use when converting a textbook into slides for classroom delivery.

Use this Skill: https://skilld.dev/gh/dmccreary/claude-skills/textbook-to-presentation-generator

This session only. Nothing lands on disk.

referencesspeaker-notes-guide.md

≈905 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Speaker Notes Guide

How to write speaker notes that turn a slide deck into a live performance.

The Principle

The slides are the visual aid. The speaker is the story. The notes script the performance — not as a teleprompter to read from, but as a guide for what to say, when to pause, and when to reveal the framework behind what the audience just experienced.

Note Structure

Every slide's notes follow this template:

TIMING: XX:XX

SAY: 'The narrative the speaker delivers. Written in conversational 
tone — how you'd actually say it, not how you'd write it. 2-4 
sentences maximum.'

[Optional] META-MOMENT: 'Notice what I just did? That was [framework 
name]. I [specific thing you did] before telling you the name, 
because [reason].'

TRANSITION: 'The bridge sentence that connects this slide to the 
next one.'

[Optional] AUDIENCE PULSE: Pause 3 seconds. / Ask: "How many of 
you have experienced this?" / Wait for hands.

Meta-Moments

Meta-moments are the most powerful teaching tool in the deck. They work like this:

  1. You demonstrate a principle through your delivery (use a story, use brevity, use structure)
  2. Later, you reveal what you did: "Notice that the story I told you followed four stages — Setting, Dilemma, Action, Outcome. That's Klein's model. You experienced it before I named it."

The audience learns through experience, then gets the vocabulary. This is more memorable than definitions → examples.

Guidelines for meta-moments:

  • Use 3-5 per presentation (more dilutes the effect)
  • Space them throughout — not all in one section
  • The reveal should feel like an "aha" — not a gotcha
  • Connect back to the specific moment: "Remember when I said X? That was Y."

Timing Cues

Use cumulative timing, not per-slide timing:

  • TIMING: 0:00 (start)
  • TIMING: 3:00 (after opening story)
  • TIMING: 10:00 (end of Act I)
  • etc.

This helps the speaker pace themselves against the clock. If they're at slide 15 and the clock says 30:00, they know they're on track for a 50-minute talk.

Audience Pulse Points

Types of audience interaction:

  1. Raise of hands: "How many of you have experienced this?" — low-risk, gets people physically engaged
  2. Turn-and-talk: "Turn to your neighbor and explain X in 30 seconds" — high engagement, requires timer
  3. Live challenge: "You have 60 seconds. Do X." — highest engagement, creates shared experience
  4. Rhetorical pause: State something surprising. Pause 3 full seconds. Let it land.
  5. Check-in question: "Before I move on — is the distinction between X and Y clear?"

Place 2-3 interaction beats per 50-minute lecture. More breaks the flow. Fewer makes it a monologue.

Transition Phrases

Good transitions connect the last idea to the next one:

  • "So that's clarity. But clarity without structure is still chaos."
  • "You know what to say. Now let's talk about what to cut."
  • "That's the theory. Let me show you what it looks like in practice."
  • "One more concept, and then we'll close with your action plan."

Bad transitions are non-sequiturs:

  • "Next slide."
  • "Moving on..."
  • "OK so now let's talk about..."

Do's and Don'ts

Do:

  • Write notes in conversational voice (contractions, short sentences)
  • Include the exact story to tell, not a summary of it
  • Note where to pause and for how long
  • Script the meta-moments word for word

Don't:

  • Write notes as bullet points to read from the slide
  • Include everything the slide already shows (the audience can read)
  • Script every word — leave room for natural delivery
  • Forget the timing cues

Source: SKILL.md on GitHub

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill generates PowerPoint presentations by creating and executing a local Node.js script based on textbook content. It follows a workflow of reading local files, generating code, and executing shell commands. The primary security considerations involve the dynamic execution of generated code and the potential for malicious content in the source textbook files to influence the output.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at d133ef8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 19 hours ago.

Activeupdated 3 months ago

README badge

README badge for dmccreary/claude-skills/textbook-to-presentation-generator