@cueframe/skills 0.1.0 → 0.1.2

package/dist/skills/cueframe-storyboard/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: cueframe-storyboard
+description: >-
+  Use BEFORE composing when starting a NEW video from scratch and you need to plan its structure — turning a rough ask ("make a launch video", "30s promo", "an explainer for our API") into a concrete beat flow. Owns the intake + storyboard step: interview the user for the brief, resolve the format from the platform, and plan beats from the leading material and requested format. Triggers on "plan a video", "storyboard", "structure this video", "outline the video", "where do I start", or any new-video ask that has no structure yet. Hand off to composing-video for per-beat craft.
+---
+
+# CueFrame Storyboard: brief → flow
+
+## 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).
+
+This is a new-video planning workflow. For revisions to an approved plan, preserve its structure
+and use `cueframe-compose-loop`'s [preview workflow](../cueframe-compose-loop/references/preview-workflow.md)
+to verify the requested change; do not restart intake, Director authoring, or final export by default.
+
+Plan here from the user's context. Direct authoring uses the available composition/component tools; hosted Director authoring is an optional execution lane when `create_brief` and `compose` are actually exposed. Neither lane substitutes for deciding the user's acceptance criteria.
+
+## 1. Interview for the brief — ask only what you can't infer
+
+Fill the brief from the conversation first; ask the user **only for the 1–2 things you genuinely cannot
+infer**, and STATE what you assume for the rest. Never wall them with a form.
+
+- **Goal / intent** *(required)* — what is this video FOR? launch, promo, explainer, demo, teaser, recap.
+- **Platform** *(sets the format)* — reels / tiktok / shorts → **9:16, ~20s** · youtube → **16:9, ~45s** ·
+  linkedin / x → **1:1, ~20s** · web → **16:9, ~30s**. (Or an explicit aspect ratio + duration.)
+- **Audience**, **tone** (punchy / premium-calm / playful / authoritative), optional **CTA**, **must-includes**
+  (a number, a name, a screen), **references** (a style to echo), **brand kit**.
+
+If the ask is "make a launch video for our API," you already have goal + a hint of audience — ask "Reels,
+YouTube, or your site?" and infer the rest: *"I'll assume a developer audience and a punchy tone — say if
+you'd rather it feel calm/premium."* One or two questions, not seven.
+
+## 2. Structure the flow — the storyboard
+
+Lay the requested duration into **beats** using the available editorial vocabulary
+**hook → context → body → proof → cta → outro** (use only what the piece needs; no fixed count or required CTA). For each beat decide:
+
+- a one-line **intent** (what this beat does for the viewer),
+- a **duration** (they sum to the target; the hook earns attention in ~3s),
+- a **media need**, if any: actual footage, product action, sourced data, diagrams, typography or abstract motion as requested,
+- optional graphics, captions and voice; preserve requested silence and deliberate holds.
+
+Choose the leading material first: narration, recorded speech, product action, visual/music motion or observational sequence. Read `get_media_context` when source facts or transcript timings affect the plan. Discover existing primitives with `list_catalog` when available; custom authored graphics are also valid. Never invent a catalog entry, media ID, transcript or factual product capture.
+
+## 3. Execute the plan in the available lane
+
+Give a concise outline when useful. Continue within existing authorization; request approval only when the user requested a review gate or a decision is genuinely missing.
+
+**Direct authoring:** use the exposed composition operations and existing project assets, then the scoped preview workflow. A local project does not require hosted registration, `create_brief`, `compose` or a paid judge. Read the actual local contracts; desktop setup is documented at https://docs.cueframe.ai.
+
+**Hosted Director, when available and selected:** check `get_account` and current quotes before metered imports, generation or composition. Persist the accepted plan with `create_brief`, including only supported fields. Pin recorded moments with `source: {mediaId, startSec, endSec}` where supported. Relay its compose/render quote before `compose {briefId}`. Use `holdAt` only for a requested gate and `autoApprove` only when authorized and supported. Do not silently upload local content or move to a different project to obtain this lane.
+
+Review with stills plus motion/audio evidence appropriate to the affected content. Cards can animate; a still alone cannot verify their motion. Use `score_composition` for broader review only when useful; export with `create_render` when final delivery is requested. Then load **composing-video** for applicable craft guidance.
+
+## Related skills & positioning
+
+This skill owns **structure/intake**; its siblings own execution and craft — defer to them:
+
+- **composing-video** — the craft/quality layer (grounded specificity vs. slop, the vision → rubric →
+  verify loop). Load it *after* you have a flow; it makes each beat good.
+- **cueframe-compose-loop** — the author → render → verify → fix convergence loop + the ship bar.
+- **cueframe-product-video** — click-points → auto-zoom tiling + PiP for screen demos.
+- **cueframe-brand-demo** — brand-token vocabulary + auto intro/outro/logo for branded launches.
+- **cueframe-component-authoring** — fork → preview → push for a custom graphic a beat needs.
+- **cueframe-cli** — the `cueframe` binary + wire mechanics.
+
+## The boundary
+
+You own the **vision** (the one idea and the flow for *this* video) and **data correctness** (a wrong
+number you supply is rendered faithfully — the mistake is yours). CueFrame owns being faithful, legible,
+and giving you real footage + real components to plan against. Reason from this; use this planning flow only when new work needs structure.

