skills.rest
raghavamohan
raghavamohanCOMMUNITY
Explore all skills by this author →
GitHub

update-presenters-companion

Rebuild Presenter's Companion DOCX, PDF, and PowerPoint speaker notes from companion markdown.

Updated Jun 12, 2026
Search Tags:#markdown#powerpoint#presentation#pdf generation#docx#speaker notes#study companion
One-click install
npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill update-presenters-companion-raghavamohan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-presenters-companion
Source: https://github.com/raghavamohan/AnalyticMadhyasthDarshan/tree/main/.cursor/skills/update-presenters-companion
Command: npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill update-presenters-companion-raghavamohan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping a study's Presenter's Companion in sync with its teaching deck is error-prone: slide counts drift, speaker notes go stale, and DOCX/PDF artifacts fall out of date. This Skill keeps the companion markdown as the single source of truth and regenerates all derived artifacts consistently. ## Core Features & Use Cases - Deck-companion alignment: Diff # Slide N headings against the .pptx slide count and order, then remap, add, or remove sections until they match. - Artifact regeneration: Build DOCX and PDF from companion markdown via _build_presenters_companion.py, and sync read-aloud scripts into PowerPoint notes panes from a JSON map. - Verification workflow: Run _verify_companion_outputs.py and the staged _build_presentations.py pipeline to validate slide counts, complete scripts, and layout before committing. - Use Case: After adding two slides to a study deck, update the companion markdown, rebuild the DOCX/PDF, sync speaker notes into the PPTX, and regenerate the deck and notes PDFs for a study-update PR. ## Quick Start Update the Presenter's Companion for my study so its slide sections match the deck, then rebuild the DOCX, PDF, and PowerPoint speaker notes.

Frequently Asked Questions about update-presenters-companion

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

FAQPage Schema
How do I sync PowerPoint speaker notes from a JSON file?▼

Run Scripts/_sync_pptx_speaker_notes.py with the deck path and the companion's .notes.json file. The JSON keys are 1-based slide numbers and values are complete read-aloud scripts written into the PPTX notes pane.

How do I rebuild a Presenter's Companion DOCX and PDF from markdown?▼

Run Scripts/_build_presenters_companion.py with the companion markdown path and the --pdf flag from the repository root. Add --pptx with the deck path to also extract delivery sections into the notes JSON and sync speaker notes.

What is the difference between the deck PDF, notes PDF, and companion PDF?▼

The deck PDF contains slides only for projection. The notes PDF pairs each slide image with its read-aloud script for the presenter. The companion PDF adds primary-text background and Q&A for pre-session study.

Why does companion verification fail after editing the deck?▼

Verification fails when # Slide N headings no longer match the PPTX slide count or when the notes JSON has missing or extra entries. Diff the deck against the companion, remap sections, and rebuild all artifacts before re-running _verify_companion_outputs.py.

Does a companion-only edit update the study's Edited-on timestamp?▼

No. Companion-only changes do not refresh the study's Edited-on or catalog timestamps. Mark the Edited-on checklist items as N/A in the study-update PR when the study markdown itself was not changed.

Related Skills

Explore More Education & Research Skills→
kortix-aikortix-ai
20.2k

presentations

Create, edit, validate, and export HTML slide decks and native PowerPoint files.

Official
Advanced
StarrySerendipityStarrySerendipity

push-to-pr

Push local commits to an existing PR's source branch via GitHub API.

Community
Advanced
jiunbaejiunbae
12

document-processor

Extract and convert text, tables, images, and metadata across PDF, DOCX, XLSX, PPTX formats.

Community
Advanced
timurgaleevtimurgaleev
5

reroll-buddy

Remove the companion key from ~/.claude.json after user confirmation.

Community
Intermediate