video-lens
video-lens is a coding agent skill that fetches a YouTube transcript and generates a structured HTML report: executive summary, key points, analysis, takeaway, timestamped topic outline, and an embedded in-page player. No API keys, no external services beyond the coding agent itself.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/kar2phi/video-lens with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/kar2phi/video-lens'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/kar2phi--video-lens)HTML
<a href="/listings/kar2phi--video-lens"><img src="/api/listings/kar2phi--video-lens/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.
Option A — skills CLI (recommended)
npx skills add kar2phi/video-lens pip install youtube-transcript-api yt-dlp # Optional: local transcription fallback on Apple Silicon pip install mlx-whisper brew install ffmpeg brew install deno # optional; only needed if yt-dlp fails on certain videos
Then use `/video-lens <url>` in any supported agent.
Option B — Manual install (clone + Task)
Clone the repo and use `task install-skill-local` to copy the skill (prompt, template, and scripts) to a specific agent dir:
git clone https://github.com/kar2phi/video-lens.git cd video-lens task install-skill-local AGENT=claude # or copilot, gemini, cursor, … pip install -r requirements.txt # Optional: local transcription fallback on Apple Silicon pip install mlx-whisper brew install ffmpeg
`task install-skill-local` deploys all files in `skills/video-lens/` (including `scripts/`) — a plain curl of individual files won't pull the script set and the skill will fail at runtime.
Option C — Full install (with Raycast + dev tools)
1. Clone and install Python dependencies
git clone https://github.com/kar2phi/video-lens.git cd video-lens task install-libraries # Optional: local transcription fallback on Apple Silicon pip install mlx-whisper brew install ffmpeg # Optional: only needed if yt-dlp fails on certain videos brew install deno
2. Install the skill
task install-skill-local
3. (Optional) Install the Raycast script for Claude
task install-raycast AGENT=claude
Requires Raycast. The script opens a new iTerm2 tab (or Terminal.app if iTerm2 isn't installed), launches Claude with the required permissions, and runs the skill.
---
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.
README.md · README · 104 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # video-lens
- **Paste a YouTube link into your agent. Get a report you read beside the video.**
- video-lens is a skill for Claude Code, Codex, Cursor and other agents that read SKILL.md. It
- writes a summary, the takeaway, numbered key points and a timestamped outline, and opens them in
- your browser with the video playing beside the text. Click any line to jump there.
- **[video-lens.org](https://video-lens.org)** has the rest: an example report, every feature,
- privacy, and all the ways to install.
- <a href="https://video-lens.org"><img src="docs/video-lens-report.webp" alt="A video-lens report: the video and its outline on the left, the summary and takeaway on the right" width="760"></a>
- ## Install
- ```bash
- npx skills add kar2phi/video-lens
- ```
- Pick all three skills when asked. On the first video, video-lens checks what is missing and asks
- before installing anything. Its Python packages go into its own folder,
- `~/.local/share/video-lens/venv`, not your system Python.
- <details>
- <summary><b>Manual install</b></summary>
- The same setup by hand, with the script the skill runs:
- ```bash
- python3 ~/.agents/skills/video-lens/scripts/setup.py transcript-api yt-dlp
- # Optional, Apple Silicon: transcribe videos that have no captions
- python3 ~/.agents/skills/video-lens/scripts/setup.py mlx-whisper && brew install ffmpeg
- ```
- Adjust the path to where your agent keeps skills (`~/.claude/skills/…` for Claude Code). Add
- `--upgrade` when YouTube breaks an older release. If you'd rather use your own environment,
- install `requirements.txt` into the `python3` your agent runs; the skill uses those packages when
- its own folder doesn't have them.
- </details>
- Works in any agent that reads [SKILL.md](https://agentskills.io). To install from a clone or as
- a Raycast command, see [docs/guide.md](docs/guide.md#install-from-a-clone).
- Once a day at most, video-lens asks GitHub whether a newer version is out and tells you; it sends
- nothing about you and never updates without asking
- ([what it checks, and how to turn it off](docs/guide.md#updating-and-removing)).
- <details>
- <summary><b>Requirements</b></summary>
- | Needed for | What |
- | ------------------------------------------- | ------------------------------------------------------------------- |
- | Running the skill | An agent that reads SKILL.md, Python 3, macOS or Linux (Windows is best effort) |
- | Fetching captions | `youtube-transcript-api` |
- | Metadata, chapters, audio download | `yt-dlp` 2026.8.19 or newer (older builds cannot download audio) |
- | **Optional:** videos without captions | `mlx-whisper` and `ffmpeg`, Apple Silicon only |
- | **Optional:** yt-dlp edge cases | [Deno](https://deno.com), only if yt-dlp fails on a video |
- | **Optional:** install from a clone | [Task](https://taskfile.dev) (`brew install go-task`) |
- | **Optional:** a global hotkey | [Raycast](https://www.raycast.com), macOS |
- The skill installs the Python packages on first use (see Install). The first local transcription downloads a Whisper
- model. YouTube Shorts are not supported.
- </details>
- ## Where the transcript comes from
- video-lens reads YouTube's own captions first: fast, and nothing is downloaded. When a video has
- no captions or they are blocked, it asks before it falls back to local transcription: `yt-dlp`
- downloads the audio and Whisper transcribes it on your machine, then the report is written the
- same way. This is slower than captions and needs the optional packages above.
- ## Use
- ```
- /video-lens https://www.youtube.com/watch?v=... # a report, opened in your browser
- /video-lens <url> in Spanish, focus on the pricing part # language or focus in your own words
- /video-lens-gallery # every report you made, searchable
- /video-lens-recs what's new in Rust this week # what to watch next, with reasons
- ```
- Reports are saved under `~/Downloads/video-lens/reports/`. After a report, say "share" for an
- unlisted link on video-lens.org and "unshare" to delete it. Nothing is uploaded unless you ask.
- Sharing, the gallery, recommendations and their privacy, Raycast and troubleshooting:
- [docs/guide.md](docs/guide.md). What changed: [CHANGELOG.md](CHANGELOG.md).
- ## Development
- ```bash
- task test # fast suite, no network
- task eval AGENT=claude # real agent runs on the fixture videos
- ```
- Tests, evals and the repo layout: [docs/development.md](docs/development.md). PRs welcome; the
- sources of truth are `skills/*/SKILL.md` and `viewer/`.
- Found a bug or have an idea? [Open an issue](https://github.com/kar2phi/video-lens/issues/new/choose)
- from the bug or feature template, or send a pull request.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.