ref-video-transcript

Extract video subtitles and save them as structured Markdown transcripts.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill ref-video-transcript
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ref-video-transcript
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/data-fetch/ref-video-transcript
Command: npx skills add https://github.com/sunLeee/optimization --skill ref-video-transcript

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual transcription of video content is time-consuming and error-prone; this skill automates extraction of subtitles from videos and converts them into a Markdown transcript.

Core Features & Use Cases

  • Subtitle extraction: fetches available subtitles from platforms like YouTube or Vimeo.
  • Multilingual support: selects and exports transcripts in multiple languages.
  • Markdown-ready output: renders a clean, structured transcript suitable for documentation and references.
  • Quality indicators: annotates auto-generated transcripts with quality hints to help reviewers.
  • Storage & integration: saves transcripts under docs/references/videos/<video-title>/transcript.md and can link with ref-video-downloader for download flows.

Quick Start

Run the skill with a video URL to extract available subtitles and save a Markdown transcript.

Frequently Asked Questions about ref-video-transcript

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

FAQPage Schema
How do I extract video transcripts and save them as Markdown files?

To extract video transcripts and save them as Markdown, you can automate fetching subtitles from platforms like YouTube or Vimeo, converting them into structured Markdown documents stored under docs/references/videos.

Can I extract multilingual subtitles from YouTube or Vimeo videos?

Yes, you can extract multilingual subtitles from YouTube or Vimeo videos. The process fetches available subtitles in multiple languages and exports them as separate Markdown transcript files.

Does this video transcript extraction process flag auto-generated subtitles?

Yes, the video transcript extraction process includes an automatic quality indicator. It annotates auto-generated subtitles with quality hints to help reviewers identify non-manual transcripts.

What is the best way to automate video subtitle extraction for documentation?

The best way to automate video subtitle extraction for documentation is using tools like yt-dlp to fetch subtitles and render them as clean, structured Markdown files suitable for references.

Where are the extracted multilingual video transcripts stored?

Extracted multilingual video transcripts are stored under docs/references/videos/<video-title>/transcript.md. This structure ensures outputs are organized and integrated into your documentation workflow.