cueframe 0.1.2 → 0.3.0

package/skills/rebrand-a-video/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: rebrand-a-video
+description: Swaps the brand kit under an existing video and re-renders — tokens, bumpers, logo, captions, and motion re-theme automatically; hardcoded card values get surgical edits. Triggers on "rebrand this video", "swap the brand", "we changed our colors", "new logo, same video", "make this video match the new brand", "re-theme our launch video", "white-label this for a client".
+---
+
+# Rebrand a video
+
+You bring a finished video and a new brand (a kit, a website, or new colors/fonts/logo); you get
+the same video back wearing the new identity — everything bound to brand tokens re-themes at
+render, and the few graphics that hardcoded the old brand get found and fixed. Change one line,
+not the whole video.
+
+## Before you start
+
+Collect the new brand's facts first — the swap itself is fast. When the first tool call
+approaches and CueFrame isn't connected:
+
+- **Claude Code:** offer to run
+  `claude mcp add --transport http cueframe https://api.cueframe.ai/v1/mcp` — browser OAuth,
+  one **Allow**.
+- **Claude.ai / Claude Desktop:** Settings → Connectors → add a custom connector with
+  `https://api.cueframe.ai/v1/mcp`.
+- **Other agents:** paste `set up https://cueframe.ai/skill.md`, or run
+  `npx -y cueframe install`.
+
+Then back to the brand — most of this job is a kit definition and an audit.
+
+## Inputs
+
+- **The video** (required): the composition (via `list_compositions`) and which project it lives
+  in.
+- **The new brand** (required): an existing kit id, a website to `extract_brand_kit` from
+  (colors/fonts only — ask for logo, tagline, voice), or explicit values for `create_brand_kit`.
+- **Same identity or a new one?** Restyling THIS brand → upsert the same kit id and every
+  composition pointing at it re-themes. White-labeling for someone else → a NEW kit, so the
+  original stays intact.
+- **Tone shift**: does the new brand change the music mood too? Check the kit's `musicMood`
+  intent.
+
+## Workflow
+
+1. **Pin the new brand as a kit.** `extract_brand_kit` or `create_brand_kit`; show the kit and
+   get sign-off — it is the contract. Then bind it: upsert in place (same kit id) to restyle,
+   or point the project at the new kit for a white-label. The kit lives on the PROJECT, not on
+   a composition op.
+2. **Know what re-themes for free.** Everything resolved at render: `$brand:` color/font/motion
+   tokens on overlays and cards, the kit's intro/outro bumpers, the logo corner mark, the
+   caption profile, the motion identity. Edit the kit, re-render, these all follow — that is
+   the whole "one line" story.
+3. **Hunt what does NOT re-theme.** Anything that hardcoded the old brand: literal hexes or
+   font names inside `kind:"card"` HTML, an old wordmark imported as media, footage graded
+   toward the old palette, baked stock choices that lived in the old world. Walk the
+   composition's overlay and card clips and list every literal value — this audit is the real
+   work.
+4. **Verify with pixels, not the kit.** Kit contents aren't inspectable over MCP after
+   creation, so the truth is the frame: `preview_frame` at t=0, each card, the bumpers, and the
+   end card. Describe each still — is any old color, font, or mark visible? A `$brand:` token
+   that fails to resolve is loud in render logs and falls to a legible neutral; a hardcoded old
+   hex is silent, which is why you hunt it by eye.
+5. **Fix the holdouts surgically.** `apply_composition` edits per offending clip: rebind card
+   fields to `$brand:` tokens (so the NEXT rebrand really is one line), swap the old-wordmark
+   media, re-grade footage toward the new palette. A replaced card gets re-shelled with
+   `applyMotionPreset` in a FOLLOWING call. The §3 test governs every card you touch: if the
+   old brand's hex would still look correct in it, the layout was never bespoke — rebuild it,
+   don't tint it.
+6. **Re-decide the audio — required.** A brand swap is a mood swap: check the bed against the
+   new kit's `musicMood`. Wrong mood → `search_resources` a replacement (license recorded),
+   same role and ducking, `materializeGrid` re-run if cut timing shifts. Still right → say so
+   in the delivery note. If the piece was intentionally silent, confirm that decision still
+   fits the new brand and restate it.
+7. **Judge against the NEW brand, render once.** `score_composition` with the new brand facts
+   as `brandContext` — the brand axis is exactly the check this job needs. Fix worst-first to
+   ≥ 7.5, then `create_render` → `wait_job (kind:"render")`.
+
+## What good looks like
+
+Quoted from `video-craft-standards` §3 (Brand-identity reel) — the bespoke test applies to every
+card in any class:
+
+> **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.
+
+> **MUST** Footage color and brand palette agree — grade toward the palette or choose footage
+> that lives in it.
+
+And cross-cutting: *"**MUST** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
+typography, layout, palette-as-fields) […] **K:** a brand graphic rendered from a catalog text
+primitive."*
+
+## Delivering
+
+The last message closes the loop, never "done":
+
+- The re-rendered link and where it lives (project + composition id), plus the kit id now bound
+  — and the one-line promise made true: next time, edit the kit and re-render.
+- What re-themed automatically vs what you hand-edited (the audit list from step 3) — the user
+  should know which parts of their video are now token-bound.
+- Attribution for any newly licensed bed or asset (provider, id, author).
+- The audio decision: bed kept / bed swapped and why / intentional silence restated.

