video-evidence-review

Video Evidence Review Skill

When to Use

Use this skill to analyze recordings without blowing up context:

• Long interaction captures (over 30 seconds)
• Locating a specific event inside a long recording
• Building storyboards of multi-step flows
• Verifying what happened during an automated session

Core Principle

A recording is an INDEXABLE DATASET, not one giant prompt. Never feed an entire recording through review at once - chunk it, index it, then zoom in selectively.

Instructions

Step 1 - Chunking

Split the recording into 30-120 second windows:

• Fixed-size chunks are fine for uniform captures
• Prefer natural boundaries (navigations, idle gaps) when known
• Assign stable IDs: chunk-001, chunk-002, ...

Step 2 - Three Review Levels

Escalate detail only where it pays off:

1. Thumbnail index (always): one frame per chunk → cheap map of where things happen
2. Selected frames: pull individual frames only from relevant chunks
3. Full clip replay: ONLY for ambiguous or high-value events

If pass 1 (thumbnail index) finds nothing relevant, NEVER escalate to reviewing the whole recording - report "no relevant events found" and stop.

Frame Selection Policy

When sampling frames inside a chunk:

• Static interval (no visual change): keep ONE frame for the stretch
• Scene change (cut, navigation, modal): keep three frames - just BEFORE the cut, AT the cut, and one AFTER things stabilize
• Fast motion: sample densely around that window only, sparsely elsewhere

Storyboard Concept

Assemble reviewed frames into a storyboard artifact:

• Ordered keyframes carrying chunk ID + timestamp
• One-line caption per frame describing state/action
• The storyboard doubles as a shareable summary and an index back into the raw recording

Output

{
  "recording": "clips/checkout-flow.webm",
  "chunks": [
    { "id": "chunk-003", "window": "60-150s", "relevant": true },
    { "id": "chunk-004", "window": "150-210s", "relevant": false }
  ],
  "keyframes": [
    {
      "chunkId": "chunk-003",
      "timestamp": "96.5s",
      "reason": "scene-change",
      "caption": "Payment modal opens after Pay click"
    }
  ],
  "conclusion": "Checkout succeeds; one transient error toast at 148s self-clears."
}