cueframe 0.11.0 → 0.11.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/README.md +8 -0
  2. package/dist/analyze-C3MSCON6.js +2 -0
  3. package/dist/{chunk-M3NS5UR2.js → chunk-OAJBHFAJ.js} +6 -6
  4. package/dist/cueframe.js +46 -46
  5. package/dist/skills/add-music-bed/SKILL.md +5 -23
  6. package/dist/skills/brand-reel/SKILL.md +5 -28
  7. package/dist/skills/clip-a-talking-head/SKILL.md +2 -20
  8. package/dist/skills/composing-video/SKILL.md +36 -432
  9. package/dist/skills/composing-video/references/acceptance-template.md +21 -0
  10. package/dist/skills/composing-video/references/audio-design.md +125 -0
  11. package/dist/skills/composing-video/references/card-and-motion-runtime.md +49 -0
  12. package/dist/skills/composing-video/references/craft-principles.md +25 -0
  13. package/dist/skills/composing-video/references/film-planning.md +37 -0
  14. package/dist/skills/composing-video/references/format-decisions.md +17 -0
  15. package/dist/skills/composing-video/references/format-playbooks.md +96 -0
  16. package/dist/skills/composing-video/references/motion-design.md +25 -0
  17. package/dist/skills/composing-video/references/project-policy.md +18 -0
  18. package/dist/skills/composing-video/references/sfx-pack.md +69 -0
  19. package/dist/skills/composing-video/references/sound-and-timing.md +15 -0
  20. package/dist/skills/composing-video/references/tool-map.md +43 -0
  21. package/dist/skills/cueframe-brand-demo/SKILL.md +1 -7
  22. package/dist/skills/cueframe-cli/SKILL.md +9 -7
  23. package/dist/skills/cueframe-component-authoring/SKILL.md +20 -169
  24. package/dist/skills/cueframe-component-authoring/references/authoring-paths.md +72 -0
  25. package/dist/skills/cueframe-component-authoring/references/forking-and-layout.md +35 -0
  26. package/dist/skills/cueframe-component-authoring/references/native-component-workflows.md +98 -0
  27. package/dist/skills/cueframe-component-authoring/references/native-source-contract.md +54 -0
  28. package/dist/skills/cueframe-component-authoring/references/parented-device-card.json +13 -0
  29. package/dist/skills/cueframe-component-authoring/references/parented-motion.md +25 -0
  30. package/dist/skills/cueframe-component-authoring/references/retired-projects.md +26 -0
  31. package/dist/skills/cueframe-compose-loop/SKILL.md +14 -115
  32. package/dist/skills/cueframe-compose-loop/references/convergence-loop.md +128 -0
  33. package/dist/skills/cueframe-compose-loop/references/preview-workflow.md +6 -2
  34. package/dist/skills/cueframe-connect/SKILL.md +1 -7
  35. package/dist/skills/cueframe-connect/references/tools.md +6 -5
  36. package/dist/skills/cueframe-product-video/SKILL.md +1 -7
  37. package/dist/skills/cueframe-reference-video/SKILL.md +30 -0
  38. package/dist/skills/cueframe-reference-video/references/measurement-and-comparison.md +45 -0
  39. package/dist/skills/cueframe-reference-video/scripts/motion-grid.sh +116 -0
  40. package/dist/skills/cueframe-scene-shot/SKILL.md +2 -8
  41. package/dist/skills/cueframe-storyboard/SKILL.md +1 -7
  42. package/dist/skills/every-format-from-one-edit/SKILL.md +3 -19
  43. package/dist/skills/extracting-brand-kits/SKILL.md +1 -7
  44. package/dist/skills/launch-video/SKILL.md +6 -26
  45. package/dist/skills/make-a-social-reel/SKILL.md +7 -26
  46. package/dist/skills/rebrand-a-video/SKILL.md +2 -19
  47. package/dist/skills/video-craft-standards/SKILL.md +20 -103
  48. package/dist/skills/video-craft-standards/references/format-standards.md +118 -0
  49. package/package.json +4 -4
  50. package/dist/analyze-5KCAIZI6.js +0 -2
@@ -5,20 +5,14 @@ description: Retrofits a music bed (and ambience or SFX) onto an existing compos
5
5
 
6
6
  # Add a music bed
7
7
 
8
- ## Scope and capability policy
9
-
10
- 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.
11
-
12
- 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.
13
-
14
- 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).
8
+ Use the [project and capability policy](../composing-video/references/project-policy.md) for scope, current state and metered work.
15
9
 
