mrkeyoor.com_
Mon 09 Nov 01:46 UTC
AI Toolsevaluationupdated 09 Nov 2026

claude-video review

Watch, from bradautomates/claude-video, gives coding agents timestamped video frames and transcripts from URLs or local files. It documents local extraction and a Gemini engine, with native captions preferred over optional speech transcription.

trackingstars / 7d
Verdict

Our claude-video run installed in 7 seconds, but the test command exited 1 and the ten listed failures reported missing FFmpeg. Watch is a candidate for a focused trial of timestamped agent evidence once the execution environment has its external media tools. Check Watch and yt-dlp's separate Python requirements, choose the engine explicitly and verify a known moment in a local clip before relying on a summary.

We ran it

Lab card: what happened when we ran claude-videoScreenshot of claude-video (github.com/bradautomates/claude-video)
Install✓ · 7s35 packages · 38 MB
Build✓ · 1s
Tests✗ · 7s195 passed · 10 failed · 44 errors of 249 (pytest)
Known vulns0(pip-audit)
Repo51 files~5,167 lines of source · 0.5 MB · 2 CI workflows · tests dir

Answers from our run

Does claude-video build from source?

Dependencies installed in 7 seconds (35 packages), and the build succeeded in 1 seconds. We cloned commit 03ceb42 into a clean Debian container with 3 CPUs and no project-specific setup.

Do claude-video's tests pass?

No. The project's own test command finished in 7 seconds and reported 195 passed, 10 failed, 44 collection errors (pytest).

Does claude-video have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use claude-video?

Claude Chat or Cowork users: the README explicitly excludes those surfaces.

What are the alternatives to claude-video?

yt-dlp, Whisper. Our claude-video run installed in 7 seconds, but the test command exited 1 and the ten listed failures reported missing FFmpeg.

SetupN/ADependencies and the build completed, but no supported end-to-end media setup was reproduced; the listed failures could not find ffmpeg.
Docs4/5The visible five-point rubric awards 4 for documented entry paths, requirements, routing and troubleshooting with incomplete independent verification. The README covers these topics, but the installation routes were not verified.
CommunityN/AThe supplied issue establishes a user report and its opening date, but does not establish maintainer response times or support capacity.
MaturityN/AThe unsuccessful test command and incomplete media workflow do not establish operating stability or production reliability.

Who it’s for

Developers investigating recorded interface bugs with an agent that can run scripts.
Engineers reviewing tutorials or demonstrations with timestamped frames and captions.
Teams prepared to choose the execution host and processing engine before sharing recordings.

Who it’s NOT for

Claude Chat or Cowork users: the README explicitly excludes those surfaces.
Workflows that must preserve every subtle code edit: thumbnail deduplication can miss these changes.
Teams that prohibit sending video to Google and cannot enforce explicit local engine selection.
Users expecting skill installation to include FFmpeg: media tools are separate requirements.

Setup reality

Our sandbox installed claude-video in 7 seconds at commit 03ceb42 on November 8, 2026, recording 35 dependencies and 38 MB on disk. The build succeeded in 1 second. The test command exited 1 in 7 seconds: 195 passed, 10 failed and 44 collection/setup errors in the supplied 249-result summary. Pip-audit reported zero known vulnerabilities.

Watch documents Python 3.10+, FFmpeg/ffprobe and current yt-dlp for its local route. These programs have different Python requirements: current yt-dlp supports Python 3.11+ when run through Python; its standalone release binaries bundle their interpreter. A single Python 3.10 environment therefore does not satisfy both documented requirements. YouTube also needs a supported JavaScript runtime/EJS setup. Skill installation does not bundle these programs.

Local extraction can start without a transcription key. Gemini requires a Gemini key, and optional cloud speech backends require their own credentials. The listed test failures report an unavailable ffmpeg executable. The supplied tail does not explain the 44 errors, so installing FFmpeg alone is not a verified remedy. No repaired rerun or completed media workflow is recorded. The sandbox image label does not establish actual runtime versions, and the 38 MB measurement does not establish the footprint of an optional speech-model environment.

Installing claude-video's Python dependencies did not establish that its media workflow worked. Our test command failed, and the ten listed failures reported an unavailable FFmpeg executable. For developers considering Watch, the next useful check is whether the agent's execution environment has the required tools and can identify a known moment in a short recording.

Watch turns clips into timestamped evidence

The claude-video README calls the skill Watch and exposes it through /watch. Its documented local engine extracts frames and a transcript for an agent to inspect. Native captions come first, with optional speech transcription for videos without captions. Recorded interface bugs and technical demonstrations are plausible uses; our sandbox did not complete either task.

Frames and speech answer different questions. A transcript may preserve an explanation without showing the interface change it describes. Frames may show that change without preserving the speaker's qualification. Their availability also depends on the source and configuration: the README says a local file with speech fallback disabled will not produce a speech transcript. A visual summary should not invent the missing speech.

