flomotion 0.2.0 → 0.4.0

package/skills/flomotion-studio/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: flomotion-studio
+description: Produce professional SaaS promo and explainer videos with the flomotion MCP tools (the video is one TSX file, rendered by HyperFrames). Use when the user asks for a promo, ad, explainer, product video, kinetic-type video or motion graphics. Enforces a gated workflow, looks, scene blocks, and automatic quality checks.
+---
+
+# flomotion-studio
+
+You turn a brief into a finished, professional video through the flomotion MCP tools (the `flomotion` package, `flomotion mcp`). This skill exists to **constrain** you: you do not freestyle. You pick a style family, a look, a story template and scene blocks, fill their parameters, run the checks, and show the person drafts at fixed gates.
+
+## Hard rules (never break)
+
+0. **Interview first, extensively.** On every new video request, run the full interview in `references/interview.md` before any design work: short batches, adaptive follow-ups, a clarity score, and a read-back the person approves. Do not start G1 until clarity is >= 90% and the read-back is approved. If the person's first message already answers a lot, still confirm it back; never skip the read-back.
+1. **Never invent the brief.** Product, audience, claims, numbers, customer names and quotes come only from the person. If a fact is missing, ask or leave a visible placeholder. Never fabricate stats, testimonials or logos.
+2. **Original work only.** The reference catalogue (`dataset/`, `references/catalogue.md`) records *patterns* seen in public ads. Never reproduce another brand's logos, footage, music, UI, slogans, characters or exact layouts. Examples and test content use invented brands.
+3. **Start from structure, not a blank canvas.** Every video has: one style family, one look, one story template, and every scene is a named block (`references/blocks.md`). Custom scenes only when no block fits, and you must say why.
+4. **Text discipline.** One idea per scene. Headline beats are 6 words or fewer (8 max). No paragraphs. Max 2 type families from the active look.
+5. **Palette and fonts come from the look.** No colors, fonts or easings outside it.
+6. **You cannot hear or judge taste.** You can measure, render frames, read frames as images, and run checks. Everything subjective (look choice, font pairing, sound choice, "does it feel right") goes into a **Needs your review** list. Never claim a video "sounds good" or "looks great".
+7. **Verify, do not claim.** After each scene run `lint`; before showing a draft run `review`. Report what ran and what you saw. If something is unverified, say so. `review` computes 17 checks itself; the rest of `references/checks.md` you compute from `project_read` and frames (the table says which). A check that no one ran is reported as "not run", never as passed.
+7a. **Setup and the person's own material.** At the very start call `setup_status`, tell the person what is missing, and let them choose how to supply voice, transcript, sound effects and graphics (their own files are always an option). Keys are added by the person with `flomotion setup`; never ask for a key in the chat. Their rights statements are theirs: ask "yours, or licensed to you?" before importing, and ask permission before capturing their site or using another company's logo.
+7b. **Money and the network.** `voice_generate` only after `voice_quote`, the person's yes, and `confirm:true`. The server refuses otherwise (`quote_required`); never work around it. Sounds and fonts are fetched only through `sound_get` and `font_get`, which write the ledger.
+8. **Stop at every gate** (see `references/workflow.md`) and wait for approval. In unattended runs, state the reading you took and continue; stop only at irreversible or paid steps (voice generation, final render to a shared location).
+9. **Licensing.** Every sound, font and asset must be in the ledger with license data. No unlicensed assets. Required attributions go in the license report.
+10. **Determinism.** No `Math.random`, `Date.now`, or unseeded noise. All motion is a function of time.
+11. **Claims you can back.** Every number and promise on screen or in the voice is checked first (a count from `tools/list` or `review`, a figure the person gave with a source). If it cannot be checked, cut it or rewrite it as something that can; say what you checked in `LOG.md`. See `references/script-craft.md`.
+
+## Workflow (summary — full detail in `references/workflow.md`)
+
+| Gate | You produce | Person approves |
+|---|---|---|
+| G0 Interview | Multi-round interview (`references/interview.md`), `interview.md` log, `brief.md`, clarity score, read-back | The read-back (brief) |
+| G1 Direction | Style family, look, story template, one-line concept, hook options (3) | Direction |
+| G2 Script | Script with beat list, on-screen text per beat, voiceover | Script |
+| G3 Style frames | 3 to 5 key frames rendered in the chosen look | Look |
+| G4 Storyboard | Beat table: block, duration, motion, sound tags | Storyboard |
+| G5 Draft | Draft render + contact sheet + `review` results + Needs-your-review list | Draft |
+| G6 Final | Final render + license report + changelog of fixes | Final |
+
+## How to choose (decision order)
+
+0. Read `ideas.md` if it exists (the person's brainstorm notes, see `references/storyboard.md`) and the quality bar in `references/clean-styles.md`.
+1. `references/decision-tables.md` → style family and story template from the brief.
+2. `references/styles.md` → the family's recipe (structure, design, motion, sound).
+3. `references/looks.md` + `looks/*.md` → pick a look. Do not build a new look unless the person supplied direction notes.
+4. `references/story-templates.md` → beat sheet with duration ranges.
+5. `references/blocks.md` → block per beat with parameters.
+6. `references/script-craft.md` + `references/copywriting.md` → write hook, pain, turn, promise, proof, reveal, CTA.
+7. `references/motion.md`, `references/typography.md`, `references/sound.md` → motion, type and sound rules.
+8. `references/checks.md` + `references/review.md` → run and report quality checks.
+9. `references/anti-patterns.md` → scan before every draft.
+
+## Reference index (load only what the current step needs)
+
+| File | Use it for |
+|---|---|
+| `references/interview.md` | The extensive interview: rounds, question bank, clarity score, read-back |
+| `references/workflow.md` | Gates, unattended behavior |
+| `references/catalogue.md` | What the 8 reference ads do (pattern source) |
+| `references/patterns.md` | 21 rules distilled from the catalogue |
+| `references/styles.md` | 7 style-family recipes |
+| `references/looks.md` | Look token spec and the 3 starter looks |
+| `references/blocks.md` | 13 core and 13 extra scene blocks with parameters |
+| `references/story-templates.md` | 15 s, 30 s, 45 s beat sheets and variants |
+| `references/decision-tables.md` | Brief → style, look, template, blocks |
+| `references/copywriting.md` | Hook types, word limits, sentence-splitting, proof, CTA |
+| `references/script-craft.md` | The engineered script: hook, pain, turn, promise, proof, reveal, CTA, timing, audit |
+| `references/clean-styles.md` | What clean, catchy motion looks like (from three reference pieces) and how to apply it |
+| `references/storyboard.md` | The Storyboard tab: `ideas.md`, `storyboard.md`, how the board shows what is built |
+| `references/motion.md` | Easing, timing, blur, impacts, 8-direction, transitions |
+| `references/transitions.md` | Signature transitions with TSX: slab, iris, stripes, halves, the two-dots turn, the vault door, the mascot |
+| `references/typography.md` | Scale, emphasis methods, format minimums |
+| `references/sound.md` | Sound palettes, impact placement, mix targets, licensing |
+| `references/checks.md` | The 23 automatic checks |
+| `references/review.md` | Review protocol, rating rubric, fix loop |
+| `references/anti-patterns.md` | Concrete mistakes with before and after |
+| `references/mcp-tools.md` | The real flomotion tool list, call order, error codes |
+| `references/assets.md` | Where every graphic comes from (icons, logos, screenshots, photos), the asset plan, permission rules |
+| `references/block-recipes.md` | TSX recipes for the 13 core blocks, built from real components |
+| `references/components.md` | Every component and effect with its props (generated from the schemas: do not edit) |
+| `config/thresholds.md` | All numeric defaults (tunable) |
+| `dataset/` | Annotation schema, reference annotations, rating sheet |
+| `evals/` | 10 test briefs and the evaluation procedure |
+
+## Live view
+
+The person can watch your progress in a browser: `flomotion ui` in the project folder (or the `ui` address `project_read` returns when the server was started with `--ui`). It opens on the **Storyboard** tab: the person's ideas (`ideas.md`) and your plan (`storyboard.md`) as a timeline that turns green as you build. It shows each tool call as you make it, the scene outline and timeline, the latest frames, review results, and the gate files you write (`brief.md`, `script.md`, `storyboard.md`, `LOG.md`). Tell them once at G0 that it exists. Keep those files current: the page shows gate progress from them.
+
+## Output style
+
+Be brief in chat. Show tables for beats and results. At each gate end with the single decision you need. Never paste long code to the person; write it to the project through the tools.

package/skills/flomotion-studio/config/thresholds.md

@@ -0,0 +1,191 @@
+# Thresholds
+
+All values are initial proposals. Tune from rendered results and human ratings. Never hard-code these elsewhere. Every numeric default the checks use lives here.
+
+| Field | Value |
+| --- | --- |
+| fps | 30 |
+
+## durations_s
+
+| Field | Value |
+| --- | --- |
+| short | 15 |
+| standard | 30 |
+| long | 45 |
+| tolerance | 2 |
+
+## scene
+
+| Field | Value |
+| --- | --- |
+| min_s | 1.0 |
+| typical_min_s | 1.5 |
+| typical_max_s | 4.0 |
+| max_s | 6.0 |
+| hook_max_s | 3.0 |
+| cta_min_s | 2.0 |
+
+## motion
+
+| Field | Value |
+| --- | --- |
+| first_motion_max_s | 0.3 |
+| max_static_s | 0.5 |
+| novelty_window_s | 2.0 |
+| min_new_elements_per_window | 1 |
+| motion_blur_shutter_deg | 180 |
+| overshoot_max_pct | 8 |
+
+### transition_s
+
+| Field | Value |
+| --- | --- |
+| min | 0.25 |
+| max | 0.7 |
+
+### stagger_ms
+
+| Field | Value |
+| --- | --- |
+| min | 40 |
+| max | 120 |
+
+## text
+
+| Field | Value |
+| --- | --- |
+| headline_words_max | 6 |
+| headline_words_hard_max | 8 |
+| words_per_scene_max | 12 |
+| reading_wps_max | 3.0 |
+| caption_wps_max | 3.5 |
+| families_max | 2 |
+| contrast_ratio_min | 4.5 |
+| contrast_ratio_large_min | 3.0 |
+| large_text_px | 48 |
+
+### min_px
+
+#### 9:16
+
+| Field | Value |
+| --- | --- |
+| headline | 72 |
+| body | 44 |
+| caption | 40 |
+
+#### 16:9
+
+| Field | Value |
+| --- | --- |
+| headline | 64 |
+| body | 36 |
+| caption | 34 |
+
+#### 1:1
+
+| Field | Value |
+| --- | --- |
+| headline | 64 |
+| body | 38 |
+| caption | 36 |
+
+#### 4:5
+
+| Field | Value |
+| --- | --- |
+| headline | 68 |
+| body | 40 |
+| caption | 38 |
+
+## safe_area_px
+
+### 9:16
+
+| Field | Value |
+| --- | --- |
+| top | 250 |
+| bottom | 380 |
+| left | 64 |
+| right | 64 |
+
+### 16:9
+
+| Field | Value |
+| --- | --- |
+| top | 54 |
+| bottom | 54 |
+| left | 96 |
+| right | 96 |
+
+### 1:1
+
+| Field | Value |
+| --- | --- |
+| top | 54 |
+| bottom | 54 |
+| left | 54 |
+| right | 54 |
+
+### 4:5
+
+| Field | Value |
+| --- | --- |
+| top | 150 |
+| bottom | 250 |
+| left | 54 |
+| right | 54 |
+
+## sync
+
+| Field | Value |
+| --- | --- |
+| voice_tolerance_frames | 3 |
+| impact_sound_tolerance_frames | 2 |
+
+## audio
+
+| Field | Value |
+| --- | --- |
+| target_lufs | -14 |
+| lufs_tolerance | 1.0 |
+| true_peak_dbtp_max | -1.0 |
+| voice_over_music_db_min | 12 |
+| duck_attack_ms | 80 |
+| duck_release_ms | 400 |
+
+### bus_levels_db
+
+| Field | Value |
+| --- | --- |
+| voice | -3 |
+| music | -18 |
+| sfx | -10 |
+
+## color
+
+| Field | Value |
+| --- | --- |
+| palette_tolerance_deltaE | 12 |
+
+### grain_opacity_pct
+
+| Field | Value |
+| --- | --- |
+| min | 3 |
+| max | 8 |
+
+## layout
+
+| Field | Value |
+| --- | --- |
+| text_overlap_iou_max | 0.0 |
+| clip_tolerance_px | 0 |
+
+## determinism
+
+| Field | Value |
+| --- | --- |
+| sample_frames | 12 |
+| max_pixel_diff | 0 |

package/skills/flomotion-studio/dataset/annotations/ansarada.md

@@ -0,0 +1,53 @@
+# Reference annotation: Ansarada
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | ansarada |
+| brand | Ansarada |
+| source | user-collected stills from a compilation, rank 1 in overlay |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | S1 |
+| confidence | M |
+| rating | none |
+| rating_notes | none |
+| pain_share | 0.15 |
+| turn | split-wipe match-cut on shared circular geometry (dark to light) |
+| motif | circle (wheel to vault door) |
+| palette_source | single-accent |
+| palette_notes | black/dark red then white and light grey; one lime accent after the turn |
+| type_notes | large neo-grotesque, left aligned, generous space |
+| text_emphasis | scale, contrast of dark vs white worlds |
+| grain | heavy |
+| blur_on_motion | none |
+| sentence_split | none |
+| human_presence | none |
+| ui_fidelity | skeleton |
+| transitions | split-wipe match-cut, door open reveal |
+| proof_type | credential |
+| sound_notes | none |
+| patterns | 1, 2, 3, 4, 5, 6, 7, 13, 21 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | pain | MetaphorImage | none | grainy B/W roulette wheel, red tint, close camera |
+| 2 | turn | WipeMatchCut | none | vertical split; wheel center matches vault door center; dark to white |
+| 3 | promise | Promise | Hello simple and secure data rooms | black text on white, left aligned |
+| 4 | product | Reveal3D | none | white 3D vault door opening onto glowing lime disc |
+| 5 | product | DeviceMock | none | tilted laptop, skeleton UI with colored status pills |
+| 6 | product | DeviceMock | none | same UI on phone |
+| 7 | brand | LogoCard | none | black logo on white |
+| 8 | proof | ProofCredential | First data room to be ISO 27001:2022 certified | large black text on white |
+
+## Lessons
+
+- pain can be an image, not words
+- match-cut on shared geometry makes the turn feel designed
+- skeleton UI hides complexity
+- proof is a concrete credential

package/skills/flomotion-studio/dataset/annotations/canva.md

@@ -0,0 +1,49 @@
+# Reference annotation: Canva (video)
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | canva |
+| brand | Canva (video) |
+| source | user-collected stills from a compilation, rank 6 in overlay |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | S6 |
+| confidence | M |
+| rating | none |
+| rating_notes | none |
+| pain_share | 0.2 |
+| turn | real footage to product prompt using the same footage |
+| motif | the footage itself |
+| palette_source | mixed |
+| palette_notes | warm real colors in footage; clean white UI with purple accent; teal-violet gradient end card |
+| type_notes | script logotype on footage; plain sans in UI |
+| text_emphasis | none |
+| grain | none |
+| blur_on_motion | none |
+| sentence_split | none |
+| human_presence | story |
+| ui_fidelity | stylized |
+| transitions | footage to UI thumbnails |
+| proof_type | none |
+| sound_notes | none |
+| patterns | 4, 15, 16 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | hook | HumanMoment | none | woman chopping vegetables, phone held in her mouth to film; script logotype overlay |
+| 2 | pain | HumanMoment | none | wide shot with ring light |
+| 3 | bridge | CursorTag | none | overhead hands, purple selection frame, green cursor, name tag |
+| 4 | product | PromptUI | What's the topic of your video? / Sunday slow food energ/ | white prompt box, four thumbnails from the same footage, option chips |
+| 5 | brand | LogoPill | Canva Video | teal-to-violet gradient, white pill |
+
+## Lessons
+
+- story first, product as a simple prompt
+- footage becomes the UI input
+- cursor name tag as a character

package/skills/flomotion-studio/dataset/annotations/clickup.md

@@ -0,0 +1,60 @@
+# Reference annotation: ClickUp
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | clickup |
+| brand | ClickUp |
+| source | user-collected stills from a compilation, rank 3 in overlay |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | S3 |
+| confidence | M |
+| rating | none |
+| rating_notes | none |
+| pain_share | 0.5 |
+| turn | palette flip: monochrome thin line to saturated grained gradient; line ends as the period |
+| motif | continuous black/white line with round head |
+| palette_source | mixed |
+| palette_notes | pain: white/black/pale pink and dark space; solution: magenta-orange-violet gradient with grain |
+| type_notes | tight-tracked geometric sans; grey lead-in, black or white payoff; tilt for energy |
+| text_emphasis | grey to black, scanline strike, word swap |
+| grain | heavy |
+| blur_on_motion | yes |
+| sentence_split | none |
+| human_presence | none |
+| ui_fidelity | stylized |
+| transitions | wedge wipe, line sweep, card fly-through with blur |
+| proof_type | none |
+| sound_notes | none |
+| patterns | 3, 4, 5, 7, 8, 9, 10, 13, 14, 19, 21 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | pain | OverwhelmDiagram | Work Sprawl is killing us. | unreadable diagram of boxes and red arrows behind huge title |
+| 2 | bridge | MotifLine | none | thick black line with round head, speed streaks |
+| 3 | pain | PainFlavor | Too many apps... | app icons tangled on the line with badges and warnings |
+| 4 | bridge | Bridge | none | dark wedge narrows to the line's head and wipes to white |
+| 5 | pain | PainFlavor | Too many AI tools... | dark starry bg, line loops through AI logos |
+| 6 | pain | QuestionBubbles | Context is lost. | chat-like bubbles of questions along the line |
+| 7 | promise | TextSwap | Work sprawl kills human productivity / AI productivity | grey lead-in, bold black payoff; tilted; swap |
+| 8 | turn | Bridge | It's time to kill sprawl. | pale gradient; the line ends as the period |
+| 9 | other | StrikeText | kill Sprawl | scanline glitch strike |
+| 10 | product | CardGrid | none | saturated magenta/orange/purple grained gradient; cards fly with heavy motion blur; grid of mini-apps |
+| 11 | promise | Hook | A New Era of AI | soft white star blob on gradient |
+| 12 | promise | OrbitCards | A New Era of Craft & Quality | metal-edged cards orbit the text |
+| 13 | brand | VersionBadge | ClickUp 4.0 / AI Workspace | logo with version badge; motion-blurred text |
+| 14 | product | CardGrid | none | tilted isometric UI card wall |
+
+## Lessons
+
+- one continuous motif ties scenes
+- pain takes about half the runtime in several flavors
+- palette flip marks the turn
+- template reuse with a word swap
+- text strike for kill

package/skills/flomotion-studio/dataset/annotations/gemini-stub.md

@@ -0,0 +1,39 @@
+# Reference annotation: Google Gemini (stub)
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | gemini-stub |
+| brand | Google Gemini (stub) |
+| source | one frame only: bold white 'powerful tools' over a dark mascot silhouette on violet; overlay '#8 Google Gemini' |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | unknown |
+| confidence | L |
+| rating | none |
+| rating_notes | need more frames to annotate |
+| pain_share | none |
+| turn | none |
+| motif | none |
+| palette_source | none |
+| palette_notes | violet, near-black |
+| type_notes | heavy white geometric sans, tight tracking, overlaps a dark shape |
+| text_emphasis | none |
+| grain | none |
+| blur_on_motion | none |
+| sentence_split | none |
+| human_presence | none |
+| ui_fidelity | none |
+| transitions | none |
+| proof_type | none |
+| sound_notes | none |
+| patterns | 2 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | other | none | powerful tools | giant white geometric text over a dark mascot shape on violet |

package/skills/flomotion-studio/dataset/annotations/monday.md

@@ -0,0 +1,51 @@
+# Reference annotation: monday.com
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | monday |
+| brand | monday.com |
+| source | user-collected stills from a compilation, rank 5 in overlay |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | S5 |
+| confidence | M |
+| rating | none |
+| rating_notes | none |
+| pain_share | 0.0 |
+| turn | none |
+| motif | colored status cells |
+| palette_source | mixed |
+| palette_notes | pastel lavender/blue gradient; saturated status colors (green, orange, red, blue, pink) as the signature |
+| type_notes | clean geometric sans, large board title |
+| text_emphasis | color blocks as data |
+| grain | none |
+| blur_on_motion | yes |
+| sentence_split | none |
+| human_presence | talking-head |
+| ui_fidelity | real |
+| transitions | blur-in staggered rows, circle-to-cell morph |
+| proof_type | none |
+| sound_notes | none |
+| patterns | 4, 12, 13, 14 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | hook | Spokesperson | none | man talking to camera in an open-plan office |
+| 2 | brand | BrandPill | none | logo on a frosted glass pill over a pastel gradient |
+| 3 | product | UIZoom | none | board UI with colored status and priority cells, avatars |
+| 4 | product | UIZoom | none | dashboard widgets: progress bar, revenue vs goal, trend line |
+| 5 | product | ChatDemo | Please collect all live Q4 projects into one board / Sure, I'm on it! | AI assistant chat |
+| 6 | product | CellFill | none | board builds itself: circles morph into filled cells, avatars slide in |
+
+## Lessons
+
+- demo-led: UI crops are the content
+- AI request/response in plain language
+- shape morph as progress
+- color-coded cells make the product recognizable

package/skills/flomotion-studio/dataset/annotations/phantom.md

@@ -0,0 +1,53 @@
+# Reference annotation: Phantom (wallet)
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | phantom |
+| brand | Phantom (wallet) |
+| source | user-collected stills; overlay says '#8 Google Gemini' but on-screen brand is Phantom (label mismatch to confirm) |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | S7 |
+| confidence | M |
+| rating | none |
+| rating_notes | none |
+| pain_share | 0.25 |
+| turn | old grey small windows to big saturated 3D object |
+| motif | the 3D wallet object |
+| palette_source | single-accent |
+| palette_notes | electric violet alternating with pure black; white text |
+| type_notes | big lowercase geometric sans, white |
+| text_emphasis | short lines of 2-4 words, lowercase |
+| grain | none |
+| blur_on_motion | none |
+| sentence_split | none |
+| human_presence | none |
+| ui_fidelity | stylized |
+| transitions | color flip, 3D tumble, burst |
+| proof_type | none |
+| sound_notes | none |
+| patterns | 2, 3, 7, 17, 18, 19, 20, 21 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | pain | OldWay | none | three plain grey desktop windows: connect, collections, gas fee table |
+| 2 | turn | ClaimWith3D | a home for your NFTs | violet screen, black circle with glassy 3D NFT frame and props |
+| 3 | product | GestureCallout | Pin it! | phone long-press menu with bubble and touch ripple |
+| 4 | promise | WordBeat | one wallet | black screen, 3D bits orbit |
+| 5 | product | Object3D | none | 3D purple wallet with app cards sliding in and out |
+| 6 | product | WordBeat | drag | floating coins, large blobs, black corner |
+| 7 | promise | Burst | a wallet you'll love | radial black dashes behind the wallet |
+| 8 | cta | UrlCard | phantom.app | white on black |
+
+## Lessons
+
+- old way small and grey, new way big and colored
+- 2 to 4 word lines
+- gesture callouts
+- URL end card

package/skills/flomotion-studio/dataset/annotations/slack.md

@@ -0,0 +1,54 @@
+# Reference annotation: Slack
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | slack |
+| brand | Slack |
+| source | user-collected stills from a compilation, rank 2 in overlay |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | S2 |
+| confidence | M |
+| rating | none |
+| rating_notes | none |
+| pain_share | 0.0 |
+| turn | question to answered-by-customers |
+| motif | logo-color palette and rounded shapes |
+| palette_source | per-scene-blocks |
+| palette_notes | pink, green, blue, yellow, purple blocks (logo colors); dark maroon / dark green text with white payoff words |
+| type_notes | giant geometric sans, cropped at frame edges; product UI font in the search box |
+| text_emphasis | color (white payoff words), gesture (selection box, magnifier) |
+| grain | none |
+| blur_on_motion | none |
+| sentence_split | none |
+| human_presence | b-roll |
+| ui_fidelity | stylized |
+| transitions | color-block cuts, shape assembly |
+| proof_type | named customers |
+| sound_notes | none |
+| patterns | 1, 2, 6, 10, 13, 14, 17 |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | brand | LogoCard | none | logo with parent-company lockup on white |
+| 2 | hook | TypedQuery | Is Slack changing the way businesses do business? | typed in a purple search field, extreme close crop, caret |
+| 3 | proof | LogoSwap | Just ask Roku | customer logo replaces a word; blurred footage behind; white type |
+| 4 | proof | QuoteCard | Things move faster because everything is in one place. | pink block, key words white, attribution lockup (logo, name, title) |
+| 5 | proof | LogoSwap | And Canva / And Signable | roll call over b-roll with logo-in-sentence |
+| 6 | proof | QuoteCard | Slack has been a huge part of how we're building for scale | green block; selection box and cursor land on the word scale |
+| 7 | product | SpotlightWord | none | magnifier reveals white letters on blue |
+| 8 | product | CardCollage | none | tight crop of colorful UI cards (stats, rocket, table) |
+| 9 | brand | ShapeLogo | none | logo assembled from large colored shapes |
+
+## Lessons
+
+- proof through other people's voices
+- one color world per scene
+- key word in white, lead-in dark
+- brand built from motion shapes

package/skills/flomotion-studio/dataset/annotations/unknown-7.md

@@ -0,0 +1,39 @@
+# Reference annotation: unidentified (overlay '#7 -' cropped)
+
+Patterns seen in a public ad, annotated from stills. Never reproduce another brand's work (see `SKILL.md` rule 2).
+
+| Field | Value |
+| --- | --- |
+| id | unknown-7 |
+| brand | unidentified (overlay '#7 -' cropped) |
+| source | one frame only: live-action boardroom, man with white hair and glasses mid-shout, blurred foreground head, cool grey grade |
+| url | none |
+| format | 16:9 |
+| duration_s | none |
+| platform | none |
+| style_family | unknown |
+| confidence | L |
+| rating | none |
+| rating_notes | identify the ad and send more frames |
+| pain_share | none |
+| turn | none |
+| motif | none |
+| palette_source | none |
+| palette_notes | cool grey blue grade |
+| type_notes | none |
+| text_emphasis | none |
+| grain | none |
+| blur_on_motion | none |
+| sentence_split | none |
+| human_presence | story |
+| ui_fidelity | none |
+| transitions | none |
+| proof_type | none |
+| sound_notes | none |
+| patterns |  |
+
+## beats
+
+| n | role | block | text | notes |
+| --- | --- | --- | --- | --- |
+| 1 | other | none | none | cinematic live action, shallow depth of field, dramatic performance |