cueframe 0.4.10 → 0.7.0

package/dist/skills/add-music-bed/SKILL.md

@@ -5,6 +5,14 @@ description: Retrofits a music bed (and ambience or SFX) onto an existing compos
 
 # Add a music bed
 
+## Scope and capability policy
+
+User intent and acceptance criteria override this recipe's aesthetic defaults. Silent, typography-only, uncaptioned and slow work are valid; no universal narration, footage, CTA, beat count or score target. Contracts, factual fidelity, media bindings and current source revisions remain mandatory.
+
+Read available tools and current project; preserve the chosen local/hosted lane. Supported local work needs no hosted registration. Do not silently install, authenticate, switch projects or upload local content. Before metered hosted work, check `get_account`, entitlements, balance and quotes. Desktop setup: https://docs.cueframe.ai.
+
+For scoped revisions, preserve unrelated timing, media, audio and shared brand-kit state. Edit affected content; inspect relevant frames, continuous motion and affected audio. No restarted intake, new approval pause, paid judge or final export by default. Judge only when useful; scores never override acceptance failures. Stop/report after two no-improvement passes. See [preview workflow](../cueframe-compose-loop/references/preview-workflow.md).
+
 > **Stock-audio limits (verified in production):** a Freesound import lands with
 > `audioRole:"sfx"` and NO beat grid — `import_resource` takes no audioRole param, and
 > `materializeGrid grid:"beat"` will 422 `grid_unavailable` on it. Set the role yourself when
@@ -12,7 +20,6 @@ description: Retrofits a music bed (and ambience or SFX) onto an existing compos
 > track (the judge expects a dedicated music track), and until curated music-pack discovery
 > exists, prefer fades over beat-cuts for stock beds — beat-grid cutting works with pack beds.
 
-
 You point at an existing composition that sounds empty; you get it back with a licensed bed that
 matches the brand's mood, sits correctly under any speech, and — where the bed drives pacing —
 cuts moved onto its beat grid. Attribution included, levels disciplined, one re-render.
@@ -66,9 +73,7 @@ delivery; stills and a visual judge cannot establish the mix. Recheck visuals wh
 6. **Restraint is the discipline.** A few placed sounds read; a wall of them merges into mush.
    The biggest moment gets the strongest accent ONCE. And silence stays a device — clean air
    before the first hit, a dropout before the biggest beat, is worth more than any riser.
-7. **Verify, judge, re-render.** `preview_frame` the key beats to confirm nothing visual
-   regressed; `score_composition` to confirm the piece improved (worst-first if not, ≥ 7.5 to
-   ship); then `create_render` → `wait_job (kind:"render")` — one render, on approval.
+7. **Listen and verify the affected window.** Check intelligibility, ducking, fades and synchronization in a motion/audio preview; stills alone cannot verify a music change. Preserve existing cut timing unless retiming was requested. Broader judging is optional and budgeted; export only for requested final delivery.
 
 If, after listening, the right call is NO bed — a raw testimonial, a piece whose room tone is
 the point — that is a legitimate outcome of this skill: record the intentional-silence decision
@@ -79,13 +84,13 @@ and its reason in the delivery note instead of forcing a bed.
 Quoted from `video-craft-standards` (cross-cutting rules — every artifact); this skill exists to
 satisfy the second one:
 
