Skip to content

gooseworks-ai/goose-skills / skills/video/video-production-harness

video-production-harness

Verified

Full video production sequence with script review, actual ingredient choices, controlled generation, editing, evidence-based quality review, polish, captions and delivery. A host binding supplies project storage, authentic approvals, provider access and billing.

FileKindSize
SKILL.mdskill md6.0 KB
auto-fix-from-review-notes.mdmarkdown6.5 KB
auto-refine.mdmarkdown5.3 KB
brainstorm.mdmarkdown3.2 KB
capabilities.mdmarkdown13.6 KB
create-clips.mdmarkdown15.0 KB
create-design-brief.mdmarkdown13.4 KB
create-storyboard.mdmarkdown8.8 KB
edit-clip.mdmarkdown6.4 KB
edit-video.mdmarkdown12.8 KB
lock-character.mdmarkdown12.2 KB
lock-script.mdmarkdown8.7 KB
orchestrator.mdmarkdown10.9 KB
polish.mdmarkdown9.2 KB
preflight-audit.mdmarkdown6.2 KB
promote.mdmarkdown3.2 KB
references/check-severity.mdmarkdown9.7 KB
references/creative-contract-and-review.mdmarkdown11.4 KB
references/creator-grammar.mdmarkdown6.7 KB
references/editorial-review.mdmarkdown6.4 KB
references/genres/ai-creator-ugc.mdmarkdown2.7 KB
references/genres/chat-ui.mdmarkdown2.2 KB
references/genres/hypermotion.mdmarkdown1.4 KB
references/genres/motion-graphics.mdmarkdown1.5 KB
references/genres/narrator-montage.mdmarkdown3.1 KB
references/genres/product-demo.mdmarkdown2.0 KB
references/hook-compatibility.mdmarkdown2.8 KB
references/libraries-look-and-rubric.mdmarkdown6.0 KB
references/product-scale-and-world.mdmarkdown4.2 KB
references/quality-tier.mdmarkdown9.4 KB
references/recipe-format.mdmarkdown7.1 KB
references/review-script-shortform.mdmarkdown11.7 KB
references/shot-routing.mdmarkdown14.9 KB
references/specialist-handoff.mdmarkdown4.7 KB
references/speech-and-route-qualification.mdmarkdown10.1 KB
references/talking-actor.mdmarkdown6.6 KB
release.jsonconfig22.1 KB
review-video.mdmarkdown15.0 KB
scripts/assemble.pyscript11.1 KB
scripts/assemble_sources.pyscript5.7 KB
scripts/assembly_timeline.pyscript11.4 KB
scripts/check_recipe.pyscript9.6 KB
scripts/final_grade.pyscript2.9 KB
scripts/final_measure.pyscript14.1 KB
scripts/final_measure_parts.pyscript14.6 KB
scripts/pack_recipe.pyscript11.3 KB
scripts/qc_evidence.pyscript15.0 KB
scripts/reference_rate.pyscript4.3 KB
scripts/reference_shots.pyscript13.1 KB
scripts/timeline_rules.pyscript10.8 KB
skill.meta.jsonconfig820 B
states/edit-to-delivery.mdmarkdown8.2 KB
states/setup-and-script.mdmarkdown10.8 KB
states/storyboard-and-clips.mdmarkdown8.1 KB
wrap-session.mdmarkdown5.9 KB

edit-clip.md

View on GitHub
---
name: video-production-harness/edit-clip
description: Re-generate or modify a single scene clip — keyframe swap, motion re-roll, post-effects, comp swap, or VO re-render — without disturbing the rest of the video.
---

# Human version

Revise one scene from the exact reviewed version while preserving good work. Record timing and approval consequences and review the replacement in context.

---

# Agent version

Follow the [orchestrator](orchestrator.md)'s host contract and [creative contract and review](references/creative-contract-and-review.md). Read [the editorial review guide](references/editorial-review.md) for source binding, note disposition, impact checks and edit history.

## Purpose

Fix one scene after `create-clips` (wrong pose, weak motion, off-tone voice) without re-running the pipeline. Write a labeled scene candidate and update `clip_review` through the binding. Keep the original bytes and provenance; the accepted cut and the note's source keep their identities.

## Inputs

- `<video_folder>` and `<scene_index>` (e.g. `5` or `09`)
- `<edit_type>`, one of:
  - `regenerate-keyframe`: new image, revised prompt
  - `re-roll-motion`: same keyframe, new motion prompt
  - `swap-keyframe-and-animate`: new image and new motion
  - `add-post-effect`: an FFmpeg pass (vignette, grade, crop, overlay)
  - `re-render-vo`: different line delivery or voice settings
  - `replace-clip`: a user-provided MP4
