annotate-talk

rajshah4's avatarfrom rajshah4

Create annotated blog posts from technical talks with slides. Use when asked to convert a video presentation to a blog post, create written content from a talk, or annotate slides with transcript.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025

When & Why to Use This Skill

This Claude skill automates the conversion of video-based technical presentations into professional, annotated blog posts. By integrating YouTube transcripts with PDF slides, it solves the time-consuming challenge of manual content repurposing, providing a structured Markdown output that is both SEO-friendly and easy to read.

Use Cases

  • Conference Content Repurposing: Transform recorded technical conference talks into comprehensive blog posts to increase reach and SEO visibility.
  • Internal Documentation: Convert internal engineering 'brown bag' sessions or technical demos into searchable, written documentation for team knowledge bases.
  • Educational Tutorials: Create detailed, slide-by-slide study guides from educational webinars or online lectures by syncing transcripts with visual aids.
nameannotate-talk
descriptionCreate annotated blog posts from technical talks with slides. Use when asked to convert a video presentation to a blog post, create written content from a talk, or annotate slides with transcript.

Annotated Talk Generator

Use the ai-annotate-talk CLI tool to create blog posts from technical talks.

Usage

ai-annotate-talk "https://youtu.be/VIDEO_ID" slides.pdf output_images/
ai-annotate-talk "https://youtu.be/VIDEO_ID" slides.pdf output_images/ --output post.md
ai-annotate-talk "https://youtu.be/VIDEO_ID" slides.pdf output_images/ --transcript custom.txt
ai-annotate-talk "https://youtu.be/VIDEO_ID" slides.pdf output_images/ --prompt context.txt

Requirements

  • GEMINI_API_KEY environment variable
  • JINA_READER_KEY environment variable
  • poppler-utils installed (brew install poppler on macOS)
  • The hamel_tools package must be installed: pip install hamel_tools

Output

Markdown blog post with embedded slide images and synchronized annotations.