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

Ready to run

npx skills add https://github.com/raghavamohan/AnalyticMadhyasthDarshan --skill update-presenters-companion-raghavamohan

💬 Prompt for ChatGPT / Claude Chat▼

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.