speaker-notes-polisher

Extract headings, bullets, and paragraphs from MDX frontmatter into three-section speaker notes.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/co-r-e/dexcode --skill speaker-notes-polisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speaker-notes-polisher
Source: https://github.com/co-r-e/dexcode/tree/main/.claude/skills/speaker-notes-polisher
Command: npx skills add https://github.com/co-r-e/dexcode --skill speaker-notes-polisher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gray-matter, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Refine and standardize speaker notes embedded in MDX frontmatter by extracting key signals from headings, bullets, and paragraphs and organizing them into a consistent three-section format: Purpose, Talking Points, and Estimated Time.

Core Features & Use Cases

  • Extract slide signals (headings, bullet lists, paragraphs) to generate a structured notes block with clear Purpose, Talking Points, and Estimated Time.
  • Support two modes: fill missing sections or rewrite the entire notes; supports both dry-run and write modes.
  • Provide a script (polish-notes.ts) that operates on decks under decks/, reports diffs, and can apply changes to MDX frontmatter.

Quick Start

Run the polish-notes.ts script against a target deck to generate and/or rewrite speaker notes in the MDX frontmatter.

Frequently Asked Questions about speaker-notes-polisher

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

FAQPage Schema
How do I generate structured speaker notes from MDX frontmatter?

Generate structured speaker notes from MDX frontmatter by running a script that extracts headings, bullets, and paragraphs, organizing them into Purpose, Talking Points, and Estimated Time sections. It applies changes via a dry-run before committing.

What is the best way to standardize speaker notes across MDX presentation decks?

Standardize MDX speaker notes by extracting key slide signals and organizing them into a consistent three-section format. The script operates on decks under the decks/ directory and can either fill missing sections or rewrite existing notes.

Does this speaker notes polisher require Node.js and gray-matter to parse frontmatter?

Yes, refining MDX speaker notes requires Node.js 20+ and the gray-matter dependency to parse frontmatter. The script processes MDX slides and reports diffs before writing changes to the deck files.

Can I preview changes to MDX speaker notes before committing them?

Yes, you can preview MDX speaker notes changes using the dry-run mode. The script reports diffs against the target deck, allowing you to review the generated Purpose, Talking Points, and Estimated Time sections before writing.

How do I handle missing speaker notes sections in MDX slides?

Handle missing MDX speaker notes sections by running the script in fill mode. It extracts signals from slide content to generate the missing Purpose, Talking Points, and Estimated Time blocks directly within the frontmatter.