Agentic Video Editing

Primitive-First Workflow

ScreenKite keeps agentic editing simple: the app exposes deterministic editing primitives, and your agent owns planning, transcript reasoning, and editorial policy.

Recommended Loop

1. Read getProjectState(scope: "summary"), getProjectState(scope: "layout"), and getProjectResources().
2. Export a transcript when timing matters, then plan beats before changing the timeline.
3. Run setCanvas(..., dryRun: true) before aspect changes and setSceneLayout(..., dryRun: true) before non-trivial layout work.
4. Apply timeline edits with editTimeline, layout changes with setSceneLayout, and effect passes with manageEffects.
5. Export shorts or alternate aspect ratios with exportArtifact(type: "range", settings.canvasOverride) instead of mutating the long-form project.
6. Verify with getProjectState(scope: "visual") or snapshot exports after each mutation batch.

When to Use Each Primitive

• editTimeline for cuts, trims, and word-boundary cleanup
• setSceneLayout for time-scoped composition changes, including advanced layout DSL
• manageEffects for captions, zoom, and other effect passes
• vfxExportVideoSegment plus vfxOverlayProcessedClip for external render round-trips
• exportArtifact for delivery files, snapshots, SRT, and range exports

Guardrails

• Never cut mid-word. Use transcript word boundaries whenever speech timing matters.
• Re-read project state before retrying a mutating call after a timeout.
• Match overlay renders to the target width, height, fps, and frame duration before placing them back into the timeline.
• Cap self-evaluation loops. If visual checks still fail after a few passes, stop and inspect the layout or source media directly.