---
name: Verification
slug: verification
category: Quality
description: Provides a structured verification process to confirm that AI agent edits are correctly reflected in the OpenChatCut video editor, using static checks, agent runs, and visual proof.
github: "https://github.com/0xsline/OpenChatCut/tree/main/src/agent/skills/verification"
language: TypeScript
stars: 837
forks: 109
install: "git clone https://github.com/0xsline/OpenChatCut"
added: 2026-08-06T07:41:54.023Z
last_synced: 2026-08-06T07:41:54.023Z
canonical_url: "https://dirskills.com/skills/verification"
---

# Verification

Provides a structured verification process to confirm that AI agent edits are correctly reflected in the OpenChatCut video editor, using static checks, agent runs, and visual proof.

**Install:** `git clone https://github.com/0xsline/OpenChatCut`

## README

# Verification

Use the lowest verification level that proves the requested result:

| Level | Required evidence |
|---|---|
| L0 | Static checks such as the focused verification script, `npx tsc --noEmit`, tests, and build. |
| L1 | A real Agent run against the editor at `localhost:5199`, followed by structural and rendered evidence. |
| L2 | The packaged desktop app completing the user scenario, including human visual review where automation is insufficient. |

Runtime behavior changes require L0 + L1. Release and desktop-only changes also
require L2 when the packaged app is the behavior under test.

Prefer two signals:

1. `read_project` for structure: assets, tracks, items, frame placement, timeline duration.
2. A visual capture path for rendered evidence at exact frames.

Use `view_timeline_frames` for composed timeline proof. This verifies the edited OpenChatCut timeline: trims, layers, captions, effects,
markers, placeholders, crops, transitions, and layout.

For raw source-asset frame inspection, choose the cheapest path based on where
the bytes live:

- The agent in this build has no local filesystem access; all source bytes live
  in the project media store (`/media/uploads/`). Use `view_asset_frames` with
  the project asset id — the server takes an ffmpeg contact-sheet fast path
  automatically, so it is already the cheapest source-frame route.
- `view_timeline_frames` renders the composed timeline (the editor-truth check);
  `view_asset_frames` samples raw source frames. Pick by what you are verifying.
- There is no separate `get_contact_sheet` tool in this build — the contact
  sheet is what `view_asset_frames` / `view_timeline_frames` already return.

Use local/remote source-frame artifacts only for source understanding, moment
selection, and rough trim decisions, not as edited output or timeline proof.

For local-only or upload-in-progress media, composed timeline proof may be
blocked until the asset has bytes available to the renderer. Source-frame
inspection via `view_asset_frames` still works as long as the asset's bytes are
on disk (`/media/uploads/`).

If both visual proof paths are blocked, ask the user to inspect the OpenChatCut
editor directly and note the blocker explicitly.

Useful checks:

- After import: `read_project({ "view": "assets", "assetId": "<prefix>" })`
- After move/trim: `read_project({ "view": "timeline" })`
- After visual overlay or MG on any timeline media: `view_timeline_frames({ "frames": [30, 45, 75] })`, then look at the returned frames.
- For user-requested source selection or visual moment picking: sample stills with `view_asset_frames` and inspect them. Use that only to choose source files, moments, and rough trims. Build the visible edit as OpenChatCut timeline items. Do not treat raw source inspection as timeline verification or as permission to produce the edited video elsewhere.
- For source-frame inspection: call `view_asset_frames({"assetId":"...","sourceTimesMs":[...]})` after `read_project({"view":"assets"})` confirms the asset id/type. Prefer this over asking the user to reattach the file.
- For local-only visual verification: upload/register cloud-readable media before relying on connector visual proof.
- For no-source validation: confirm the tool manifest exposed the parameters you used, then record the visible proof in the trace log.

When talking about seconds, verify the fps from `read_project` or use adapter tools that resolve fps internally.

When reporting a timeline item location, use only the latest `read_project` structure for track alias, item id, start, duration, and asset id. Do not report planned/default tracks or tool-call intent as verified placement.

Do not treat a command-line JSON response alone as sufficient when the user asks whether the editor reflects the result. Use the editor URL or visual proof when practical.

## Real Agent transcript check

After every L1 Agent run, inspect the complete chat record before reporting
success:

1. Read the final assistant response and every tool row created by the run.
2. Expand failed or warning rows and record the exact error.
3. Check for aborted turns, repeated retries, stale proposals, incomplete jobs,
   and tool results that the final response incorrectly describes as successful.
4. Compare the latest `read_project` result with the visible timeline.
5. For visual edits, inspect returned timeline frames rather than trusting the
   assistant summary.

A run with a correct-looking timeline but an unreported tool error is not a
clean pass. Fix the cause or report the remaining error explicitly.

If verification fails, classify the gap before changing tools:

- tool description or schema was insufficient
- skill instructions were missing a step
- `read_project` did not expose enough state
- editor authorization did not complete
- media/transcription pipeline failed
- cloud render/editor observation was blocked