analyze-video

Analyze video files frame-by-frame to produce forensic timelines and flagged key moments.

6|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/jdrodriguez/legal-toolkit --skill analyze-video-jdrodriguez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-video
Source: https://github.com/jdrodriguez/legal-toolkit/tree/main/legal-toolkit/skills/analyze-video
Command: npx skills add https://github.com/jdrodriguez/legal-toolkit --skill analyze-video-jdrodriguez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg, ffprobe, and includes scripts (resource) components.

What problem does it solve?

Long-form video evidence (body cam, dashcam, surveillance, or phone recordings) is time-consuming to review manually and critical moments are easy to miss. This Skill automates local, frame-by-frame extraction and inspection, producing a precise timeline, chaptered summaries, and flagged key moments so investigators and attorneys can focus review on the most relevant segments.

Core Features & Use Cases

  • Multi-pass frame extraction: Scene-aware detection, coarse sweep, dense extraction around scene changes, and optional offset pass to maximize coverage.
  • Chaptered processing & metadata: Organizes frames into chapters with metadata.json containing timestamps, frame lists, and scene-change counts.
  • Forensic analysis outputs: Progressive chapter summaries, a full forensic_report.md, flagged key moments, individual tracking notes, and optional DOCX export via other skills.
  • Use Cases: Rapid review of body cam encounters to locate use-of-force moments, surveillance footage triage to identify entry/exit events, and production of admissible timelines for litigation.

Quick Start

Analyze the video file at /path/to/video.mp4 and produce a chaptered forensic timeline with flagged key moments and a saved forensic_report.md.

Frequently Asked Questions about analyze-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract key moments from body cam footage for legal evidence?

Forensic video analysis automates local frame-by-frame extraction from body cam footage to flag key moments and produce chaptered timelines. Scene-aware multi-pass processing organizes frames with timestamps and metadata, generating a forensic_report.md for evidentiary review.

Can I use ffmpeg for scene detection in surveillance video?

Yes, ffmpeg and ffprobe support scene detection in surveillance video through configurable scene-thresholds. Multi-pass extraction performs a coarse sweep followed by dense frame extraction around scene changes to identify entry and exit events while keeping all processing local.

What is scene-aware frame extraction and when do I need it?

Scene-aware frame extraction detects scene changes in evidentiary video and performs dense extraction around those transitions during multi-pass processing. It is needed when reviewing long-form surveillance or dashcam footage to locate critical events without manual scrubbing.

Does forensic video analysis work locally without uploading evidentiary footage?

Forensic video analysis keeps all processing local, ensuring evidentiary video never leaves your environment. It relies on ffmpeg and ffprobe installed locally to perform frame extraction, scene detection, and timeline generation on your own hardware without uploading footage.

What are the limitations of ffmpeg-based frame extraction for dashcam footage?

FFmpeg-based frame extraction depends on configurable fps, scene-threshold, and max-frames settings to balance coverage and output volume. Very high fps or low scene-thresholds on long dashcam footage can generate excessive frames and metadata, requiring careful parameter tuning to manage results.

How do I generate a forensic timeline from surveillance video for litigation?

To generate a forensic timeline, analyze surveillance video files frame-by-frame using scene-aware extraction with ffmpeg and ffprobe. The process outputs chaptered frames, metadata.json with timestamps, and a forensic_report.md containing flagged key moments for admissible litigation timelines.