All skills
dmccreary avatar

/book-media-generator

@8fafb8d

Generates media for intelligent textbooks - slide decks and presentations (MARP web decks in docs/slides/ or PowerPoint .pptx lecture downloads), illustrated stories and graphic novels, freely-licensed chapter images from Wikimedia and government archives, and audio (text-to-speech voiceovers, glossary pronounce buttons via ElevenLabs). Routes to the appropriate media guide.

Use this Skill: https://skilld.dev/gh/dmccreary/claude-skills/book-media-generator

This session only. Nothing lands on disk.

referencespptx-speaker-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 alerts14d3 checks · Risk SAFE
  • Gen Agent Trust Hub14d

    This skill provides a robust framework for generating educational media. It integrates with well-known services like Google Gemini, ElevenLabs, and Wikimedia. All security-sensitive operations, such as API calls and package installations, follow best practices, and the usage of system commands is limited to benign media validation tasks.

  • Socket14d

    No alerts

  • Snyk14d

    Risk: LOW · No issues

Signed by skilld at 8fafb8d. 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 last month
metadata
{
  "ibook.version": "1.0",
  "ibook.preferred-model": "sonnet"
}

README badge

README badge for dmccreary/claude-skills/book-media-generator