package/{skills → dist/skills}/every-format-from-one-edit/SKILL.md

@@ -5,6 +5,14 @@ description: Derives content-aware 9:16, 1:1, and 4:5 siblings from one finished
 
 # Every format from one edit
 
+## 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 finish ONE edit; you get back its siblings for every platform — 9:16 for
 Reels/TikTok/Shorts, 1:1 and 4:5 for feeds — derived content-aware from the master,
 subject-tracked rather than letterboxed, each judged and rendered on its own. The edit decisions
@@ -54,9 +62,8 @@ A correction to one sibling does not require rendering the master or the other u
    note repeats it. If a sibling needs a different bed, `search_resources` honoring the brand
    kit's `musicMood` and swap it on that sibling only.
 6. **Judge each sibling as its own artifact.** `score_composition` per sibling with the
-   master's vision as `editorialIntent`. A 9:16 sibling is a social reel and answers to that
-   class's checklist — hook inside 2 seconds still applies in the new crop. Fix worst-first to
-   ≥ 7.5.
+   master's vision as `editorialIntent`. Changing aspect ratio does not change the approved editorial intent, pacing or acceptance criteria. Fix worst-first to
+   meet the applicable acceptance criteria.
 7. **Render each approved sibling.** `create_render` → `wait_job (kind:"render")` per
    composition. One final render per approval; iterate with previews.
 
@@ -64,15 +71,14 @@ A correction to one sibling does not require rendering the master or the other u
 
 Quoted from `video-craft-standards` (cross-cutting rules — every artifact):
 
-> **MUST** Safe-area respected: no critical copy in the outer ~8% of frame.
+> **DEFAULT** Safe-area respected: no critical copy in the outer ~8% of frame.
 
-> **MUST** One final render per approval; iterate with previews, not renders.
+> **DEFAULT** 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
+> **DEFAULT** Delivery never ends with "done": the last message carries the output link and where
 > to find it, plus the intentional-silence note if any.
 
-And the class rule that governs each sibling: a derived 9:16 answers to §1 (Social reel) —
-*"**MUST (K)** The hook lands inside 2 seconds"* — a derived 16:9 to its own class. Derivation
+And the class rule that governs each sibling: apply the original brief at the new dimensions; aspect ratio alone does not impose a social-reel hook or pacing. Derivation
 changes the frame, never the bar.
 
 ## Delivering

package/{skills → dist/skills}/extracting-brand-kits/SKILL.md

@@ -6,6 +6,14 @@ description: >-
 
 # Extracting brand kits: reference pixels → a kit the engine honors
 
+## 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).
+
 ## The one idea
 
 **No summarization anywhere in the path.** A reference described in prose converges on house style

package/{skills → dist/skills}/launch-video/SKILL.md

@@ -5,6 +5,14 @@ description: Turns screen recordings and product footage into a 30–90 second 1
 
 # Launch video
 
+## 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 real screen recordings or product footage plus the one outcome the feature delivers;
 you get back a 30–90 second 16:9 announcement that opens on the payoff, shows the actual product
 doing the real thing, builds under a bed or narration, and lands on a single CTA.
@@ -50,34 +58,32 @@ affected window and regressions without automatically rerunning the full-film ju
    HTML in the brand's type and palette — persisted first, then shelled with
    `applyMotionPreset` in a FOLLOWING `apply_composition` call. One CTA on the end card, held
    long enough to read, plus the date if there is one.
