Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kar2phi--video-lens/badge.svg)](/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

i

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.

  1. # video-lens
  2. **Paste a YouTube link into your agent. Get a report you read beside the video.**
  3. video-lens is a skill for Claude Code, Codex, Cursor and other agents that read SKILL.md. It
  4. writes a summary, the takeaway, numbered key points and a timestamped outline, and opens them in
  5. your browser with the video playing beside the text. Click any line to jump there.
  6. **[video-lens.org](https://video-lens.org)** has the rest: an example report, every feature,
  7. privacy, and all the ways to install.
  8. <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>
  9. ## Install
  10. ```bash
  11. npx skills add kar2phi/video-lens
  12. ```
  13. Pick all three skills when asked. On the first video, video-lens checks what is missing and asks
  14. before installing anything. Its Python packages go into its own folder,
  15. `~/.local/share/video-lens/venv`, not your system Python.
  16. <details>
  17. <summary><b>Manual install</b></summary>
  18. The same setup by hand, with the script the skill runs:
  19. ```bash
  20. python3 ~/.agents/skills/video-lens/scripts/setup.py transcript-api yt-dlp
  21. # Optional, Apple Silicon: transcribe videos that have no captions
  22. python3 ~/.agents/skills/video-lens/scripts/setup.py mlx-whisper && brew install ffmpeg
  23. ```
  24. Adjust the path to where your agent keeps skills (`~/.claude/skills/…` for Claude Code). Add
  25. `--upgrade` when YouTube breaks an older release. If you'd rather use your own environment,
  26. install `requirements.txt` into the `python3` your agent runs; the skill uses those packages when
  27. its own folder doesn't have them.
  28. </details>
  29. Works in any agent that reads [SKILL.md](https://agentskills.io). To install from a clone or as
  30. a Raycast command, see [docs/guide.md](docs/guide.md#install-from-a-clone).
  31. Once a day at most, video-lens asks GitHub whether a newer version is out and tells you; it sends
  32. nothing about you and never updates without asking
  33. ([what it checks, and how to turn it off](docs/guide.md#updating-and-removing)).
  34. <details>
  35. <summary><b>Requirements</b></summary>
  36. | Needed for | What |
  37. | ------------------------------------------- | ------------------------------------------------------------------- |
  38. | Running the skill | An agent that reads SKILL.md, Python 3, macOS or Linux (Windows is best effort) |
  39. | Fetching captions | `youtube-transcript-api` |
  40. | Metadata, chapters, audio download | `yt-dlp` 2026.8.19 or newer (older builds cannot download audio) |
  41. | **Optional:** videos without captions | `mlx-whisper` and `ffmpeg`, Apple Silicon only |
  42. | **Optional:** yt-dlp edge cases | [Deno](https://deno.com), only if yt-dlp fails on a video |
  43. | **Optional:** install from a clone | [Task](https://taskfile.dev) (`brew install go-task`) |
  44. | **Optional:** a global hotkey | [Raycast](https://www.raycast.com), macOS |
  45. The skill installs the Python packages on first use (see Install). The first local transcription downloads a Whisper
  46. model. YouTube Shorts are not supported.
  47. </details>
  48. ## Where the transcript comes from
  49. video-lens reads YouTube's own captions first: fast, and nothing is downloaded. When a video has
  50. no captions or they are blocked, it asks before it falls back to local transcription: `yt-dlp`
  51. downloads the audio and Whisper transcribes it on your machine, then the report is written the
  52. same way. This is slower than captions and needs the optional packages above.
  53. ## Use
  54. ```
  55. /video-lens https://www.youtube.com/watch?v=... # a report, opened in your browser
  56. /video-lens <url> in Spanish, focus on the pricing part # language or focus in your own words
  57. /video-lens-gallery # every report you made, searchable
  58. /video-lens-recs what's new in Rust this week # what to watch next, with reasons
  59. ```
  60. Reports are saved under `~/Downloads/video-lens/reports/`. After a report, say "share" for an
  61. unlisted link on video-lens.org and "unshare" to delete it. Nothing is uploaded unless you ask.
  62. Sharing, the gallery, recommendations and their privacy, Raycast and troubleshooting:
  63. [docs/guide.md](docs/guide.md). What changed: [CHANGELOG.md](CHANGELOG.md).
  64. ## Development
  65. ```bash
  66. task test # fast suite, no network
  67. task eval AGENT=claude # real agent runs on the fixture videos
  68. ```
  69. Tests, evals and the repo layout: [docs/development.md](docs/development.md). PRs welcome; the
  70. sources of truth are `skills/*/SKILL.md` and `viewer/`.
  71. Found a bug or have an idea? [Open an issue](https://github.com/kar2phi/video-lens/issues/new/choose)
  72. from the bug or feature template, or send a pull request.
  73. ## License
  74. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.