review-bundle

name	review-bundle
description	Review a local video artifact bundle, summarize report status across known artifacts, and point the agent at the first useful review surfaces.

Review Bundle

Use this when a repo already produced a run and the agent needs the shared review layer rather than repo-specific generation logic.

This skill does not replace domain-specific QA. It tells the agent:

• what artifacts exist
• which reports passed, warned, or failed
• which surfaces deserve immediate human or agent attention

Inputs

Use the same bundle locators as video-artifact-intake, plus optional prompt hints:

{
  "outputDir": "./output/example-run",
  "includePromptHints": true
}

includePromptHints defaults to true. Set it to false when you only need a machine-readable bundle/status summary.

Outputs

The result includes the normalized intake result plus a review-oriented summary of artifact availability, report status, recommended focus, and optional prompt hints. It does not open or deeply evaluate every report.

Sequencing Guidance

Run video-artifact-intake first only if path resolution is ambiguous; otherwise review-bundle can do intake itself. If the review identifies storyboard files, inspect them directly or continue with storyboard-transitions/storyboard-understand. If storyboard files are absent and a primary video exists, generate them with storyboard-extract and storyboard-ocr.

Interpretation Notes

Treat fail or warn as routing signals to inspect the named artifact, not as complete diagnostics. Treat unknown as insufficient structured evidence. A present trace.zip means failure evidence may exist outside JSON and should be unpacked or inspected if relevant to the task.

Abstention Rules

Do not claim the video is correct because overallStatus is pass; the skill only summarizes known reports. Abstain from visual, caption, or UX judgments unless the result points to concrete artifacts you inspect.

Failure Modes

If the run directory is wrong, the review will faithfully summarize the wrong bundle. If reports use custom schemas without status, passed, or hasFailures, they may appear only as present; read them manually before concluding they passed.

Repo-side runner:

node --import tsx scripts/harness/review-bundle.ts

Installed-pack runner:

node ./.video-evaluator/agent/run-tool.mjs review-bundle