generate-writeup

Generate annotated write-up from a presentation

You are generating a blog-style write-up from a presentation. The user will provide a presentation folder path (e.g., presentations/my-talk). That folder must contain a presentation.md file.

presentation.md format

# Talk title

- **Date:** 2026-01-15
- **Video:** https://www.youtube.com/watch?v=VIDEO_ID
- **Slides:** slides.pdf
- **Transcript:** transcript.txt

## Notes

Extra notes here

Required fields: Video and Slides. All others are optional. Slides can be a local PDF path, PDF URL, PPTX URL, OneDrive link, or RevealJS URL. Video can be a YouTube URL or local MP4 path.

Pipeline

Follow these steps in order. Cache all intermediate outputs in <presentation_folder>/outputs/ so subsequent runs skip completed steps.

Step 1: Resolve slides

• If Slides in presentation.md is a URL, fetch and convert to PDF:

  uv run .agents/skills/fetch-slides/fetch_slides.py <url> <presentation_folder>/outputs
  

  This produces slides.pdf (and slides_content.md for RevealJS URLs).
• If slides is a local file path (relative to the presentation folder), use it directly.
• Skip if <presentation_folder>/outputs/slides.pdf already exists.

Step 2: Convert slides to images

Split the PDF into individual PNGs:

uv run .agents/skills/convert-slides-to-images/convert_slides_to_images.py <pdf_path> <presentation_folder>/outputs/slide_images

Skip if <presentation_folder>/outputs/slide_images/ already contains slide_*.png files.

Step 3: Extract transcript

• If Transcript is specified in presentation.md, read from that path (relative to presentation folder).
• If <presentation_folder>/outputs/transcript.txt exists, use the cached version.
• Otherwise, extract from YouTube:

  uv run .agents/skills/extract-transcript/extract_transcript.py <youtube_url> <presentation_folder>/outputs/transcript.txt
  

Step 4: Generate video chapters