package/skills/video-craft-standards/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: video-craft-standards
+description: The definition of DONE for every video made with CueFrame — per-artifact checklists (social reel, launch film, brand reel, talking-head clip) with kill criteria. Read this BEFORE composing and score your work against it BEFORE rendering. Other skills quote this document; when a skill and this document disagree, this document wins. Triggers on "is this good enough", "quality bar", "what should a finished reel have", "review my video", or any request to make a video when no other skill has stated the bar.
+---
+
+# Video-Craft Standards — what "finished" means
+
+This is the single source of truth for output quality. A video that misses a
+MUST for its artifact class is **not done** — fix it or explicitly record why
+the rule doesn't apply. Kill criteria (**K**) mean: do not render; fix first.
+
+## Why this exists
+
+Every quality dimension nobody measures decays to the laziest default:
+template titles, silent reels, centered white text on footage. Each class
+below is the checklist a good human editor carries implicitly. Score against
+it with stills (`preview_frame`) and the judge (`score_composition`) before
+your one final render.
+
+## The controlling idea — the rule above every rule
+
+- **MUST (K)** Before composing, write the video's CLAIM in one sentence —
+  the thing a viewer should be able to repeat afterward ("real bread takes
+  48 hours and you can taste every one of them"). Not a vibe, not a tagline:
+  a claim with tension (what does this brand/story believe that its category
+  doesn't?).
+- **MUST (K)** Every channel is EVIDENCE for the claim, in harmony:
+  - **Footage** — each clip earns its place as proof of the claim, chosen
+    from the claim's shot list, not from search-term aesthetics.
+  - **Sound** — the bed's mood and TEMPO embody the claim (a "slow" claim
+    gets a patient, sparse bed and the nerve to hold shots; an "instant"
+    claim cuts hot). Silence and pauses are rhetoric, not absence.
+  - **Pacing** — the cut rhythm IS part of the argument; it may defy
+    platform convention when the claim demands it.
+  - **Type/cards** — copy advances the argument; the tagline lands as the
+    CONCLUSION the beats have earned, never as a caption.
+- **Kill tests:** (1) beats reorderable without changing what the video
+  says; (2) any channel (bed, shot, card) that would fit a different claim
+  equally well; (3) a viewer who watched it cannot state the claim.
+
+## Cross-cutting rules (every artifact)
+
+- **MUST** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
+  typography, layout, palette-as-fields) shelled with `applyMotionPreset`,
+  or a custom component. Catalog text primitives are for utility only.
+  **K:** a brand graphic rendered from a catalog text primitive.
+- **MUST** 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.
+- **MUST** Footage carries the video: real footage / real UI / real data
+  ≥60% of runtime for footage-first classes. Text alone is not a video.
+- **MUST** Every stock asset's provenance is recorded (provider, id, author).
+- **MUST** Safe-area respected: no critical copy in the outer ~8% of frame.
+- **MUST** One final render per approval; iterate with previews, not renders.
+- **MUST** Delivery never ends with "done": the last message carries the
+  output link and where to find it, plus the intentional-silence note if any.
+
+## 1. Social reel — 9:16 · 8–30s
+
+- **MUST (K)** The hook lands inside 2 seconds: the strongest image, motion,
+  or claim opens the piece. No logo-first cold opens, no fade-in-from-black
+  preambles.
+- **MUST** Typography is poster-grade: composed plates/fields in the brand
+  palette, considered alignment and scale. **K:** centered white text
+  floating on footage.
+- **MUST** Pacing is cut-driven: a new visual beat at least every ~4s; static
+  holds >4s need motion inside the frame (reframe push, kenBurns, animated
+  card) or they die.
+- **MUST** Ends on a deliberate beat: tagline, logo, or CTA lockup — not a
+  clip running out.
+- **SHOULD** Cuts land on the music grid when a bed exists.
+
+## 2. Launch film / feature announcement — 16:9 · 30–90s
+
+- **MUST (K)** Payoff-first hook: the OUTCOME, not the feature name
+  ("Close the books two days faster" beats "Introducing the reconciliation
+  module"). No throat-clearing ("in this video we're going to…").
+- **MUST** Narration or a bed that builds toward the reveal; pacing tightens
+  as the payoff approaches.
+- **MUST** Real product surface: actual UI/screens/output — never mocked.
+- **MUST** End card with a single CTA.
+- **MUST** Captions present when narrated.
+
+## 3. Brand-identity reel — 9:16 · 12–20s (the showcase class)
+
+Everything in §1, plus:
+- **MUST** 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.
+- **MUST** Footage color and brand palette agree — grade toward the palette
+  or choose footage that lives in it.
+
+## 4. Talking-head clip — any aspect · 15–60s
+
+- **MUST (K)** 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 static center crop.
+- **MUST** Captions timed to the real transcript (`captions.fromTranscript`).
+  The behind-the-speaker LOOK is an overlay text layer at
+  `zPlane:"behind-subject"` where the footage allows — the caption layer
+  itself always renders in front.
+- **MUST** Dead air and false starts cut (`addExcludedRange` /
+  `cutAndRipple`).
+
+## Scoring discipline
+
+Before the final render: (1) pull stills at each beat boundary and describe
+each one to yourself BEFORE judging it; (2) walk the class checklist and list
+every MUST as pass/fail; (3) any K fails → fix, re-preview; (4) run
+`score_composition` when the budget allows and fix the worst criterion first.
+The checklist is the floor; the judge is the critic; neither substitutes for
+looking at the frames.

package/dist/analyze-CN3MXICA.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import{D as a}from"./chunk-ZBD4U6PD.js";export{a as analyzeCommand};