annotate-talk

Generate annotated blog posts from YouTube URLs or local MP4s with synchronized slide images.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/hamelsmu/hamel --skill annotate-talk-hamelsmu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: annotate-talk
Source: https://github.com/hamelsmu/hamel/tree/main/plugins/hamel-tools/skills/annotate-talk
Command: npx skills add https://github.com/hamelsmu/hamel --skill annotate-talk-hamelsmu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting technical talks and slide decks into polished, annotated blog posts is time-consuming and error-prone; this Skill automates transcript extraction, slide rendering, and alignment so authors can produce publishable content faster.

Core Features & Use Cases

  • Transcript Extraction and Synchronization: Fetch transcripts from YouTube or transcribe local MP4 files and align text to slide timings.
  • Slide Image Embedding: Render PDF slides to images and embed them inline with synchronized annotations.
  • Custom Inputs and Tailored Prompts: Accept custom transcript files and prompt/context files to control tone and structure.
  • Use Case: Convert a conference talk and its PDF slides into a markdown article with embedded slide images and synchronized commentary for a technical blog or documentation site.

Quick Start

Use the ai-annotate-talk CLI to convert a YouTube link and slides.pdf into a markdown blog post with embedded slide images and synchronized annotations.

Frequently Asked Questions about annotate-talk

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

FAQPage Schema
How do I turn a YouTube talk and PDF slides into an annotated blog post?

To create an annotated blog post from a YouTube talk and PDF slides, use the ai-annotate-talk CLI to fetch the transcript, render slide images, and align text to slide timings, generating a markdown file with inline images and synchronized commentary.

Can I convert local MP4 video files into markdown articles with synchronized slide annotations?

Yes, you can convert local MP4 video files into markdown articles by providing the video file to the ai-annotate-talk CLI, which transcribes the audio and aligns the text with your PDF slide deck to produce embedded slide images and annotations.

Do I need API keys to generate slide annotations from recorded technical talks?

Yes, generating slide annotations from technical talks requires the GEMINI_API_KEY and JINA_READER_KEY environment variables to be set, as they are necessary for fetching transcripts and processing the content for your markdown post.

What dependencies are required to render PDF slides for embedding in a technical blog post?

Rendering PDF slides for blog post embedding requires the poppler-utils package for image generation, the hamel package for the ai-annotate-talk CLI, and the required API keys to process the talk recording and slide deck.

Can I use a custom transcript file to control the tone of my slide annotations?

Yes, you can supply custom transcript files and prompt context files to the ai-annotate-talk CLI, allowing you to control the tone and structure of the synchronized slide annotations in the final markdown output.