Back to search
video-quotes
MarketplaceWorks with Claude CodeGitHub
Claude Code skill: YouTube interview to corrected transcript, quote page and word-accurate clips.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/aokellermann--video-quotes)HTML
<a href="/listings/aokellermann--video-quotes"><img src="/api/listings/aokellermann--video-quotes/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
As a plugin:
/plugin marketplace add aokellermann/video-quotes /plugin install video-quotes@video-quotes
Or as a personal skill, by linking the skill folder into your skills directory:
git clone https://github.com/aokellermann/video-quotes ~/repos/video-quotes ln -s ~/repos/video-quotes/skills/video-quotes ~/.claude/skills/video-quotes
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 14 lines
- {
- "name": "video-quotes",
- "owner": {
- "name": "Antony Kellermann"
- },
- "description": "Claude Code skill: YouTube interview to corrected transcript, quote page and word-accurate clips.",
- "plugins": [
- {
- "name": "video-quotes",
- "source": "./",
- "description": "YouTube interview -> corrected transcript, quote page with timestamps, and word-accurate clips."
- }
- ]
- }
README.md · README · 116 lines
- # video-quotes
- A [Claude Code](https://claude.com/claude-code) skill that turns a YouTube interview or talk into:
- - a **corrected transcript** with speaker labels (YouTube's auto-captions fixed for misheard names and terms,
- filler words and stutters removed),
- - a **quote page**: the best quotes on a theme you choose, grouped, each linked to its moment in the video, plus a
- summary of what else the conversation covers,
- - optional **video clips** of each quote, cut at word boundaries and checked so no word is clipped.
- The page is a single HTML file (published as a claude.ai Artifact when Claude has that tool), light and dark themes
- included.
- ## Use
- Ask Claude Code things like:
- > get me the transcript for https://www.youtube.com/watch?v=…
- >
- > pull the best quotes about AI risk from it, with clips
- >
- > do the same for these two videos
- The skill's instructions (`skills/video-quotes/SKILL.md`) walk Claude through fetching captions, correcting them,
- labelling speakers, choosing quotes, cutting clips and checking every clip's first and last words.
- ## Install
- As a plugin:
- ```
- /plugin marketplace add aokellermann/video-quotes
- /plugin install video-quotes@video-quotes
- ```
- Or as a personal skill, by linking the skill folder into your skills directory:
- ```bash
- git clone https://github.com/aokellermann/video-quotes ~/repos/video-quotes
- ln -s ~/repos/video-quotes/skills/video-quotes ~/.claude/skills/video-quotes
- ```
- ## Requirements
- You need two programs: **uv** (always) and **ffmpeg** (for clips; it includes `ffprobe`). Everything else installs
- itself on first use.
- ### 1. uv
- [uv](https://docs.astral.sh/uv/getting-started/installation/) runs `vq.py` and installs its Python dependencies
- (youtube-transcript-api, faster-whisper, numpy) and a suitable Python automatically. You don't need Python installed.
- | System | Command |
- |---|---|
- | macOS / Linux | `curl -LsSf https://astral.sh/uv/install.sh \| sh` |
- | macOS (Homebrew) | `brew install uv` |
- | Windows (PowerShell) | `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 \| iex"` |
- | Windows (winget) | `winget install --id=astral-sh.uv -e` |
- Open a new terminal afterwards so `uv` is on your `PATH`.
- ### 2. ffmpeg
- Only needed for video clips (transcripts and quote pages work without it).
- | System | Command |
- |---|---|
- | macOS (Homebrew) | `brew install ffmpeg` |
- | Ubuntu / Debian | `sudo apt install ffmpeg` |
- | Fedora | `sudo dnf install ffmpeg` (enable [RPM Fusion](https://rpmfusion.org/Configuration) first) |
- | Arch | `sudo pacman -S ffmpeg` |
- | Windows (winget) | `winget install --id=Gyan.FFmpeg -e` |
- ### 3. Check
- ```bash
- uv --version && ffmpeg -version | head -1 && ffprobe -version | head -1
- ```
- Claude runs the same check before starting and tells you what's missing.
- ### Installed automatically on first use
- - **Python packages** for `vq.py`, by uv, into its cache (a few hundred MB, mostly faster-whisper).
- - **yt-dlp**, the latest release, run through `uvx` when clips need the video.
- - **The whisper speech model** (`small.en`, ~500 MB) from Hugging Face, the first time clips are cut. It runs on
- the CPU, no GPU needed, at roughly 3 minutes of audio per minute.
- ### Other things to know
- - **Disk**: each downloaded video is ~300 MB at 720p (kept in the work folder you choose; delete it when done).
- - **Network**: use a home or office connection. YouTube blocks caption and video requests from many cloud and
- datacenter IPs, so this generally won't work on a cloud VM or in a hosted sandbox.
- - **Publishing**: in Claude Code with the claude.ai Artifact tool, pages are published as private Artifacts; without
- it you get `page.html` with a `clips/` folder to open locally or host anywhere.
- ## The script
- `skills/video-quotes/vq.py` can also be used on its own:
- ```
- uv run -q vq.py fetch VIDEO -d DIR captions -> paras.txt (numbered speaker turns), ts.txt, meta.json
- uv run -q vq.py fix DIR FIXES.json [--tidy] apply caption corrections; --tidy drops uh/um and stutters
- uv run -q vq.py label DIR SPEC.json speaker labels -> tx.html
- uv run -q vq.py page DIR PAGE.json -o OUT quote page
- uv run -q vq.py video VIDEO -d DIR 720p mp4
- uv run -q vq.py words DIR --from S --to E whisper word timestamps for a stretch
- uv run -q vq.py clips DIR CLIPS.json cut clips at word boundaries
- uv run -q vq.py check DIR transcribe each clip's first/last 3 s
- ```
- The JSON formats are described in `SKILL.md`.
- ## License
- MIT, see `LICENSE`.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.