trove-broll-ingest
Find the usable moments in raw footage, cut each one, grade it, and add it to a b-roll library. Use when a raw clip or a folder of raws needs selecting, grading, and cataloguing. Not for a talking-head script and not for a finished edit.
- License 许可
- MIT
- 所属仓库
- bravew/trove
- 最近更新
- 2026-11-12
- Stars
- ★ 10
- Forks
- 1
01 前言 Front Matter
- name
- trove-broll-ingest
- license
- MIT
- metadata
- { "inspired-by": "BuildLoop video skills", "trove-category": "designs-media", "trove-category-label": "Designs & media" }
- description
- Find the usable moments in raw footage, cut each one, grade it, and add it to a b-roll library. Use when a raw clip or a folder of raws needs selecting, grading, and cataloguing. Not for a talking-head script and not for a finished edit.
- when_to_use
- find the usable moments in this clip; ingest this footage into my b-roll library; grade and catalog this raw clip; pull the good shots out of this footage
- user-invocable
- true
02 资源文件 8
- 资产文件assets/luts/cinematic-rec709-soft.cube947.6 KB
- 资产文件assets/luts/cinematic-rec709.cube947.7 KB
- 资产文件assets/luts/cinematic-slog3-soft.cube947.6 KB
- 资产文件assets/luts/cinematic-slog3.cube947.6 KB
- 参考文档references/catalog.schema.json1.5 KB
- 参考文档references/selection-rules.md1.2 KB
- 脚本scripts/catalog.py3.3 KB
- 脚本scripts/shake.py2.5 KB
03 SKILL.md 正文
<!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly --> <!-- Regenerate: bun run build:skills -->
B-roll ingest
A raw clip becomes a handful of graded selects in a catalog, each one a moment
an edit can drop in. Cutting a talking-head script belongs to trove-take-cut.
Finishing an edit belongs to trove-video-edit.
The library root comes from the user. There is no default path. If they did not name one, ask, and do not create a library anywhere they did not point at.
Grade from the transfer, not from habit
Probe the clip with trove-ffmpeg's probe.py and read the transfer
characteristics before choosing a LUT. S-Log3 footage graded with a Rec.709 LUT
comes out flat and wrong, and the mistake is invisible until the shot sits next
to a correctly graded one.
| Probed transfer | LUT |
|---|---|
| Rec.709, BT.709 | assets/luts/cinematic-rec709.cube |
| S-Log3, S-Gamut3 | assets/luts/cinematic-slog3.cube |
| Anything else | Stop and ask. Do not guess a grade. |
Each has a -soft variant for a lighter grade. The user can pass their own
.cube, which overrides the choice entirely. Apply it with color.py --lut.
Workflow
Read references/runtime-spec.md in trove-ffmpeg before the first command.
Never write a raw ffmpeg command. The source clip is never modified.
-
Probe. Transfer characteristics decide the grade. Note the frame rate and duration for the cuts.
-
See the whole clip. Build a timestamped contact sheet with
look.pyand read every frame of it. For a clip where the action is easy to miss, build a second sheet over just that span. The sheet is how you find moments. Scene detection and the filename are not. -
Name the moments. Read selection-rules.md and write one sentence per select naming what happens and at what second. Most clips yield none to four. Show the list to the user before cutting.
-
Cut and grade.
cut.py --accuratefor the span, thencolor.py --lutwith the LUT chosen above. Exposure or white balance problems getcolor.py --correctbefore the grade, not instead of it. Name the file<category>_<moment>_<source>.mp4inside the library. -
Check the opening frame. Extract the first frame with
look.py --atand look at it. If it shows anything other than the action already happening, the span starts too early. Re-cut. -
Shake, only when it helps. Run
scripts/shake.pyon a shot that looks unsteady. Stabilize a locked shot throughtrove-ffmpeg, score the result, and keep it only when the score dropped. Never stabilize a pan, tilt, or any move the camera made on purpose. Record the decision either way. -
Catalog. Append the select with
scripts/catalog.py, pointing--libraryat the root the user named. The entry matches catalog.schema.json.
The LUTs
The four .cube files under assets/luts/ are a cinematic grade carried over
from the BuildLoop video skills, kept byte for byte and renamed. They are a
starting grade, not a house look. A project with its own grade should pass it.
04 同仓库更多 Skills
using-trove
Skill discipline anchor for the Trove marketplace. Loaded once per session; routes the agent to the right trove-* skill before code, planning, review, or git actions.
trove-write-skill
Skill authoring workflow. Use when creating or updating a Codex or Trove skill, including rubrics, tasks, metadata, and validation.
trove-worktree
Git worktree workflow for spikes, risky experiments, and broad refactors that should not disturb the user's current branch.
trove-why
Reconstruct design rationale and decision history from evidence — source control, issue tracker (Linear), docs (Notion), chat (Slack), error tracking (Sentry) — with calibrated confidence. Use for "why does X work this way", "why did we pick Y", regressions, and postmortems. Use trove-explain for how it works now.
trove-verify
Completion verification workflow. Use before claiming done, fixed, complete, ready, or shipped.
trove-unslop
Cut AI tells from writing — PR descriptions, release notes, specs, commit bodies, and replies. Use before finalizing prose, or when the user asks to clean up, de-slop, or make text sound human.