-6. **Audio that builds — required.** `search_resources` for a bed honoring the brand kit's
+6. **Audio when requested or appropriate.** Preserve explicit silence; otherwise: `search_resources` for a bed honoring the brand kit's
    `musicMood`, energy arcing toward the reveal; place it `audioRole:"music"`,
    `materializeGrid { grid:"beat" }`, and land beat boundaries and the reveal on the grid. If
    narrated: the VO is the rhythm authority instead — cut to the voice and duck the bed under
-   it. Silence is almost never right for a launch; if chosen anyway, record the decision and
-   reason in the delivery note.
+   it. Explicit silence is a supported creative choice.
 7. **Caption narration.** For transcribed voice, save the edits first, then call
    `captions.fromComposition` with the narration track ID in a separate `apply_composition`
    call. Speech clips must have saved duration matching playable source duration divided by
    playbackRate. Re-run after later edits. Use authored word timings for generated VO without a
-   transcript, and style legibly via `setCaptionStyle`. Captions are mandatory when narrated.
+   transcript, and style legibly via `setCaptionStyle`. Caption narration when requested or appropriate; preserve an explicit uncaptioned format.
 8. **Preview, judge, one render.** `preview_frame` at t=0, hook-end, the reveal, and the end
    card; describe each still — is that a REAL capture on screen? Then `score_composition` with
-   the payoff line as `editorialIntent`; fix worst-first to ≥ 7.5; `create_render` →
+   the payoff line as `editorialIntent`; fix relevant acceptance failures; `create_render` →
    `wait_job (kind:"render")`.
 
 ## What good looks like
 
-Quoted from `video-craft-standards` §2 (Launch film / feature announcement) — the full checklist
-wins:
+Quoted from `video-craft-standards` §2 (Launch film / feature announcement) — these are format defaults:
 
