Menu
Run a vflow local-first video workflow from project setup through NLE roundtrip while preserving canonical JSON contracts.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | vflow-video-workflow |
| description | Run a vflow local-first video workflow from project setup through NLE roundtrip while preserving canonical JSON contracts. |
Inspect capabilities and command vocabulary:
vflow doctor --format json --format-error json
vflow schema --validate --format json --format-error json
Initialize or inspect the project:
vflow project init --path <project> --id <id> --commit --format json
or vflow project get --project <project> --format json.
Probe media before rendering:
vflow media probe --project <project> --commit --format json.
Import transcripts into transcript/words.json:
vflow transcript import --project <project> --provider plain-text --input <file> --commit --format json.
Apply reviewed cleanup decisions:
vflow cleanup apply --project <project> --input <delete_segments.json> --commit --format json.
Calibrate or import human-approved framing presets:
vflow framing calibrate --project <project> --source media/source.mp4 --open=false --wait=false --format json --format-error json.
If a reviewed preset artifact already exists, use vflow framing preset import --project <project> --input <framing-presets.json> --commit --format json.
Compile frame-anchored framing and timeline artifacts:
vflow framing compile --project <project> --commit --format json.
vflow timeline compile --project <project> --commit --format json.
Render a preview only from copied/local project media:
vflow render preview --project <project> --commit --format json.
Run QA/color provider calls only with runtime secrets:
vflow qa analyze --project <project> --provider gemini --live --commit --format json.
Export to NLE with sidecar:
vflow nle export --project <project> --target fcpxml --commit --format json.
Canonical artifacts live in JSON. NLE files, Gemini reports, ffmpeg previews, and color notes are adapters or reports, not the source of truth.
Useful aliases:
framing crop, framing zoom, and framing reframe start the same managed calibration UI as framing calibrate.transcript stt and transcript transcribe map to transcript creation.media inspect-media maps to media probing.timeline build-timeline maps to timeline compilation.render qa-render maps to render verification.nle to-nle, nle from-nle, and nle compare-nle map to NLE export/import/diff.Do not use vflow to invent crop boxes, store secrets, bypass --commit, or treat NLE project files as canonical state.