What happened when we ran it

Our sandbox installed claude-video in 7 seconds at commit 03ceb42 on November 8, 2026, recording 35 dependencies and 38 MB on disk. The build succeeded in 1 second. The test command exited 1 in 7 seconds: 195 passed, 10 failed and 44 collection/setup errors in the supplied 249-result summary.

The ten listed failures cover frame extraction, deduplication and audio operations. Nine report FileNotFoundError for ffmpeg; one reports that it cannot run FFmpeg because of that exception. The supplied tail does not show the causes of the 44 errors. It supports diagnosing an unavailable executable in the listed failures, but not attributing every error to it or predicting that the suite would pass after installation. No repaired rerun is recorded.

Pip-audit reported zero known vulnerabilities. That result does not establish the security of external media tools or remote services, or the accuracy of generated summaries. The recorded sandbox configuration had 3 CPUs, 8 GB of RAM and image label ghcr.io/astral-sh/uv:python3.12-bookworm. The label alone does not establish actual Python or operating-system versions. The scan found two CI workflow files and a tests directory, with no Dockerfile. No completed media workflow or video-summary accuracy measurement is supplied.

Check each program's requirements inside the agent session

Watch documents Python 3.10+, FFmpeg/ffprobe and current yt-dlp. Current yt-dlp supports Python 3.11+ when run through Python. Its standalone release binaries bundle their interpreter. Do not assume that one Python 3.10 environment satisfies both programs. YouTube also needs a supported JavaScript runtime/EJS setup.

Installing the skill supplies instructions and scripts, not these media programs. FFmpeg installed on a laptop is not thereby available inside a remote agent sandbox. Check dependencies where the agent executes its scripts.

The README explicitly excludes Claude Chat and Cowork. It directs Claude users to Claude Code and also documents Codex and other Agent Skills hosts. Our run did not verify those installation routes. For an initial trial, use a short local recording, choose the local engine explicitly and compare the resulting timestamps and visible claims with the original clip.

Choose where the recording goes

The README says auto selects Gemini when a Gemini key resolves and otherwise selects the local engine. Under Gemini, YouTube URLs go directly to Google; other URLs are downloaded, then uploaded like local files. The README documents deletion after the answer, but our run did not verify uploads, network traffic or deletion.

If sending video to Google is unacceptable, explicitly select --engine local. That choice still requires considering the execution host: local WhisperX runs wherever the agent executes its scripts, including a cloud host. Optional cloud transcription sends extracted audio to its selected provider. Choose the engine, transcription backend and execution host together.

Sampled frames can miss a subtle edit

The README gives balanced mode a default cap of 100 regular frames. It warns that scene changes do not capture every event and that thumbnail deduplication cannot preserve every code edit. It documents focused intervals, explicit timestamps and --no-dedup for closer inspection. These are documented controls, not accuracy results from our run.

Source access can also limit the evidence. Issue 268, opened on November 6, 2026, reports missing TikTok captions despite an available subtitle track. The reporter describes a local fix, but we did not reproduce the defect or verify that fix. GitHub's supplied metadata lists the last push as September 25, 2026, and release v0.3.2 on the same date. The issue's later opening does not establish a resolution or a support response time.

Choose a smaller component when it fits the job

yt-dlp is a command-line audio/video downloader. Choose it directly when downloaded media is the deliverable for an existing pipeline. Whisper provides speech recognition, speech translation and language identification. Choose it when spoken content is the task and you can provide the surrounding workflow. No speed or accuracy advantage between these options was measured here.

Documentation earns 4/5 under this rubric: 1 lacks a usable entry path; 2 gives an entry path without material requirements; 3 explains a path but leaves material setup or routing gaps; 4 documents entry paths, requirements, routing and troubleshooting while independent verification remains incomplete; 5 also requires verified instructions across the claimed routes. Watch's README supports 4 through its host restrictions, separate tool requirements, engine routing and troubleshooting. Our run did not verify its installation routes or complete a media workflow.

Setup ease, support quality and operating maturity remain unassessed. Before adopting Watch, use a clip whose important moment you already know and check whether the agent can point to it accurately.

Alternatives

ProjectWhat it isPick it when
yt-dlp gh↗A command-line audio/video downloader.Choose it directly when downloaded media is the deliverable for an existing pipeline.
Whisper gh↗Speech recognition, speech translation and language identification.Choose it when spoken content is the task and you can provide the surrounding workflow.

What people are saying

  1. [github-trending] bradautomates/claude-video

Sources

  1. Watch README
  2. yt-dlp README
  3. Whisper README
  4. Repository facts
  5. Latest release metadata
  6. Issue 268: TikTok caption discovery report

More ai tools reviews

nextai-translator · Toonflow-app · AutoRAG · MonkeyCode · grok-bot-templates · WorkDaddy · the whole board →