OpenParable
Skip to content
← Back to skills

Get Youtube Transcript Raw

Documents
get-youtube-transcript-raw

Get Youtube Transcript Raw is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Capture a YouTube video transcript as raw material using `ytt`, storing it in the raw/ directory with minimal metadata for later distillation.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/get-youtube-transcript-raw/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/get-youtube-transcript-raw, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Get YouTube Transcript (Raw)

When to use

Use when you need the raw transcript (plus YouTube title/description) saved to raw/ for later distillation.

Keywords: youtube, transcript, captions, ytt, raw, capture

Inputs

Required:

  • url (string): YouTube URL (e.g., https://www.youtube.com/watch?v=... or https://youtu.be/...)

Optional:

  • title_hint (string): Used only if ytt can’t provide a title.

Outputs

This skill produces:

  1. A new Markdown file in raw/ named YYYYMMDD-HHMMSSZ--<slug>.md
  2. YAML front matter aligned with docs/distillation/distillation-pipeline.md:
    • title (best-effort)
    • source_url (the provided URL)
    • captured_at (UTC ISO timestamp)
    • capture_type: youtube_transcript
    • capture_tool: ytt
    • raw_format: markdown
    • status: captured (or capture_failed on failure)
  3. Body content: the raw transcript text emitted by ytt (no summarization).

Prerequisites

  • ytt (this repo’s YouTube transcript utility)
  • python3 (used by the bundled script for slugging and safe YAML string escaping)

Quick start

Capture directly (uses ytt fetch --no-copy internally):

./scripts/ytraw "<youtube_url>"

If the current environment can’t access YouTube (common in sandboxes), run ytt locally and pipe:

ytt fetch --no-copy "<youtube_url>" | ./scripts/ytraw

Manual execution (Fallback)

If you encounter persistent issues capturing a transcript within the sandbox (e.g., network restrictions or tool failures), inform the user they can run the script manually on their local machine.

The script ./scripts/ytraw is designed to extract the URL directly from the clipboard if no arguments are provided.

Instructions for the user:

  1. Copy the YouTube URL to your clipboard.
  2. Run the following command in your terminal: 
    ./scripts/ytraw
  3. If manual adjustments are required, you can edit the file directly. If you prefer the model to perform adjustments, share the file path or URL with it.

Optional: shell alias (zsh)

Add to ~/.zshrc:

ytraw () { ytt fetch --no-copy "$1" | /path/to/repo/scripts/ytraw --from-stdin }

References

  • Pipeline and front matter schema: docs/distillation/distillation-pipeline.md