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.
- package/README.md +8 -0
- package/dist/analyze-C3MSCON6.js +2 -0
- package/dist/{chunk-M3NS5UR2.js → chunk-OAJBHFAJ.js} +6 -6
- package/dist/cueframe.js +46 -46
- package/dist/skills/add-music-bed/SKILL.md +5 -23
- package/dist/skills/brand-reel/SKILL.md +5 -28
- package/dist/skills/clip-a-talking-head/SKILL.md +2 -20
- package/dist/skills/composing-video/SKILL.md +36 -432
- package/dist/skills/composing-video/references/acceptance-template.md +21 -0
- package/dist/skills/composing-video/references/audio-design.md +125 -0
- package/dist/skills/composing-video/references/card-and-motion-runtime.md +49 -0
- package/dist/skills/composing-video/references/craft-principles.md +25 -0
- package/dist/skills/composing-video/references/film-planning.md +37 -0
- package/dist/skills/composing-video/references/format-decisions.md +17 -0
- package/dist/skills/composing-video/references/format-playbooks.md +96 -0
- package/dist/skills/composing-video/references/motion-design.md +25 -0
- package/dist/skills/composing-video/references/project-policy.md +18 -0
- package/dist/skills/composing-video/references/sfx-pack.md +69 -0
- package/dist/skills/composing-video/references/sound-and-timing.md +15 -0
- package/dist/skills/composing-video/references/tool-map.md +43 -0
- package/dist/skills/cueframe-brand-demo/SKILL.md +1 -7
- package/dist/skills/cueframe-cli/SKILL.md +9 -7
- package/dist/skills/cueframe-component-authoring/SKILL.md +20 -169
- package/dist/skills/cueframe-component-authoring/references/authoring-paths.md +72 -0
- package/dist/skills/cueframe-component-authoring/references/forking-and-layout.md +35 -0
- package/dist/skills/cueframe-component-authoring/references/native-component-workflows.md +98 -0
- package/dist/skills/cueframe-component-authoring/references/native-source-contract.md +54 -0
- package/dist/skills/cueframe-component-authoring/references/parented-device-card.json +13 -0
- package/dist/skills/cueframe-component-authoring/references/parented-motion.md +25 -0
- package/dist/skills/cueframe-component-authoring/references/retired-projects.md +26 -0
- package/dist/skills/cueframe-compose-loop/SKILL.md +14 -115
- package/dist/skills/cueframe-compose-loop/references/convergence-loop.md +128 -0
- package/dist/skills/cueframe-compose-loop/references/preview-workflow.md +6 -2
- package/dist/skills/cueframe-connect/SKILL.md +1 -7
- package/dist/skills/cueframe-connect/references/tools.md +6 -5
- package/dist/skills/cueframe-product-video/SKILL.md +1 -7
- package/dist/skills/cueframe-reference-video/SKILL.md +30 -0
- package/dist/skills/cueframe-reference-video/references/measurement-and-comparison.md +45 -0
- package/dist/skills/cueframe-reference-video/scripts/motion-grid.sh +116 -0
- package/dist/skills/cueframe-scene-shot/SKILL.md +2 -8
- package/dist/skills/cueframe-storyboard/SKILL.md +1 -7
- package/dist/skills/every-format-from-one-edit/SKILL.md +3 -19
- package/dist/skills/extracting-brand-kits/SKILL.md +1 -7
- package/dist/skills/launch-video/SKILL.md +6 -26
- package/dist/skills/make-a-social-reel/SKILL.md +7 -26
- package/dist/skills/rebrand-a-video/SKILL.md +2 -19
- package/dist/skills/video-craft-standards/SKILL.md +20 -103
- package/dist/skills/video-craft-standards/references/format-standards.md +118 -0
- package/package.json +4 -4
- 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
|
-
|
|
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
|
|
21
|
-
>
|
|
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.
|
|
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
|
-
|
|
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
|
-
|
|
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. **
|
|
72
|
-
final lockup; describe each still
|
|
73
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|