-> **MUST (K)** Payoff-first hook: the OUTCOME, not the feature name ("Close the books two days
+> **DEFAULT** Payoff-first hook: the OUTCOME, not the feature name ("Close the books two days
 > faster" beats "Introducing the reconciliation module"). No throat-clearing.
 
-> **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.
+> **DEFAULT** Narration or a bed that builds toward the reveal; pacing tightens as the payoff
+> approaches. **DEFAULT** Real product surface: actual UI/screens/output — never mocked.
 
-> **MUST** End card with a single CTA. **MUST** Captions present when narrated.
+> **DEFAULT** End card with a single CTA. **DEFAULT** Captions present when narrated.
 
 And cross-cutting: *"Footage carries the video: real footage / real UI / real data ≥60% of
 runtime for footage-first classes."*

package/{skills → dist/skills}/make-a-social-reel/SKILL.md

@@ -5,6 +5,14 @@ description: Turns footage into a finished 9:16 social reel — hook inside 2 se
 
 # Make a social 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 hand over footage (a file URL, a talk, a product moment); you get back a 9:16 reel of 8–30
 seconds that opens on its strongest image, cuts on the music, carries brand-grade type, and ends
 on a deliberate beat — with a download link, not a "done".
@@ -32,20 +40,17 @@ Use `cueframe-compose-loop`'s [preview workflow](../cueframe-compose-loop/refere
 for layout and motion evidence. A follow-up tweak preserves the approved brief; inspect the
 affected window and regressions without automatically rerunning the full-film judge or export.
 
-
 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. Use the requested visual experience as intent when the piece makes no factual claim.
 
 1. **Import and read the footage.** `import_media` (public https URL), poll `list_media` until
    ready, then `get_media_context` — faces, transcript, word timings. The context tells you
    where the hook lives; don't guess.
 2. **Pick the hook before you touch the timeline.** The strongest image, motion, or claim in the
    footage — the outcome, not the feature name, is the hook. If the best moment is at 0:47, the
-   reel opens at 0:47. No logo-first cold opens, ever.
+   reel opens at 0:47. A logo-first opening remains valid when explicitly requested.
 3. **Seed the timeline.** `new_composition` at 9:16, then `apply_composition`: clips trimmed to
    the beats you chose, a new visual beat at least every ~4 seconds. Cut TO moments; never let a
    clip run out.
@@ -56,7 +61,7 @@ affected window and regressions without automatically rerunning the full-film ju
    palette-as-fields, considered alignment — persisted first, then shelled with
    `applyMotionPreset` in a FOLLOWING `apply_composition` call. Catalog text primitives are
    utility only.
-6. **Decide the audio — required, never skipped.** Search a bed with `search_resources` honoring
+6. **Honor requested silence or existing audio.** When a bed is appropriate, search a bed with `search_resources` honoring
    the brand kit's `musicMood`, place it as an `audioRole:"music"` clip, then `materializeGrid`
    `{ grid:"beat" }` and land your cut points and transition midpoints on the markers. If the
    piece is genuinely better silent, that is a decision — record it and its reason in the
@@ -71,28 +76,27 @@ affected window and regressions without automatically rerunning the full-film ju
    don't karaoke a beat with no speech.
 8. **Look, then get judged.** `preview_frame` at t=0, hook-end, and every beat boundary;
    describe each still in words before scoring it. Then `score_composition` with your one-line
-   vision as `editorialIntent` — fix the worst criterion first. Ship at composite ≥ 7.5, budget
-   3–5 passes.
+   vision as `editorialIntent` — fix the worst criterion first. Meet the applicable acceptance criteria; budget
+   up to 3–5 passes only for broader review.
 9. **One final render.** `create_render` → `wait_job (kind:"render")`. Iterate with previews,
    not renders.
 
 ## What good looks like
 
-Quoted from `video-craft-standards` §1 (Social reel) — the full checklist wins over this skill
-wherever they disagree:
+Quoted from `video-craft-standards` §1 (Social reel) — these are defaults for this format, subject to the scope policy above:
 
-> **MUST (K)** The hook lands inside 2 seconds: the strongest image, motion, or claim opens the
+> **DEFAULT** 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.
+> **DEFAULT** Typography is poster-grade: composed plates/fields in the brand palette, considered
+> alignment and scale. **Consider:** centered white text floating on footage.
 
-> **MUST** Pacing is cut-driven: a new visual beat at least every ~4s […] **MUST** Ends on a
+> **DEFAULT** Pacing is cut-driven: a new visual beat at least every ~4s […] **DEFAULT** Ends on a
 > deliberate beat: tagline, logo, or CTA lockup — not a clip running out.
 
 And the cross-cutting audio rule:
 
-> **MUST** Audio is decided, never defaulted […] **K:** a render whose silence nobody chose.
+> **DEFAULT** Audio is decided, never defaulted […] **Consider:** a render whose silence nobody chose.
 
 ## Delivering
 

package/{skills → dist/skills}/rebrand-a-video/SKILL.md

@@ -5,6 +5,14 @@ description: Swaps the brand kit under an existing video and re-renders — toke
 
 # Rebrand a video
 
+## 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 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,
@@ -23,9 +31,7 @@ Then back to the brand — most of this job is a kit definition and an audit.
   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.
+- **Scope:** a title/color/logo correction edits only affected clip values or bindings. Do not upsert a shared kit for one local correction. A project-wide brand change must be explicit: a same-kit upsert affects every referencing composition. For a new identity, use a new kit when supported. Styling preserves layout; a full redesign requires explicit scope.
 - **Tone shift**: does the new brand change the music mood too? Check the kit's `musicMood`
   intent.
 
@@ -35,7 +41,7 @@ Use `cueframe-compose-loop`'s [preview workflow](../cueframe-compose-loop/refere
 for affected graphics and saved-composition checks. Inspect motion if the kit changes timing;
 keep the final re-render separate from previews used to resolve individual styling corrections.
 
-1. **Pin the new brand as a kit.** `extract_brand_kit` or `create_brand_kit`; show the kit and
+1. **For an explicit project-wide brand change, 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.
@@ -56,31 +62,27 @@ keep the final re-render separate from previews used to resolve individual styli
 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
+   `applyMotionPreset` in a FOLLOWING call. If the requested scope is styling, retain its layout; rebuild only for an explicitly requested redesign.
+6. **Review audio only when in scope.** A styling correction preserves existing audio and timing; for a broader brand change: 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")`.
+7. **Preview the affected styling.** Check the changed color/logo/text and relevant regressions against the requested values. For broader brand review, use `score_composition` only when useful and within budget. Export with `create_render` only for requested final delivery.
 
 ## 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.
+> **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 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
+And cross-cutting: *"**DEFAULT** Brand/text graphics are AUTHORED — `kind:"card"` HTML (your
+typography, layout, palette-as-fields) […] **Consider:** a brand graphic rendered from a catalog text
 primitive."*
 
 ## Delivering

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

@@ -0,0 +1,121 @@
+---
+name: video-craft-standards
+description: Craft defaults and applicable review checklists for CueFrame videos (social reel, launch film, brand reel, talking-head clip). User intent and requested scope govern their application; factual fidelity and tool contracts remain mandatory. 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
+
+## 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).
+
+These are aesthetic defaults for the named formats, not universal delivery gates. Apply only the checklist items relevant to the requested artifact; a silent typography study needs neither footage nor narration, and a title correction needs only affected evidence. User acceptance criteria govern delivery. The labels below describe recommendations; do not reject explicit creative choices using a default or a judge score.
+
+## The controlling idea — the rule above every rule
+
+- **DEFAULT** For new work, consider stating 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?).
+- **DEFAULT** Each included channel serves the requested intent, 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.
+- **Review prompts:** (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)
+
+These are final-artifact criteria, not a requirement to re-plan or export after every tweak.
+For scoped corrections and preview selection, use `cueframe-compose-loop`'s
+[preview workflow](../cueframe-compose-loop/references/preview-workflow.md). Inspect continuous
+motion and listen to affected audio, not only stills or judge scores. Keep the user's explicit
+scope and acceptance criteria; approved simulated UI is not evidence of a real product capture.
+
+- **DEFAULT** 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.
+  **Consider:** a brand graphic rendered from a catalog text primitive.
+- **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. **Consider:** a render whose silence nobody chose.
+- **DEFAULT** Footage carries the video: real footage / real UI / real data
+  ≥60% of runtime for footage-first classes. Typography-only work is a valid requested format.
+- **DEFAULT** Every stock asset's provenance is recorded (provider, id, author).
+- **DEFAULT** Safe-area respected: no critical copy in the outer ~8% of frame.
+- **DEFAULT** One final render per approval; iterate with previews, not renders.
+- **DEFAULT** 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
+
+- **DEFAULT** 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.
+- **DEFAULT** Typography is poster-grade: composed plates/fields in the brand
+  palette, considered alignment and scale. **Consider:** centered white text
+  floating on footage.
+- **DEFAULT** 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.
+- **DEFAULT** 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
+
+- **DEFAULT** 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…").
+- **DEFAULT** Narration or a bed that builds toward the reveal; pacing tightens
+  as the payoff approaches.
+- **DEFAULT** Real product surface: actual UI/screens/output — never mocked.
+- **DEFAULT** End card with a single CTA.
+- **DEFAULT** Captions present when narrated.
+
+## 3. Brand-identity reel — 9:16 · 12–20s (the showcase class)
+
+Everything in §1, plus:
+- **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.
+- **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.
+- **DEFAULT** 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
+
+- **DEFAULT** Hook = the strongest sentence, first. Cut TO the moment;
+  never open on wind-up.
+- **DEFAULT** Active-speaker reframe (`focus: active-speaker` / `face`) — a
+  moving camera, not a static center crop.
+- **DEFAULT** Captions timed to the saved edited timeline (`captions.fromComposition`
+  after the clip edits; re-run after later edits). Speech clips must have saved duration matching playable source duration divided by
+  playbackRate.
+  The focused behind-the-speaker LOOK is an overlay text layer at
+  `zPlane:"behind-subject"` where the footage allows. Use caption-layer
+  `zPlane:"behind-subject"` only when the user explicitly wants every running
+  caption behind the speaker and the legibility gate accepts it.
+- **DEFAULT** Dead air and false starts cut (`addExcludedRange` /
+  `cutAndRipple`).
+
+## Scoring discipline
+
+Check the requested criteria against appropriate real evidence: affected stills, continuous motion and audio when relevant. Broader review can use `score_composition` when useful and within budget; it is not mandatory for a scoped correction. The hosted judge includes a fixed caption criterion and can penalize intentionally uncaptioned work; do not add captions solely to improve that score. These skill changes do not change judge behavior. Failed user acceptance criteria remain failures regardless of score. Stop and report remaining gaps after two passes without improvement; export only for requested final delivery.