16
10
  > **Stock-audio limits (verified in production):** a Freesound import lands with
17
11
  > `audioRole:"sfx"` and NO beat grid — `import_resource` takes no audioRole param, and
18
12
  > `materializeGrid grid:"beat"` will 422 `grid_unavailable` on it. Set the role yourself when
19
13
  > placing the clip (`audioRole:"music"` on the composition clip), put the bed on its own AUDIO
20
- > track (the judge expects a dedicated music track), and until curated music-pack discovery
21
- > exists, prefer fades over beat-cuts for stock beds — beat-grid cutting works with pack beds.
14
+ > track, kept dedicated to music. Discover curated music beds through `list_catalog`; use an available measured grid
15
+ > only when it exists. A music role alone does not establish a reliable beat grid.
22
16
 
23
17
  You point at an existing composition that sounds empty; you get it back with a licensed bed that
24
18
  matches the brand's mood, sits correctly under any speech, and — where the bed drives pacing —
@@ -50,8 +44,7 @@ delivery; stills and a visual judge cannot establish the mix. Recheck visuals wh
50
44
 
51
45
  1. **Read the composition and its speech.** `list_compositions` / the composition body for
52
46
  what's on the timeline; `get_media_context` for transcripts. Speech present → the voice is
53
- the rhythm authority and the bed serves it. No speech → the bed IS the rhythm authority and
54
- earns beat-cuts.
47
+ the rhythm authority and the bed serves it. Without speech, the bed is the default rhythm authority and earns beat-cuts when it has a measured grid; let the visible action drive timing instead when the brief calls for it, and preserve approved cuts unless retiming is requested.
55
48
  2. **Find the bed, license-aware.** Beds come from the curated music packs —
56
49
  `import_resource { kind:"music-pack" }` — honoring the brand kit's `musicMood` (mood and
