@cueframe/skills 0.1.0 → 0.1.2

package/skills/cueframe-connect/SKILL.md

@@ -1,45 +0,0 @@
----
-name: cueframe-connect
-description: Use when CueFrame is not connected yet, the user asks how to connect or authenticate CueFrame, or another CueFrame skill is about to call a tool and needs the one-time setup path for Claude Code, Claude, ChatGPT, Cursor, Codex, VS Code, Windsurf, Zed, Antigravity CLI, Copilot CLI, or an x402 wallet.
----
-
-# Connect CueFrame
-
-Connect only when the first CueFrame tool call is imminent. Setup is a short detour, not a phase;
-resume the user's original task immediately afterward.
-
-- **Claude Code:** offer to run
-  `claude mcp add --transport http cueframe https://api.cueframe.ai/v1/mcp` — a browser
-  opens and the user clicks **Allow**. No API key.
-- **Claude.ai / Claude Desktop:** Settings → Connectors → add a custom connector with
-  `https://api.cueframe.ai/v1/mcp`.
-- **Other agents (Cursor, Codex, VS Code, Windsurf, Zed, Antigravity CLI, Copilot CLI, …):**
-  run `npx -y cueframe@0.5 install` — it detects what is on the machine and wires each one.
-- **ChatGPT:** the CLI cannot wire it because there is no local config to write; add
-  `https://api.cueframe.ai/v1/mcp` as a custom connector instead.
-- **No account (pay per call):** connect
-  `https://api.cueframe.ai/v1/mcp/x402` — no sign-up or API key; priced calls settle
-  per call in USDC over x402 from the agent's wallet.
-
-Do not ask the user to configure a model provider for CueFrame. This connection exposes CueFrame's
-tools; the host agent keeps using its already-selected CueFrame Gateway, BYOK, or local model.
-
-## Then confirm it works, before you plan anything
-
-Connected is not the same as working, and finding out at the first *paid* call is the expensive
-way. Two free read-only calls prove the whole path:
-
-1. **Discover the surface.** List the tools your host now exposes. You should see the compose loop
-   (`new_composition`, `apply_composition`, `validate_composition`, `create_render`) alongside
-   discovery reads (`list_catalog`, `list_media`, `get_account`). There are also resources
-   (`cueframe://scene-shot` for 3D product shots) and workflow prompts — a flat tool list is not
-   the whole surface.
-2. **Smoke-call `get_account`.** It takes no arguments, costs nothing, and answers the questions
-   worth knowing before you spend: which org the key is bound to, the plan, per-feature
-   entitlements and — the one that matters — `balance`, not `included`. CueFrame is credit-funded,
-   so rendering, generation, preview stills, the judge and the Director all draw on ONE shared
-   wallet. If `get_account` returns, authentication, routing and scope are all proven.
-
-If a later call fails on scope, the error names the exact missing permission (for example
-`billing:read`, which `get_usage` needs and a creative-only key will not have). Mint a key with
-that scope rather than guessing at the surface.

package/skills/cueframe-storyboard/SKILL.md

@@ -1,104 +0,0 @@
----
-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 lay out the hook→body→cta beats that drive the compose workflow. 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
-
-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.
-
-> **The bar:** the `video-craft-standards` skill (GET /v1/skills/video-craft-standards) defines DONE for every artifact class — per-class MUST checklists and kill criteria. Read it before composing and score against it before rendering. When this skill and that document disagree, the standards win.
-
-
-## The one idea
-
-**You are the planner.** You have the user, the whole conversation, the brand, and the judgment — you are
-the smartest thing in this loop. CueFrame is the hands. This skill is the **intake + structure** step:
-turn intent into a concrete **beat flow** *before* you seed a composition, so the curated workflow (media →
-components → seed) executes a plan instead of a guess. Craft — grounded-vs-slop, the verify loop — belongs
-to the sibling **composing-video** skill; this skill gets you a flow, then hands off to it.
-
-Do not offload the *thinking* to CueFrame. There is no server that plans the video for you, and you would
-not want one — it would be a blind model with none of your context. Plan here, in the open, with the user.
-
-## 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), **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 duration into **beats** using the fixed editorial vocabulary
-**hook → context → body → proof → cta → outro** (use what the piece needs — most short-form is
-hook → body → 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** — real footage is the strongest grounding and CueFrame's home turf, so reach for it
-  first; otherwise `generate` a *purposeful* clip (a diagram of the real mechanism, the real UI) or `find`
-  stock. Animated text over a gradient is not grounding — it's the slop default,
-- an optional **graphic** (a lower-third, title, CTA card),
-- a **caption** and/or a **VO/script** line.
-
-**Ground it, don't invent it.** Pick every graphic/scene from `list_catalog` (filter by `useCase`/`tier`)
-— never hardcode hex or positions or name a component that doesn't exist. Theme from the brand kit. If
-you're planning over real footage, read `get_media_context` (detected faces + transcript) so beat timing,
-crops, and captions land on what's actually there.
-
-## 3. Show the flow, then persist it as a Brief
-
-Show the user the beat list **first** — a five-line outline. It is cheap to change here and expensive to
-change after a render, so this is where you converge on structure. On their go, **persist the plan with
-`create_brief`** — the beats/goal/format/gates you just elicited map 1:1 onto its fields, and the plan stops
-being chat-ephemeral (it survives the session, carries a cost quote, and is honored field-by-field):
-
-1. `import_media` / `generate_media` for each beat's media need,
-2. `create_brief` — goal, audience, platform/format, durationSec, tone, cta, locale, and the beats
-   (each with its editorial intent and, when you're cutting real footage, MOMENT PINNING
-   `source: {mediaId, startSec, endSec}` from the transcript — honored to-the-frame or refused).
-   Relay the response's **quote** (compose + estimated render) BEFORE composing.
-3. `compose { briefId }` — the Director authors FROM your brief; every field is honored or the
-   compose is refused loudly naming the field. Gates: put `holdAt: ["layout"]` in the brief's `gates` when
-   the user wants to approve the storyboard mid-flight; `autoApprove: true` for hands-off.
-4. `score_composition` / `consult` to fix the weakest beat,
-5. `create_render` for the MP4.
-
-**Two graphic media — pick per beat, and review accordingly:** a `card` (verbatim HTML in
-`seededGraphics`) is a STATIC graphic — cheap, approve it from a still; a **component**
-(`create_component`, `useCurrentFrame`) is MOTION — a still is one frame, so preview it before trusting it.
-Seeded graphics you author into the brief are carried VERBATIM as locked clips — the Director never
-re-authors them; `exclusions` bans graphic kinds you never want it to author.
-
-Then load **composing-video** and apply its craft to make each beat good.
-
-## 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; skip the whole flow only
-for a re-render of an approved composition or a single trivial one-off.

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

@@ -1,128 +0,0 @@
----
-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

@@ -1,6 +0,0 @@
-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

@@ -1,16 +0,0 @@
-<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.sh.json

@@ -1 +0,0 @@
-{ "$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" ] } ] }