package/dist/skills/video-craft-standards/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Video-Craft Standards — what \"finished\" means"
+  short_description: "Craft defaults and applicable review checklists for CueFrame videos (social…"
+  icon_small: "./assets/icon.svg"
+  icon_large: "./assets/icon.svg"
+  default_prompt: "Use $video-craft-standards to craft defaults and applicable review checklists for CueFrame videos (social reel, launch film, brand reel, talking-head clip)."

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cueframe/skills",
-  "version": "0.1.0",
-  "description": "CueFrame agent skills and plugin manifests for Claude Code, Codex and MCP clients.",
+  "version": "0.1.2",
+  "description": "CueFrame agent skills: the SKILL.md tree the CueFrame plugin ships, packaged for programs that copy or embed the skills.",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -12,46 +12,27 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "skills",
+    "dist",
     "skills-dir.js",
-    "AGENTS.md",
-    "glama.json",
-    "plugin.json",
     "skills-dir.d.ts",
-    ".claude-plugin",
-    ".mcp.json",
-    "hooks",
-    ".codex-plugin",
-    ".agents",
-    "mcp.json",
-    ".cursor-plugin",
-    "rules",
-    "gemini-extension.json",
-    "skills.sh.json",
-    "llms-install.md",
-    "assets",
     "README.md",
     "LICENSE",
     "NOTICE"
   ],