-> **MUST** Audio is decided, never defaulted: a music bed (curated packs via
+> **DEFAULT** Audio is decided, never defaulted: a music bed (curated packs via
 > `import_resource {kind:"music-pack"}`) or ambience/loops (Freesound via
 > `search_resources kind:"sfx"`), honoring the brand kit's `musicMood`; cut to the beat via
 > `materializeGrid` when the bed drives pacing — OR an explicit intentional-silence decision
-> recorded in your delivery note with the reason. **K:** a render whose silence nobody chose.
+> recorded in your delivery note with the reason. **Consider:** a render whose silence nobody chose.
 
-> **MUST** Every stock asset's provenance is recorded (provider, id, author).
+> **DEFAULT** Every stock asset's provenance is recorded (provider, id, author).
 
 And from §1: *"**SHOULD** Cuts land on the music grid when a bed exists."*
 

package/dist/skills/brand-reel/SKILL.md

@@ -5,6 +5,14 @@ description: Produces a 12–20 second 9:16 brand-identity reel — three-beat a
 
 # Brand reel
 
+## Scope and capability policy
+
+User intent and acceptance criteria override this recipe's aesthetic defaults. Silent, typography-only, uncaptioned and slow work are valid; no universal narration, footage, CTA, beat count or score target. Contracts, factual fidelity, media bindings and current source revisions remain mandatory.
+
+Read available tools and current project; preserve the chosen local/hosted lane. Supported local work needs no hosted registration. Do not silently install, authenticate, switch projects or upload local content. Before metered hosted work, check `get_account`, entitlements, balance and quotes. Desktop setup: https://docs.cueframe.ai.
+
+For scoped revisions, preserve unrelated timing, media, audio and shared brand-kit state. Edit affected content; inspect relevant frames, continuous motion and affected audio. No restarted intake, new approval pause, paid judge or final export by default. Judge only when useful; scores never override acceptance failures. Stop/report after two no-improvement passes. See [preview workflow](../cueframe-compose-loop/references/preview-workflow.md).
+
 You bring a brand (a website, a kit, or just a logo and a palette) plus footage of its world;
 you get back a 12–20 second vertical reel with a three-beat arc — wordmark moment, craft/proof
 beat, tagline lockup — where every graphic could belong to this brand and no other.
@@ -23,8 +31,7 @@ this job.
 - **The brand** (required): a brand kit on the project, a website to `extract_brand_kit` from,
   or explicit colors + fonts + wordmark. Extraction gets colors/fonts only — ask for the tagline
   and voice.
-- **Footage of the brand's world** (required): product, workshop, hands, city — the craft beat
-  needs a real subject. Ask before defaulting to stock.
+- **Leading material:** brand typography, abstract motion, product, workshop, hands or city as requested. Footage is optional for a silent typography study; do not demand it or default to stock.
 - **Tone**: default premium-calm unless the brand's voice says otherwise.
 
 ## Workflow
@@ -33,13 +40,10 @@ Use `cueframe-compose-loop`'s [preview workflow](../cueframe-compose-loop/refere
 for stills and motion windows. For a small revision, preserve the approved arc and inspect the
 affected behavior and regressions; reserve full-film judging and export for the relevant review/delivery.
 
-
 0. **Find the claim (before anything else).** Interrogate the brand/material
    for its tension — what it believes that its category doesn't — and write
    the claim in one sentence. Derive the shot list, the bed's mood/tempo, the
-   pacing, and every card's copy FROM that sentence. If you cannot state the
-   claim, you are not ready to compose (video-craft-standards: the
-   controlling idea is kill-level).
+   pacing, and every card's copy FROM that sentence. For a visual identity study, the desired visual experience can be the intent; no factual claim is required.
 
 1. **Pin the brand as engine state.** `extract_brand_kit` from their site or `create_brand_kit`
    from what they gave you; set `brandKitId` on the project. Show the kit and let them override
@@ -49,7 +53,7 @@ affected behavior and regressions; reserve full-film judging and export for the
 2. **Import the world.** `import_media` their footage; `get_media_context` for what's actually
    in it. Choose footage that lives in the palette — or plan a `color-grade` toward it. Footage
    color and brand palette must agree.
-3. **Plan the three beats.** Opening brand moment (a wordmark treatment, not a logo dump) →
+3. **Plan the requested arc.** A three-beat example: Opening brand moment (a wordmark treatment, not a logo dump) →
    middle craft/proof beat (the subject's world plus one editorial device: a numbered chapter, a
    pull-quote, a stat with a source) → closing tagline lockup. Write one line of intent per beat
    before authoring.
@@ -60,13 +64,13 @@ affected behavior and regressions; reserve full-film judging and export for the
    the card, then shell it with `applyMotionPreset` in a FOLLOWING `apply_composition` call. The
    test: if another brand's hex swapped in would still look correct, the layout isn't bespoke
    enough — redo it.
-6. **Decide the audio — required.** `search_resources` for a bed honoring the kit's
+6. **Honor the audio decision.** If silence was requested, preserve it without searching for a bed. Otherwise, when music serves the plan: `search_resources` for a bed honoring the kit's
    `musicMood`; place it `audioRole:"music"`, then `materializeGrid { grid:"beat" }` and land
    the three beat boundaries on the grid. A brand reel almost always wants a bed; if the brand's
-   voice truly calls for silence, record that decision and the reason in the delivery note.
+   voice calls for silence, preserve that decision.
 7. **Preview each beat, then get judged.** `preview_frame` at t=0, each beat boundary, and the
    final lockup; describe each still before scoring. `score_composition` with the brand facts as
-   `brandContext` and your arc as `editorialIntent`; fix the worst axis first, ship at ≥ 7.5.
+   `brandContext` and your arc as `editorialIntent`; fix the worst axis first, fix relevant acceptance failures.
 8. **One final render.** `create_render` → `wait_job (kind:"render")`.
 
 ## What good looks like
@@ -74,19 +78,19 @@ affected behavior and regressions; reserve full-film judging and export for the
 Quoted from `video-craft-standards` §3 (Brand-identity reel) — read the full section; §1's
 social-reel rules apply underneath it:
 
-> **MUST** Three-beat arc: opening brand moment (wordmark treatment) → middle craft/proof beat
+> **DEFAULT** Three-beat arc: opening brand moment (wordmark treatment) → middle craft/proof beat
 > (the subject's world, with an editorial device — numbered chapter, pull-quote, stat) → closing
 > tagline lockup.
 
-> **MUST** Every graphic is bespoke to the brand: its type, its palette as fields, its layout
-> system. **K:** any layout that would look correct with another brand's hex swapped in.
+> **DEFAULT** Every graphic is bespoke to the brand: its type, its palette as fields, its layout
+> system. **Consider:** any layout that would look correct with another brand's hex swapped in.
 
-> **MUST** Footage color and brand palette agree — grade toward the palette or choose footage
+> **DEFAULT** Footage color and brand palette agree — grade toward the palette or choose footage
 > that lives in it.
 
 And the cross-cutting card rule:
 
-> **MUST** Brand/text graphics are AUTHORED — `kind:"card"` HTML […] **K:** a brand graphic
+> **DEFAULT** Brand/text graphics are AUTHORED — `kind:"card"` HTML […] **Consider:** a brand graphic
 > rendered from a catalog text primitive.
 
 ## Delivering

package/dist/skills/clip-a-talking-head/SKILL.md

@@ -5,6 +5,14 @@ description: Cuts a podcast, talk, or interview into shorts that open on the str
 
 # Clip a talking head
 
+## Scope and capability policy
+
+User intent and acceptance criteria override this recipe's aesthetic defaults. Silent, typography-only, uncaptioned and slow work are valid; no universal narration, footage, CTA, beat count or score target. Contracts, factual fidelity, media bindings and current source revisions remain mandatory.
+
+Read available tools and current project; preserve the chosen local/hosted lane. Supported local work needs no hosted registration. Do not silently install, authenticate, switch projects or upload local content. Before metered hosted work, check `get_account`, entitlements, balance and quotes. Desktop setup: https://docs.cueframe.ai.
+
+For scoped revisions, preserve unrelated timing, media, audio and shared brand-kit state. Edit affected content; inspect relevant frames, continuous motion and affected audio. No restarted intake, new approval pause, paid judge or final export by default. Judge only when useful; scores never override acceptance failures. Stop/report after two no-improvement passes. See [preview workflow](../cueframe-compose-loop/references/preview-workflow.md).
+
 You point at long-form footage of people talking; you get back one or more 15–60 second clips
 that each open on the strongest sentence, keep a moving camera on whoever is speaking, cut the
 dead air, and caption every word from the real transcript.
@@ -70,23 +78,23 @@ correction, retain the approved edit and check relevant regressions without auto
    depth title or ignored speaker crop is not preview evidence.
 9. **Preview, judge, render once per clip.** `preview_frame` at t=0 and each cut; describe each
    still (is the framed person the one talking? is the top of the head in frame?).
-   `score_composition` with the clip's claim as `editorialIntent`; fix worst-first to ≥ 7.5,
+   `score_composition` with the clip's claim as `editorialIntent`; fix relevant acceptance failures,
    then `create_render` → `wait_job (kind:"render")`.
 
 ## What good looks like
 
-Quoted from `video-craft-standards` §4 (Talking-head clip) — the full checklist is the bar:
+Quoted from `video-craft-standards` §4 (Talking-head clip) — apply the relevant defaults under the scope policy:
 
-> **MUST (K)** Hook = the strongest sentence, first. Cut TO the moment; never open on wind-up.
+> **DEFAULT** Hook = the strongest sentence, first. Cut TO the moment; never open on wind-up.
 
-> **MUST** Active-speaker reframe (`focus: active-speaker` / `face`) — a moving camera, not a
+> **DEFAULT** Active-speaker reframe (`focus: active-speaker` / `face`) — a moving camera, not a
 > static center crop.
 
-> **MUST** Captions timed to the edited clip (`captions.fromComposition`); behind-speaker
-> placement where the footage allows it. **MUST** Dead air and false starts cut
+> **DEFAULT** Captions timed to the edited clip (`captions.fromComposition`); behind-speaker
+> placement where the footage allows it. **DEFAULT** Dead air and false starts cut
 > (`addExcludedRange` / `cutAndRipple`).
 
-Plus the cross-cutting audio rule: *"Audio is decided, never defaulted […] **K:** a render whose
+Plus the cross-cutting audio rule: *"Audio is decided, never defaulted […] **Consider:** a render whose
 silence nobody chose."*
 
 ## Delivering