Agent skill

Youtube Transcribe Skill

by feiskyer in feiskyer/codex-settings

Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally.

MITAuto-check passedMedia & Creative

Install Youtube Transcribe Skill

skills CLI
$ npx skills add feiskyer/codex-settings --skill youtube-transcribe-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install feiskyer/codex-settings youtube-transcribe-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/feiskyer/codex-settings.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/youtube-transcribe-skill .claude/skills/youtube-transcribe-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-transcribe-skill
GitHub stars
244
Token cost
~745 tokens
SKILL.md length
329 words
Files
4 (incl. scripts)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally.

  • Works in 3 steps: Install yt-dlp and confirm yt-dlp… → Resolve the absolute directory… → Keep the output in the user's current…
  • The user wants the spoken content of a YouTube video as text
  • SKILL.md covers Requirements, Primary workflow, Cookie retry and Browser fallback, plus 1 more section
  • Runs Python scripts from its folder; calls python3 and yt-dlp

What it does

Youtube Transcribe Skill is an agent skill from feiskyer/codex-settings. Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally. Use when the user wants the spoken content of a YouTube video as text.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `agents/openai.yaml`, `scripts/transcribe_youtube.py` and `tests/test_transcribe_youtube.py`).

It sits in Media & Creative, covering Transcription. It works with YouTube. The repository describes itself as: Curated skills, profiles, and config templates that supercharge Codex CLI — multi-model, deep research, image gen & browser automation. The licence is MIT.

When your agent uses it

  • The user wants the spoken content of a YouTube video as text
  • Tasks that involve Transcription

Example prompts

  • “/youtube-transcribe-skill”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Install yt-dlp and confirm yt-dlp --version succeeds.
  2. Resolve the absolute directory containing this SKILL.md; refer to it as .
  3. Keep the output in the user's current working directory unless they request another location.

What it can do on your machine

Read from SKILL.md and the folder at commit d7f6570. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • yt-dlp

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Transcribe Skill loads about 745 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 329 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~49
When it runs · the whole SKILL.md, loaded when a task matches
~745

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from feiskyer/codex-settings at commit d7f6570, republished under its MIT licence (© feiskyer). 329 words, ~745 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-transcribe-skill/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
youtube-transcribe-skill
description
Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally. Use when the user wants the spoken content of a YouTube video as text.

YouTube Transcript Extraction

Use the bundled scripts/transcribe_youtube.py wrapper for the primary workflow. It downloads subtitles with yt-dlp, selects the preferred language, converts WebVTT cues into timestamped plain text, and reports the output path and line count.

Requirements

  1. Install yt-dlp and confirm yt-dlp --version succeeds.
  2. Resolve the absolute directory containing this SKILL.md; refer to it as <skill-dir>.
  3. Keep the output in the user's current working directory unless they request another location.

The Python wrapper itself uses only the standard library. It can display --help without yt-dlp being installed.

Primary workflow

Run without browser cookies first:

bash
python3 "<skill-dir>/scripts/transcribe_youtube.py" \
  "<youtube-url>" \
  --output-dir "$PWD"

The default language preference is Simplified Chinese, Traditional Chinese, other Chinese variants, then English. Override it when the user requests another language:

bash
python3 "<skill-dir>/scripts/transcribe_youtube.py" \
  "<youtube-url>" \
  --languages "ja.*,en.*" \
  --output-dir "$PWD"

The wrapper supports normal watch URLs plus youtu.be, Shorts, live, and embed URLs. A successful run writes one .txt file whose non-empty lines use this shape:

text
00:03 Subtitle text
00:08 Next subtitle text

Do not read browser cookies by default. If the initial command fails specifically because the video requires sign-in, age verification, membership, or another authenticated session:

  1. Explain that the retry will let yt-dlp read YouTube cookies from a local browser profile.
  2. Ask the user which browser profile they approve using.
  3. Retry only after approval:
bash
python3 "<skill-dir>/scripts/transcribe_youtube.py" \
  "<youtube-url>" \
  --cookies-from-browser chrome \
  --output-dir "$PWD"

Never print, copy, or persist browser cookies in the transcript or logs.

Browser fallback

Use browser automation only when yt-dlp is unavailable or cannot obtain subtitles and an appropriate browser-control capability is available.

  1. Inspect the tools available in the current session; do not assume fixed MCP server or tool names.
  2. Open the video, reveal the transcript panel, and extract visible timestamp/text pairs.
  3. Save the result as <sanitized-video-title>.txt in the requested directory.
  4. Close pages or sessions opened solely for this task.

If neither CLI extraction nor browser automation is available, report the missing capability instead of claiming success.

Completion report

Return:

  1. Absolute transcript path
  2. Selected subtitle language
  3. Number of transcript lines
  4. Whether browser cookies or browser automation were used

© feiskyer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in skills/youtube-transcribe-skill of feiskyer/codex-settings.

  • SKILL.md
  • agents/openai.yaml
  • scripts/transcribe_youtube.py
  • tests/test_transcribe_youtube.py

Open the folder on GitHubat commit d7f6570

Compare with similar skills