57
50
  energy matched to the cut rate). For ambience or loop textures, `search_resources
@@ -81,18 +74,7 @@ and its reason in the delivery note instead of forcing a bed.
81
74
 
82
75
  ## What good looks like
83
76
 
84
- Quoted from `video-craft-standards` (cross-cutting rules — every artifact); this skill exists to
85
- satisfy the second one:
86
-
87
- > **DEFAULT** Audio is decided, never defaulted: a music bed (curated packs via
88
- > `import_resource {kind:"music-pack"}`) or ambience/loops (Freesound via
89
- > `search_resources kind:"sfx"`), honoring the brand kit's `musicMood`; cut to the beat via
90
- > `materializeGrid` when the bed drives pacing — OR an explicit intentional-silence decision
91
- > recorded in your delivery note with the reason. **Consider:** a render whose silence nobody chose.
92
-
93
- > **DEFAULT** Every stock asset's provenance is recorded (provider, id, author).
94
-
95
- And from §1: *"**SHOULD** Cuts land on the music grid when a bed exists."*
77
+ Use the relevant [craft review questions](../video-craft-standards/SKILL.md) and the [preview workflow](../cueframe-compose-loop/references/preview-workflow.md). Judge the brief's actual intent, visual relationships, timing and sound; format suggestions do not override the requested treatment. This skill exists to satisfy the audio rule in the cross-cutting section of the [format standards](../video-craft-standards/references/format-standards.md), which also covers provenance for stock assets; section 1 adds cutting to the music grid when a bed exists.
96
78
 
97
79
  ## Delivering
98
80
 
@@ -5,13 +5,7 @@ description: Produces a 12–20 second 9:16 brand-identity reel — three-beat a
5
5
 
6
6
  # Brand reel
7
7
 
8
- ## Scope and capability policy
9
-
10
- 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.
11
-
12
- 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.
13
-
14
- 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).
8
+ Use the [project and capability policy](../composing-video/references/project-policy.md) for scope, current state and metered work.
15
9
 
16
10
  You bring a brand (a website, a kit, or just a logo and a palette) plus footage of its world;
17
11
  you get back a 12–20 second vertical reel with a three-beat arc — wordmark moment, craft/proof
@@ -68,30 +62,13 @@ affected behavior and regressions; reserve full-film judging and export for the
68
62
  `musicMood`; place it `audioRole:"music"`, then `materializeGrid { grid:"beat" }` and land
69
63
  the three beat boundaries on the grid. A brand reel almost always wants a bed; if the brand's
70
64
  voice calls for silence, preserve that decision.
71
- 7. **Preview each beat, then get judged.** `preview_frame` at t=0, each beat boundary, and the
72
- final lockup; describe each still before scoring. `score_composition` with the brand facts as
73
- `brandContext` and your arc as `editorialIntent`; fix the worst axis first, fix relevant acceptance failures.
74
- 8. **One final render.** `create_render` → `wait_job (kind:"render")`.
65
+ 7. **Inspect the connected sequence.** `preview_frame` at t=0, each beat boundary, and the
66
+ final lockup; describe each still, then inspect the intervening motion and relevant sound. Use `score_composition` only for useful, budgeted broader critique, with the brand facts as `brandContext` and your arc as `editorialIntent`; fix the worst axis first, then located acceptance failures.
67
+ 8. **Export for requested final delivery.** `create_render` → `wait_job (kind:"render")`.
75
68
 
76
69
  ## What good looks like
77
70
 
78
- Quoted from `video-craft-standards` §3 (Brand-identity reel) — read the full section; §1's
79
- social-reel rules apply underneath it:
80
-
81
- > **DEFAULT** Three-beat arc: opening brand moment (wordmark treatment) → middle craft/proof beat
82
- > (the subject's world, with an editorial device — numbered chapter, pull-quote, stat) → closing
83
- > tagline lockup.
84
-
85
- > **DEFAULT** Every graphic is bespoke to the brand: its type, its palette as fields, its layout
86
- > system. **Consider:** any layout that would look correct with another brand's hex swapped in.
87
-
88
- > **DEFAULT** Footage color and brand palette agree — grade toward the palette or choose footage
89
- > that lives in it.
90
-
91
- And the cross-cutting card rule:
92
-
93
- > **DEFAULT** Brand/text graphics are AUTHORED — `kind:"card"` HTML […] **Consider:** a brand graphic
94
- > rendered from a catalog text primitive.
71
+ Use the relevant [craft review questions](../video-craft-standards/SKILL.md) and the [preview workflow](../cueframe-compose-loop/references/preview-workflow.md). Judge the brief's actual intent, visual relationships, timing and sound; format suggestions do not override the requested treatment. For this format's defaults read section 3 (Brand-identity reel) of the [format standards](../video-craft-standards/references/format-standards.md); section 1's social-reel defaults apply underneath it.
95
72
 
96
73
  ## Delivering
97
74
 
@@ -5,13 +5,7 @@ description: Cuts a podcast, talk, or interview into shorts that open on the str
5
5
 
6
6
  # Clip a talking head
7
7
 
8
- ## Scope and capability policy
9
-
10
- 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.
11
-
12
- 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.
13
-
14
- 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).
8
+ Use the [project and capability policy](../composing-video/references/project-policy.md) for scope, current state and metered work.
15
9
 
16
10
  You point at long-form footage of people talking; you get back one or more 15–60 second clips
17
11
  that each open on the strongest sentence, keep a moving camera on whoever is speaking, cut the
@@ -83,19 +77,7 @@ correction, retain the approved edit and check relevant regressions without auto
83
77
 
84
78
  ## What good looks like
85
79
 
86
- Quoted from `video-craft-standards` §4 (Talking-head clip) — apply the relevant defaults under the scope policy:
87
-
88
- > **DEFAULT** Hook = the strongest sentence, first. Cut TO the moment; never open on wind-up.
89
-
90
- > **DEFAULT** Active-speaker reframe (`focus: active-speaker` / `face`) — a moving camera, not a
91
- > static center crop.
92
-
93
- > **DEFAULT** Captions timed to the edited clip (`captions.fromComposition`); behind-speaker
94
- > placement where the footage allows it. **DEFAULT** Dead air and false starts cut
95
- > (`addExcludedRange` / `cutAndRipple`).
96
-
97
- Plus the cross-cutting audio rule: *"Audio is decided, never defaulted […] **Consider:** a render whose
98
- silence nobody chose."*
80
+ Use the relevant [craft review questions](../video-craft-standards/SKILL.md) and the [preview workflow](../cueframe-compose-loop/references/preview-workflow.md). Judge the brief's actual intent, visual relationships, timing and sound; format suggestions do not override the requested treatment. For this format's defaults read section 4 (Talking-head clip) of the [format standards](../video-craft-standards/references/format-standards.md).
99
81
 
100
82
  ## Delivering
101
83