video-transcript

A command-line tool that turns captions or speech from an online video into readable plain text. It supports YouTube, Vimeo, Bilibili, and many other video sites.

In plain words
What is it for?
Use it to extract transcripts from video links, choose a preferred subtitle language, and transcribe videos without captions when the optional speech service is configured.
Why use it?
It lets you search, quote, summarize, or study a video without watching it and removes caption timing marks and repeated rolling text.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/mrobinson2/azureagentforge/video-transcript
Any agent
npx skills add mrobinson2/AzureAgentForge --skill video-transcript
Clone the repo
git clone --depth 1 https://github.com/mrobinson2/AzureAgentForge

Made for: Claude Code, Codex.

Per session 119 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 771 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00119 $0.00771
Opus 5 $0.00060 $0.00385
Sonnet 5 $0.00024 $0.00154
Haiku 4.5 $0.00012 $0.00077

Measured 2d ago against content hash 978f683c639c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

video-transcript scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

apps/hermes/overrides/skills/playbooks/video-transcript/SKILL.md · 66 lines

How it starts

The opening of the file, as written. The whole thing — 66 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Get a video's transcript with video-transcript

video-transcript is a CLI on $PATH that extracts a clean, plain-text transcript from a video URL using yt-dlp. It fetches subtitles/captions (human or auto-generated), strips the timing markup, and de-duplicates the rolling caption lines into readable prose.

Usage

# Print the transcript — capture it so you can grep/quote/summarize it:
video-transcript "https://www.youtube.com/watch?v=VIDEO_ID" > /tmp/page.md
head -c 4000 /tmp/page.md

# Prefer a subtitle language (falls back to English):
video-transcript --lang es "https://www.youtube.com/watch?v=VIDEO_ID"

Only http(s) URLs are accepted. Output (and errors) follow the same convention as web-read: transcript on stdout, errors on stderr.

How it gets the text

  1. Captions (default, no key) — human subs first, then auto-generated. Covers most YouTube videos.
  2. Whisper fallback (optional) — if a video has no captions and GROQ_API_KEY is set, it downloads the audio and transcribes it with Groq Whisper (needs ffmpeg). Without the key, a caption-less video returns exit 4.

Behavior and exit codes

Exit Meaning
0 Success — transcript on stdout.
2 Usage / validation error (no URL, bad scheme, bad flag).
3 Fetch or transcription failed (clear error on stderr).
4 No captions and no Whisper fallback (GROQ_API_KEY unset). Try a different source.
5 A required tool (yt-dlp, or ffmpeg for the fallback) is missing.

Environment

Variable Purpose
VIDEO_TRANSCRIPT_MAX_CHARS Cap on transcript length (default 100000; long videos are truncated with a marker).
VIDEO_TRANSCRIPT_LANG Default subtitle language (default en).
VIDEO_TRANSCRIPT_YT_CLIENT yt-dlp YouTube player_client (default android,web). YouTube gates captions behind a PO token for the web client from datacenter IPs; the android client bypasses it. Override if YouTube extraction breaks.
GROQ_API_KEY Optional. Enables the Whisper fallback for caption-less videos.

Read the full file on GitHub · 66 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 66 lines · 119 tokens per session scan A 978f683c639c

Subscribe to this mod's changes

video-transcript is a skill published in the GitHub repository mrobinson2/AzureAgentForge (21 stars, last pushed 11d ago), licensed MIT. It adds 119 tokens to every session and 771 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

drawio

WORKFLOW SKILL — Generate Azure architecture diagrams in .drawio via simonkurtz-MSFT MCP server (full Azure icon set, batch creation, transactional mode). Covers architecture, dependency, runtime-flow, and as-built diagrams. WHEN: 'draw.io diagram', 'Azure architecture diagram', 'as-built diagram', 'runtime flow…

jonathan-vella/apex-accelerator · 99 tokens

copilot-customization

Authoritative reference for VS Code Copilot customization mechanisms: instructions, prompt files, custom agents, agent skills, MCP servers, hooks, and plugins. Use when deciding which customization type to use, creating new .instructions.md/.prompt.md/.agent.md/SKILL.md/mcp.json files from scratch, or debugging why a…

jonathan-vella/apex-accelerator · 90 tokens

deploy-model

Unified Azure OpenAI model deployment skill with intelligent intent-based routing. Handles quick preset deployments, fully customized deployments (version/SKU/capacity/RAI policy), and capacity discovery across regions and projects. USE FOR: deploy model, deploy gpt, create deployment, model deployment, deploy openai…

jonathan-vella/apex-accelerator · 129 tokens

microsoft-skill-creator

Create agent skills for Microsoft technologies using Learn MCP tools. USE FOR: generating skills that teach agents about Azure services, .NET libraries, Microsoft 365 APIs, VS Code extensions, Bicep modules, or any Microsoft technology. DO NOT USE FOR: general skill scaffolding without Microsoft tech focus (use…

jonathan-vella/apex-accelerator · 86 tokens

Cloud Security & Container Hardening

AWS/Azure/GCP security auditing, container and Kubernetes hardening, Infrastructure as Code scanning, and cloud compliance assessment.

Masriyan/Claude-Code-CyberSecurity-Skill · 30 tokens

microsoft-code-reference

Look up Microsoft API references, find working code samples, and verify SDK code is correct. USE FOR: Azure SDK method verification, .NET/Python package lookups, code sample discovery, error troubleshooting, catching hallucinated methods and deprecated patterns. DO NOT USE FOR: conceptual documentation (use…

jonathan-vella/apex-accelerator · 99 tokens