@cueframe/skills 0.1.0

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

@@ -0,0 +1,128 @@
+---
+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)
+
+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.
+
+- **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 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.
+- **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/skills/video-craft-standards/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Video-Craft Standards — what \"finished\" means"
+  short_description: "The definition of DONE for every video made with CueFrame — per-artifact…"
+  icon_small: "./assets/icon.svg"
+  icon_large: "./assets/icon.svg"
+  default_prompt: "Use $video-craft-standards for 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."

package/skills/video-craft-standards/assets/icon.svg

@@ -0,0 +1,16 @@
+<svg viewBox="0 0 256 256" xmlns="http://www.w3.org/2000/svg">
+  <clipPath id="cf-favicon-clip"><circle cx="128" cy="128" r="118"/></clipPath>
+  <circle cx="128" cy="128" r="118" fill="#f7c948"/>
+  <g clip-path="url(#cf-favicon-clip)">
+    <path d="M88 128Q160 40 300-40" fill="none" stroke="#160f08" stroke-width="5"/>
+    <path d="M88 128Q170 60 310 20" fill="none" stroke="#160f08" stroke-width="4.5"/>
+    <path d="M88 128Q180 80 316 70" fill="none" stroke="#160f08" stroke-width="4.5"/>
+    <path d="M88 128Q186 110 320 110" fill="none" stroke="#160f08" stroke-width="4.5"/>
+    <path d="M88 128Q186 146 320 146" fill="none" stroke="#160f08" stroke-width="4.5"/>
+    <path d="M88 128Q180 176 316 186" fill="none" stroke="#160f08" stroke-width="4.5"/>
+    <path d="M88 128Q170 196 310 236" fill="none" stroke="#160f08" stroke-width="4.5"/>
+    <path d="M88 128Q160 216 300 296" fill="none" stroke="#160f08" stroke-width="5"/>
+  </g>
+  <circle cx="88" cy="128" r="20" fill="#160f08"/>
+  <circle cx="88" cy="128" r="8" fill="#f7c948"/>
+</svg>

package/skills-dir.d.ts

@@ -0,0 +1 @@
+export declare const SKILLS_DIR: string;

package/skills-dir.js

@@ -0,0 +1,2 @@
+import { fileURLToPath } from 'node:url';
+export const SKILLS_DIR = fileURLToPath(new URL('./skills/', import.meta.url));

package/skills.sh.json

@@ -0,0 +1 @@
+{ "$schema": "https://skills.sh/schemas/skills.sh.schema.json", "groupings": [ { "title": "CueFrame", "description": "Compose, edit and render video from an agent.", "skills": [ "add-music-bed", "brand-reel", "clip-a-talking-head", "composing-video", "cueframe-brand-demo", "cueframe-cli", "cueframe-component-authoring", "cueframe-compose-loop", "cueframe-connect", "cueframe-product-video", "cueframe-scene-shot", "cueframe-storyboard", "every-format-from-one-edit", "extracting-brand-kits", "launch-video", "make-a-social-reel", "rebrand-a-video", "video-craft-standards" ] } ] }