Claude Skill

video-transcript

Extract video transcripts: yt-dlp subtitles to clean paragraphs.

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download notque-vexjoy-agent-skills_research_video-transcript-1f3eabd.zip · 1 KB

Install

skills CLI npx skills add https://github.com/notque/vexjoy-agent/tree/main/skills/research/video-transcript
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install notque-vexjoy-agent@llmmart
Git git clone https://github.com/notque/vexjoy-agent.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole notque/vexjoy-agent collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Video Transcript

Pull a video's transcript as readable paragraphs. Two paths, in order:

Path 1 — uploader subtitles (accurate, prefer when present):

yt-dlp --skip-download --write-subs --sub-langs en --sub-format vtt \
  -o '<work-dir>/%(id)s' '<URL>'

Path 2 — auto-generated captions (fallback when path 1 writes no file):

yt-dlp --skip-download --write-auto-subs --sub-langs en --sub-format vtt \
  -o '<work-dir>/%(id)s' '<URL>'

Then clean the VTT into paragraphs:

python3 ~/.claude/skills/video-editing/scripts/vtt_to_paragraph.py <work-dir>/<id>.en.vtt

Default output is plain paragraph text with [Music]-style cues stripped and the rolling duplicates of auto-captions deduplicated. Use --timestamps for [mm:ss] markers, --keep-brackets to keep cue tags, -o FILE to write to a file.

For other languages, change --sub-langs (e.g. de, en.*). List what a video offers with yt-dlp --list-subs '<URL>'.

Error handling

Both paths write no .vtt file

Cause: video has no subtitles or captions in the requested language. Solution: run yt-dlp --list-subs '<URL>' and pick an available language; if none exist, report that and offer audio transcription via the markdown-converter skill on a downloaded audio file.

HTTP 429 / "Sign in to confirm"

Cause: platform rate-limiting the host. Solution: wait and retry with --sleep-requests 2; keep request volume low.

Cleaner output repeats lines

Cause: VTT came from a third path (e.g. translated captions) with cue formats the dedupe misses. Solution: rerun the cleaner; if repeats remain, file the sample VTT alongside a fix to vtt_to_paragraph.py.

Files (vexjoy-agent)
  • SKILL.md 2.3 KB
    ---
    name: video-transcript
    promoted_to: video-editing
    description: "Extract video transcripts: yt-dlp subtitles to clean paragraphs."
    user-invocable: false  # default -- router-dispatched, not user-typed
    agent: python-general-engineer
    allowed-tools:
      - Bash
      - Read
    routing:
      triggers:
        - "video transcript"
        - "youtube transcript"
        - "extract transcript"
        - "download subtitles"
        - "what does this video say"
        - "get transcript"
        - "transcribe video"
        - "transcribe this video"
        - "pull subtitles"
        - "captions from video"
      category: research
      pairs_with:
        - research
    ---
    
    # Video Transcript
    
    Pull a video's transcript as readable paragraphs. Two paths, in order:
    
    **Path 1 — uploader subtitles** (accurate, prefer when present):
    
    ```bash
    yt-dlp --skip-download --write-subs --sub-langs en --sub-format vtt \
      -o '<work-dir>/%(id)s' '<URL>'
    ```
    
    **Path 2 — auto-generated captions** (fallback when path 1 writes no file):
    
    ```bash
    yt-dlp --skip-download --write-auto-subs --sub-langs en --sub-format vtt \
      -o '<work-dir>/%(id)s' '<URL>'
    ```
    
    Then clean the VTT into paragraphs:
    
    ```bash
    python3 ~/.claude/skills/video-editing/scripts/vtt_to_paragraph.py <work-dir>/<id>.en.vtt
    ```
    
    Default output is plain paragraph text with `[Music]`-style cues stripped and the rolling duplicates of auto-captions deduplicated. Use `--timestamps` for `[mm:ss]` markers, `--keep-brackets` to keep cue tags, `-o FILE` to write to a file.
    
    For other languages, change `--sub-langs` (e.g. `de`, `en.*`). List what a video offers with `yt-dlp --list-subs '<URL>'`.
    
    ## Error handling
    
    ### Both paths write no .vtt file
    Cause: video has no subtitles or captions in the requested language.
    Solution: run `yt-dlp --list-subs '<URL>'` and pick an available language; if none exist, report that and offer audio transcription via the `markdown-converter` skill on a downloaded audio file.
    
    ### HTTP 429 / "Sign in to confirm"
    Cause: platform rate-limiting the host.
    Solution: wait and retry with `--sleep-requests 2`; keep request volume low.
    
    ### Cleaner output repeats lines
    Cause: VTT came from a third path (e.g. translated captions) with cue formats the dedupe misses.
    Solution: rerun the cleaner; if repeats remain, file the sample VTT alongside a fix to `vtt_to_paragraph.py`.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.