-  "scripts": {
-    "build": "node scripts/sync-versions.mjs && node scripts/sync-openai-yaml.mjs",
-    "check": "node scripts/validate.mjs",
-    "test": "node scripts/validate.mjs",
-    "prepublishOnly": "npm run build && npm run check"
-  },
   "publishConfig": {
     "access": "public"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cueframe-ai/cueframe-skills.git"
+    "url": "git+https://github.com/cueframe-ai/cueframe-mcp.git",
+    "directory": "packages/skills"
   },
   "homepage": "https://docs.cueframe.ai",
   "engines": {
     "node": ">=24"
   },
-  "devDependencies": {
-    "yaml": "^2.8.0"
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "check": "node scripts/check.mjs"
   }
-}
+}

package/skills-dir.d.ts

@@ -1 +1,2 @@
+/** Absolute path, with a trailing separator, of the directory holding one subdirectory per skill. */
 export declare const SKILLS_DIR: string;

package/skills-dir.js

@@ -1,2 +1,3 @@
 import { fileURLToPath } from 'node:url';
-export const SKILLS_DIR = fileURLToPath(new URL('./skills/', import.meta.url));
+// The published tree: dist/skills is a build-time copy of the repository's root skills/ directory.
+export const SKILLS_DIR = fileURLToPath(new URL('./dist/skills/', import.meta.url));

package/.agents/plugins/marketplace.json

@@ -1,12 +0,0 @@
-{
-  "name": "cueframe",
-  "interface": { "displayName": "CueFrame" },
-  "plugins": [
-    {
-      "name": "cueframe",
-      "source": { "source": "local", "path": "./" },
-      "policy": { "installation": "AVAILABLE", "authentication": "ON_INSTALL" },
-      "category": "Creativity"
-    }
-  ]
-}

package/.claude-plugin/marketplace.json

@@ -1,6 +0,0 @@
-{
-  "name": "cueframe",
-  "owner": { "name": "CueFrame", "url": "https://cueframe.ai" },
-  "metadata": { "description": "Official CueFrame agent skills for composing, editing and rendering video." },
-  "plugins": [{ "name": "cueframe", "source": "./", "description": "Make and edit videos with CueFrame: composition, motion graphics, captions, clipping and rendering skills, plus the hosted MCP server.", "category": "media" }]
-}

package/.claude-plugin/plugin.json

@@ -1,15 +0,0 @@
-{
-  "name": "cueframe",
-  "displayName": "CueFrame",
-  "version": "0.1.0",
-  "description": "Make and edit videos with CueFrame: composition, motion graphics, captions, clipping and rendering skills, plus the hosted MCP server.",
-  "author": { "name": "CueFrame, Inc.", "url": "https://cueframe.ai" },
-  "homepage": "https://docs.cueframe.ai",
-  "repository": "https://github.com/cueframe-ai/cueframe-skills",
-  "license": "Apache-2.0",
-  "keywords": ["video", "video-editing", "motion-graphics", "captions", "rendering", "mcp"],
-  "documentationUrl": "https://docs.cueframe.ai",
-  "supportUrl": "https://github.com/cueframe-ai/cueframe-skills/issues",
-  "privacyPolicyUrl": "https://cueframe.ai/privacy",
-  "termsOfServiceUrl": "https://cueframe.ai/terms"
-}