Youtube Transcribe Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Transcribe Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Transcribe Skill this skillfeiskyer/codex-settings244—~745Automated safety check: PassMIT
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.6k—~2.4kAutomated safety check: PassMIT
Video Dataoxylabs/agent-skills875—~1.4kAutomated safety check: PassMIT
Summarizetrpc-group/trpc-agent-go1.9k22 repos~552Automated safety check: PassApache-2.0
Youtube PublishAndonywang123/Epost197—~3.4kAutomated safety check: WarnNone
Watching Videosoxbshw/watch-skill470—~599Automated safety check: NotesMIT

Similar skills

  • Native Subtitle Quote Image

    chengyi-ai/native-subtitle-quote-image

    将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…

    2.6k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Video Data

    oxylabs/agent-skills

    YouTube data extraction API and high-bandwidth proxy downloads.

    875 GitHub stars~1.4k tokensUpdated 11 days ago
    Media & CreativeAuto-check passed
  • Summarize

    trpc-group/trpc-agent-go

    Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).

    1.9k GitHub starsUsed in 22 repos~552 tokens
    Media & CreativeAuto-check passed
  • Youtube Publish

    Andonywang123/Epost

    Prepare an English YouTube release with local Chinese-to-English translation, subtitles and cover localization, then use a deterministic script connected to dedicated Chrome and YouTube Studio to…

    197 GitHub stars~3.4k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: warnings
  • Watching Videos

    oxbshw/watch-skill

    The user shared a video URL, a YouTube/TikTok/stream link, a local video file, a screen recording, a meeting recording, or a playlist/folder of videos — "watch this", "summarize this video", "what's…

    470 GitHub stars~599 tokensUpdated 26 days ago
    Media & CreativeAuto-check: notes
  • Youtube Transcript

    CommandCodeAI/agent-skills

    Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube.

    133 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check: notes

More from feiskyer/codex-settings

All 11 skills in this repo
  • Claude Skill

    feiskyer/codex-settings

    Delegate a task to the Claude Code CLI, typically a headless claude -p run.

    244 GitHub stars~742 tokensUpdated 14 days ago
    Auto-check passed
  • Gpt Image Skill

    feiskyer/codex-settings

    Generate or edit images when the user names OpenAI, GPT Image, or a gpt-image model.

    244 GitHub stars~572 tokensUpdated 14 days ago
    Auto-check passed
  • Minimax Image Skill

    feiskyer/codex-settings

    Generate images when the user names MiniMax or image-01/image-01-live.

    244 GitHub stars~495 tokensUpdated 14 days ago
    Auto-check passed
  • Code Simplifier

    feiskyer/codex-settings

    Simplify existing code for clarity and maintainability without changing behavior.

    244 GitHub stars~521 tokensUpdated 14 days ago
    Auto-check passed
  • Deep Research

    feiskyer/codex-settings

    用 Codex CLI 子任务完成多来源深度调研并综合成带出处的报告。用于确实需要分头取证的研究,不用于单次查证或已给定材料的总结。

    244 GitHub stars~302 tokensUpdated 14 days ago
    Auto-check passed
  • Nanobanana Skill

    feiskyer/codex-settings

    Generate, edit, or composite images with Gemini/Nanobanana. An agent skill from feiskyer/codex-settings.

    244 GitHub stars~1.2k tokensUpdated 14 days ago
    Auto-check passed

Works with

Questions about Youtube Transcribe Skill

What does Youtube Transcribe Skill do?

Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally. Youtube Transcribe Skill is an agent skill from feiskyer/codex-settings. Extract subtitles or a transcript from a YouTube URL and save normalized timestamped text locally.

When should I use Youtube Transcribe Skill?

Youtube Transcribe Skill fits situations like: the user wants the spoken content of a YouTube video as text; tasks that involve Transcription.

How do I install Youtube Transcribe Skill in Claude Code?

Run `npx skills add feiskyer/codex-settings --skill youtube-transcribe-skill -a claude-code`. Or copy the skill folder (skills/youtube-transcribe-skill in feiskyer/codex-settings) into .claude/skills/youtube-transcribe-skill in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Transcribe Skill in Codex?

Run `npx skills add feiskyer/codex-settings --skill youtube-transcribe-skill -a codex`. Or copy the skill folder (skills/youtube-transcribe-skill in feiskyer/codex-settings) into .agents/skills/youtube-transcribe-skill in your project. Codex loads it when a task matches its description.

Can I use Youtube Transcribe Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add feiskyer/codex-settings --skill youtube-transcribe-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-transcribe-skill, .gemini/skills/youtube-transcribe-skill, .github/skills/youtube-transcribe-skill and .opencode/skills/youtube-transcribe-skill in your project.

What does Youtube Transcribe Skill need to run?

Going by SKILL.md and its folder, Youtube Transcribe Skill needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and yt-dlp). Our summary lists: Python 3.

Does Youtube Transcribe Skill access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Youtube Transcribe Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube Transcribe Skill use?

Youtube Transcribe Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Transcribe Skill use?

About 745 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Youtube Transcribe Skill?

Skills that share tags, products or a category with Youtube Transcribe Skill: Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars), Video Data (oxylabs/agent-skills, 875 stars), Summarize (trpc-group/trpc-agent-go, 1.9k stars) and Youtube Publish (Andonywang123/Epost, 197 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Transcribe Skill?

feiskyer (a GitHub user) maintains it in feiskyer/codex-settings, which has 244 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 27, 2026.

Source: feiskyer/codex-settings on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.