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

auto-refine.md

View on GitHub
---
name: video-production-harness/auto-refine
description: Bounded check → fix → re-check loop (at most 3 iterations) that repairs only machine-checkable defects in a candidate cut, using review-video's structured check list, edit-clip and edit-video. Subjective and story calls are escalated, never repaired by the loop.
---

# Human version

Repair verified objective defects inside the approved scope and budget, at most three times. A changed file is not a verified improvement.

---

# Agent version

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

## Purpose and scope

The loop fixes objective misses from the structured check list in [review-video.md](review-video.md): character drift, grade mismatch, clipping, static stretches, missing brand assets, runtime drift. It makes no creative calls. A story, concept or emotional problem is escalated with its return route. An objective-clean exit never approves the cut; review-video still decides the stage.

## Inputs

- `<video_folder>` (required); `<video_path>` (default `<video_folder>/edits/master-final.mp4`).
- `<max_iterations>`: default 3, hard cap 3.
- `<budget_credits>`: an optional ceiling inside the host-approved remaining budget, never a new grant.

## Dispositions

Each check in the list declares one:

- `auto-fixable`: an exact supported repair through [edit-clip.md](edit-clip.md) or [edit-video.md](edit-video.md), with no paid generation (for example a VO peak fixed by an edit-video mix gain).
- `auto-fixable-with-budget`: the same, but it spends credits (for example a re-roll with the locked anchor). Run it only with the host's current approval and within both the host's remaining budget and the local ceiling.
- `escalate`: needs human judgment. Report it; do not act.

An unclear disposition is `escalate`.

## Loop

1. **Start.** Archive the input as `edits/_iterations/master-iter-0.mp4` and create `edits/_iterations/auto-refine-log.json` (`started`, `max_iterations`, `budget_credits`, `credits_spent`, `iterations`).
2. **Check.** Run `scripts/qc_evidence.py` on the candidate (fix a broken file first; its other findings are graded below), review the whole cut with sound when your tools can (`listened`/`watched`, else `measured`), and save review-video's check list as `edits/_iterations/iter-N-checks.json`.
3. **Partition** into objective misses (`machine_check` true and failed), subjective misses, incomplete and passed. Missing required evidence is incomplete, never a pass. Bind each finding to its original cut.
4. **Exit** when any holds:
   - incomplete is not empty: name the missing capability; no pass is inferred;
   - no objective misses: exit objective-clean, run the stage diagnosis and keep open story findings (do not promote or call it APPROVED while a `must_fix` remains open);
   - the iteration cap is reached;
   - `credits_spent` plus the projected cost exceeds the budget;
   - the same check failed in this and the previous iteration with the same fix (convergence): escalate.
5. **Plan.** Sort by [check severity](references/check-severity.md) (`must_fix` before `ask`; `fine` is never fixed), then by cost. An `ask` fix that costs credits runs only when the customer chose it, or in `review_mode: auto`. A paid fix comes out of the approved total when it fits, otherwise it waits for a new yes. Group fixes on one asset: all level issues in one edit-video mix pass, all colour matches in one grade pass. Per-scene re-rolls run one at a time through edit-clip.
6. **Execute.** Recheck paid authorization and budget before any submission; log debits and each repair in the log.
7. **Rebuild.** Re-assemble a new labeled candidate with `scripts/assemble.py` from the same `assembly_timeline`, refresh timings, captions, sound and evidence, then re-check the whole new output for the intended effects, not just command success.
8. **Archive** the new candidate as `edits/_iterations/master-iter-N.mp4` and loop.

## Report

Write `<video_folder>/edits/_iterations/auto-refine-report.md`: iterations, exit reason (objective-clean, cap, budget, convergence or incomplete-evidence), the separate stage verdict, credits against budget, each check's severity and status, subjective issues left for the owner, and each iteration's change and cost. Save a summary on the host review surface.

## Output

- A new labeled candidate recorded through the binding; the selected final and source notes stay unchanged until selection ([promote.md](promote.md)).
- `<video_folder>/edits/_iterations/`: masters, check lists, log, report.

## Quality checks and failure modes

- Never more than 3 iterations; each archives its candidate and logs credits and the exact call.
- The convergence guard is mandatory: the same check failing twice with the same fix ends the loop.
- Subjective misses are reported, never fixed silently; never invent an `auto-fixable` mapping for one.
- A new defect can invalidate dependent evidence but never grants creative or paid authority; keep unrelated approvals and renew only the affected one.
- The final candidate's runtime matches the plan within 0.5 s.
- It never calls itself; it calls only review-video, edit-clip and edit-video.
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