- The new prompt or asset the edit needs

## Workflow

### Common prep
1. Read `design_brief`, the saved sources and the note on its exact reviewed version. Resolve the stable scene id, retained takes and intended viewer effect. Never pick a scene from the latest master by filename.
2. Archive the current asset to `<video_folder>/_archive/scene-NN_<timestamp>.mp4` (or `.mp3`) before overwriting.
3. Read the scene's `<output>.meta.json` for its `gateway` and routing row. **Re-roll on the same routing row and gateway** to avoid drift; switch only when the operator says so, and log it.
4. Record the impact row from the editorial review guide. A changed line, delivery or pause can move picture holds, word timings, captions, transitions, music, CTA, approvals and derivatives. Keep unaffected media. A matching duration does not prove dependent timings still hold.

### Per edit type

**regenerate-keyframe**
1. Write a prompt that fixes the issue ("less dark", "red shirt clearer", "wider"). Keep the style descriptor block and the verbatim `<character_descriptors>`.
2. Submit on the scene's row in [the shot-routing guide](references/shot-routing.md). On a detected failure, reconcile the job and use only a supported fallback row inside the approved budget (same rules as `create-clips`).
3. Save `generated/keyframes/scene-NN.png`, then animate it as in re-roll-motion.

**re-roll-motion**
1. Use the existing keyframe as the start image.
2. Write a motion prompt stressing the action that did not land.
3. Submit on the same routing row and model; save `clips/scene-NN.mp4`.
4. Run the clip check as in `create-clips`: redo only a `must_fix` (or a fix that was chosen), paid as [check severity](references/check-severity.md) says; another redo after that is the customer's call.

**swap-keyframe-and-animate**: regenerate-keyframe, then re-roll-motion on the new image.

**add-post-effect**
- Vignette: `ffmpeg -i in.mp4 -vf "vignette=PI/4" out.mp4`.
- **No retiming.** Never speed up, slow down or extend a clip to fit a slot (no `speed_overrides`, no tpad or loop holds; only the timeline's declared end-card freeze). Speaking picture and its driver stay on one clock. A clip of the wrong length is re-rolled or re-performed.
- Crop or reframe keeps the aspect ratio and the identity, product, action and proof over the whole interval. Never zoom past 1.5× over the fit. On a source below the output's resolution (lip-sync's 720p) the crop multiplies with that upscale: crop in at most 1.1×. Never widen a face or hide wrong geometry or packaging.
- Overlays (logo, product photo, screenshot) use FFmpeg overlay of the real asset.

**re-render-vo**
1. Reuse the selected voice and settings. A new voice (still paired with its character) or a changed spoken line needs renewed script or ingredient approval first.
2. Change settings only when the repair needs it. Validate fields and ranges against the real model schema.
3. Submit the locked line through the host's managed voice capability. A verified direct ElevenLabs route may use `/v1/text-to-speech/{voice_id}`; a managed host never bypasses its billed operation with direct credentials.
4. Save the decoded file's identity and measured timing. Listen to pronunciation, delivery, joins and endings; if you cannot listen, record `measured` with transcript evidence. Measure its pace as create-clips Phase 4 says. When the driver changes, regenerate the lip-synced picture for that line.

**replace-clip**
1. Copy the user's MP4 to `clips/scene-NN.mp4`.
2. If ratio or codec differ: `ffmpeg -i in.mp4 -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -pix_fmt yuv420p clips/scene-NN.mp4`.

### Update preview
Save the new asset, job, provenance and clip check through the binding. Show the changed media on the host review surface and invalidate only affected approvals. Compare the scene with its neighbours in the new master, then review the whole output. Link "changed" and "verified" separately to the original note; a successful render does not resolve feedback by itself.

## Output

- Updated `<video_folder>/clips/scene-NN.mp4` and/or `audio/vo-scene-NN.mp3`
- The previous version under `<video_folder>/_archive/`
- Updated `clip_review` card copy when needed

## Quality checks

- The new clip matches the approved ratio and target duration ± 0.5 s, or an approved timeline change.
- The person and style match neighbouring scenes.
- Voice audio decodes, uses the selected voice and matches the locked line.
- The host review surface shows the replacement and the preserved prior version.
- The new `.meta.json` `gateway` matches the original, or the switch is logged.

## Failure modes

- A new keyframe drifts from the established person; compare with earlier scenes.
- Veo keeps failing on dark plates: fix the keyframe, then escalate to another routing row (Seedance 2.0 for product-only motion, H3 stills mode for creator B-roll) instead of retrying the same prompt.
- ElevenLabs concurrency errors: one voice re-render at a time.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 323kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 323kUpdated Claude CodeCodexVerifiedInstall