youtube-transcribe

Extract YouTube subtitles into structured HTML transcripts with chapters.

2|Updated Jun 21, 2019
One-click install
npx skills add https://github.com/helmecke/dotfiles --skill youtube-transcribe-helmecke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: youtube-transcribe
Source: https://github.com/helmecke/dotfiles/tree/main/dot_config/opencode/skill/youtube-transcribe
Command: npx skills add https://github.com/helmecke/dotfiles --skill youtube-transcribe-helmecke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transcribing YouTube videos for accessibility, indexing, or study notes can be time-consuming and error-prone. This skill automates the process, delivering a clean, HTML-formatted transcript that is easy to embed on web pages and share.

Core Features & Use Cases

  • Transcript extraction: fetches YouTube subtitles or auto-generated captions for a given video.
  • HTML output: formats the transcript into a structured HTML document with a title, chapter headings, and paragraph content.
  • Chapter handling: uses video chapters if available, or creates logical 1–3 minute segments for long videos.
  • Fallback and validation: aborts gracefully when transcripts are unavailable or permissions are restricted.

Quick Start

Provide a YouTube video URL and receive a structured transcript in HTML format.

Frequently Asked Questions about youtube-transcribe

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

FAQPage Schema
Can I get chapter headings from a YouTube video transcript?

Yes, generating a YouTube video transcript uses available video chapters and converts them into HTML chapter headings, or creates logical one to three minute segments for long videos.

Does YouTube transcript extraction work with auto-generated captions?

YouTube transcript extraction fetches both manually uploaded subtitles and auto-generated captions, processing VTT timestamps to produce structured HTML paragraphs for accessibility and SEO.

What happens when YouTube subtitles are unavailable or restricted?

When YouTube subtitles are unavailable or restricted, the YouTube transcript extraction aborts gracefully, ensuring validation fails safely without returning incomplete HTML content.

Do I need yt-dlp to fetch subtitles for YouTube videos?

Yes, fetching YouTube subtitles for transcript extraction requires yt-dlp to retrieve VTT caption files, which are then processed to output structured HTML paragraphs with timestamps.

What is the best way to convert YouTube captions into structured HTML?

The best way to convert YouTube captions into structured HTML is using automated VTT processing that extracts timestamps and formats paragraphs with title and chapter headings for web content.