wizz-method 2.15.0 → 2.17.0

package/src/skills-lib/wizz-video-styles/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: wizz-video-styles
+description: Catalogue of short vertical video styles (Reels, Shorts, TikTok) measured on real high-reach videos, for any niche. Takes an inventory of the material the project actually has (a real person on camera, voice only, b-roll, app screens, a physical product), crosses it with niche and goal, picks the style to copy and hands over its recipe - rhythm, captions, palette, typography, motion vocabulary, music and SFX rules - plus a Remotion template when one exists and a licensed audio kit. Use when a video is about to be edited or planned and nobody has decided what it should look like, when someone says a video "looks amateur" or asks to copy a creator's style, or before wizz-video-effects and Remotion take over. Triggers - estilo do vídeo, editar no estilo de, copiar a edição de, que estilo usar no reel, referência de edição, catálogo de estilos, o vídeo ficou amador. Does not decide per-event SFX or gates (that is wizz-video-effects) and does not assemble the film (that is Remotion).
+---
+
+# wizz-video-styles: which style to copy, and its recipe
+
+Every number in this skill was measured on a real public short ([references/research-method.md](references/research-method.md)). A style that has no measured reference does not enter the catalogue. When a number below was not measured, the page says so.
+
+## Where it sits in the video pipeline
+
+1. Script exists (social area, `wizz-social-content`).
+2. **This skill:** inventory of the material, then style, then recipe.
+3. Narration and word timing (the person's own recording or TTS, then `ctc-align`).
+4. Footage and screens: `get-brolls` for b-roll, HyperFrames for silent screens, real screenshots for app screens.
+5. Effects and sound per event, plus gates: `wizz-video-effects`. Pass it this style's SFX density ceiling and music level.
+6. Assembly in Remotion: invoke `wizz-remotion-best-practices`; copy the style's template from `assets/remotion/` when it has one.
+
+It can also run at step 1, so the script is written for the style (room for b-roll, a hook that the style can show).
+
+## Per piece
+
+1. **Inventory first, always.** Ask or read from the plan, one line each:
+   - Is a real person on camera? Which shots exist (face to camera, podcast, stage, street, hands only)?
+   - Voice: the person's own recording, a podcast/interview track, TTS, or none?
+   - Screens: app or site screenshots, terminal, documents? (Capture screens as screenshots; a browser screen *recording* can come out stretched.)
+   - B-roll or stock, a physical product, food, a place?
+   - Niche, goal of the piece (follow, comment, save, click), duration.
+   Never pick a style the material cannot feed. "Talking head" needs a person on camera; "motion editorial" needs nothing but a voice; "macro / ASMR" needs a physical product filmed close.
+2. **Pick the style** with [references/style-picker.md](references/style-picker.md): material decides which styles are possible, niche and goal rank them. Mixed is allowed and common: person on camera for the hook and the CTA, another style in the middle.
+3. **Open the style card** in `references/styles/` and follow it: rhythm, captions, palette, typography, motion, music, SFX, hook, CTA, and its "do not" list.
+4. **Watch two of its references** (links in the card) before editing. Reading a card is not watching a video.
+5. **Audio:** music and SFX choices from [references/audio.md](references/audio.md); the redistributable kit is in `assets/audio/` (credits in `assets/audio/CREDITS.md`).
+6. **Hand over** to `wizz-video-effects` with the card's SFX ceiling and music level, then to Remotion.
+7. **Look at the final file**: extract frames and compare them side by side with a contact sheet of one reference.
+
+## What the measurements say across every style
+
+- **SFX are rare.** Across 99 measured shorts, sound effects landed on a cut in a small minority of cuts (per-style counts in each card). Putting a sound on every cut is the most common amateur tell.
+- **Music bed: style-dependent.** Fast montage, animated explainers and travel POV carry a continuous bed; talking heads and podcast clips mostly have none or a faint one.
+- **Captions** in reach-heavy styles are 1 to 3 words at a time, bold, lower-centre, with one keyword in an accent colour; editorial and explainer styles keep them small or drop them.
+- **Rhythm is a style property, not a virtue.** The highest-reach videos in the set range from single takes with no detected cut to a cut every second.
+
+Details and the per-style table: [references/measured-patterns.md](references/measured-patterns.md).
+
+## References
+
+| File | Answers |
+|---|---|
+| [references/style-picker.md](references/style-picker.md) | **start here.** Material and niche → which styles |
+| [references/styles/](references/styles/) | one card per style: recipe, references, do-not list |
+| [references/measured-patterns.md](references/measured-patterns.md) | the numbers behind the cards, per style and per niche |
+| [references/audio.md](references/audio.md) | music and SFX per style, the kit, libraries and licences |
+| [references/research-method.md](references/research-method.md) | how the catalogue was measured, its limits, how to add a niche or a style |
+| `data/references.json` | every measured short: link, channel, views, niche, style, metrics |
+| `scripts/analyze.sh` | measures one short (cuts, music bed, SFX heuristics, loudness, contact sheet) |
+| `assets/remotion/editorial/` | Remotion template of the motion editorial style |
+| `assets/audio/` | licensed music beds and SFX that may ship with a project |
+
+## Out of scope
+
+- Which SFX plays on which event, ducking, loudness and safe-zone gates: `wizz-video-effects`.
+- Assembling the film and the `<Audio>` API: `wizz-remotion-best-practices`.
+- Script, hook wording, CTA wording: `wizz-social-content` and the copy area.
+- Sourcing b-roll: `get-brolls`. Drawing silent screens: HyperFrames.
+- Launch films with art direction: `wizz-huashu-design`.

package/src/skills-lib/wizz-video-styles/assets/audio/CREDITS.md

@@ -0,0 +1,54 @@
+# Audio kit credits
+
+Licence checked on each source's page on 2026-10-04. Only CC0 / public domain or CC BY 4.0 files are included.
+Freesound source: downloading the original requires login, so the public HQ mp3 preview that the page itself exposes was used (lower quality than the original; re-encoded at 160 kbps).
+Kenney: CC0 licence confirmed on each pack's page and in the zip's `License.txt`.
+
+| File | Original title | Author | Licence | Source page | Checked on | Changes |
+|---|---|---|---|---|---|---|
+| `music/piano-editorial.mp3` | Erik Satie - Gymnopédies - la 1ère. Lent et douloureux | Robin Alciatore (Musopen); composition by Erik Satie | [Public domain (dedicated by the recording's author)](https://commons.wikimedia.org/wiki/File:Erik_Satie_-_gymnopedies_-_la_1_ere._lent_et_douloureux.ogg) | https://commons.wikimedia.org/wiki/File:Erik_Satie_-_gymnopedies_-_la_1_ere._lent_et_douloureux.ogg | 2026-10-04 | cut 0-70 s, fade-in 0.5 s, fade-out 2 s, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/lofi-chill.mp3` | Lofi Hip Hop Loop | omfgdude | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://opengameart.org/content/lofi-hip-hop-loop | 2026-10-04 | cut 0-70 s, fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/tech-pulse.mp3` | Synthwave House Loop | Fupi | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://opengameart.org/content/synthwave-house-loop | 2026-10-04 | original of 50.5 s repeated 2x and cut to 70 s (seam at the loop point), fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/corporate-light.mp3` | Feel good slow ambient track with a beat. | annandistance | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://opengameart.org/content/feel-good-slow-ambient-track-with-a-beat | 2026-10-04 | cut 0-70 s, fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/cinematic-tense.mp3` | Hitman | Kevin MacLeod (incompetech.com) | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) | https://commons.wikimedia.org/wiki/File:Hitman_by_Kevin_MacLeod.ogg | 2026-10-04 | cut 0-70 s, fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/acoustic-lifestyle.mp3` | Sunset Plains | Yoiyami | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://opengameart.org/content/sunset-plains | 2026-10-04 | cut 10-80 s of the original WAV, fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/classical-light.mp3` | Chopin Nocturne No. 2 in E-flat Major, Op. 9 | Peter Johnston (Musopen); composition by Frédéric Chopin | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://commons.wikimedia.org/wiki/File:Chopin_Nocturne_No._2_in_E_Flat_Major,_Op._9.ogg | 2026-10-04 | cut 0-70 s, fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `music/meme-beat.mp3` | Monkeys Spinning Monkeys | Kevin MacLeod (incompetech.com) | [CC BY 4.0 (the page offers CC BY 3.0 or 4.0 at the user's choice; used under 4.0)](https://creativecommons.org/licenses/by/4.0/) | https://commons.wikimedia.org/wiki/File:Kevin_MacLeod_~_Monkeys_Spinning_Monkeys.ogg | 2026-10-04 | cut 0-70 s, fades, loudnorm -20 LUFS, mp3 160 kbps |
+| `sfx/whoosh-soft.mp3` | Whoosh | qubodup | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://freesound.org/people/qubodup/sounds/60013/ | 2026-10-04 | public HQ mp3 preview (the original download requires login); 0.45 s + 0.15 s of silence, loudnorm -16 LUFS, re-encoded to mp3 160 kbps |
+| `sfx/whoosh-fast.mp3` | swoosh.wav | Garysguff | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://freesound.org/people/Garysguff/sounds/575836/ | 2026-10-04 | public HQ mp3 preview; trim 0.30-0.75 s (first swoosh), loudnorm -16 LUFS (peak-limited), mp3 160 kbps |
+| `sfx/swoosh-text.mp3` | swish-3.wav (Swishes Sound Pack) | artisticdude | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://opengameart.org/content/swishes-sound-pack | 2026-10-04 | 0.146 s + silence padded to 0.6 s, loudnorm -16 LUFS, mp3 160 kbps |
+| `sfx/pop-bubble.mp3` | drop_003.ogg (Interface Sounds) | Kenney (kenney.nl) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://kenney.nl/assets/interface-sounds | 2026-10-04 | silence padded to 0.6 s, loudnorm -16 LUFS (peak-limited), mp3 160 kbps |
+| `sfx/click-mouse.mp3` | mouseclick1.ogg (UI Audio) | Kenney (kenney.nl) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://kenney.nl/assets/ui-audio | 2026-10-04 | silence padded to 0.6 s, loudnorm -16 LUFS (peak-limited), mp3 160 kbps |
+| `sfx/typing-short.mp3` | typing soundeffect | johndekale | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://opengameart.org/content/typing-soundeffect | 2026-10-04 | cut 0-1.6 s, loudnorm -16 LUFS (peak-limited), mp3 160 kbps |
+| `sfx/ding-notify.mp3` | confirmation_002.ogg (Interface Sounds) | Kenney (kenney.nl) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://kenney.nl/assets/interface-sounds | 2026-10-04 | silence padded to 0.6 s, loudnorm -16 LUFS, mp3 160 kbps |
+| `sfx/boom-impact.mp3` | impactPunch_heavy_000.ogg (Impact Sounds) | Kenney (kenney.nl) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://kenney.nl/assets/impact-sounds | 2026-10-04 | loudnorm -16 LUFS (peak-limited), mp3 160 kbps |
+| `sfx/riser-short.mp3` | phaserUp3.ogg (Digital Audio) | Kenney (kenney.nl) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://kenney.nl/assets/digital-audio | 2026-10-04 | silence padded to 0.6 s, loudnorm -16 LUFS, mp3 160 kbps |
+| `sfx/glitch-short.mp3` | lowRandom.ogg (Digital Audio) | Kenney (kenney.nl) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://kenney.nl/assets/digital-audio | 2026-10-04 | silence padded to 0.6 s, loudnorm -16 LUFS, mp3 160 kbps |
+| `sfx/ka-ching.mp3` | Cha Ching.wav | deleted_user_96253 (deleted account) | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://freesound.org/people/deleted_user_96253/sounds/351304/ | 2026-10-04 | public HQ mp3 preview; cut 0-2.2 s, loudnorm -16 LUFS, mp3 160 kbps |
+| `sfx/record-scratch.mp3` | Vinyl Backspin and Beat Scratch.wav | ZeSoundResearchInc. | [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) | https://freesound.org/people/ZeSoundResearchInc./sounds/117511/ | 2026-10-04 | public HQ mp3 preview; trim 0-0.65 s (first scratch), loudnorm -16 LUFS, mp3 160 kbps |
+
+## Required attribution (CC BY 4.0)
+
+Paste into the video credits or description when you use these files. The other files (CC0 and public domain) require no credit.
+
+- `music/cinematic-tense.mp3`:
+
+```
+"Hitman" Kevin MacLeod (incompetech.com)
+Licensed under Creative Commons: By Attribution 4.0 License
+http://creativecommons.org/licenses/by/4.0/
+Changes: trimmed to 70 s, fade in/out, loudness normalised to -20 LUFS.
+```
+
+- `music/meme-beat.mp3`:
+
+```
+"Monkeys Spinning Monkeys" Kevin MacLeod (incompetech.com)
+Licensed under Creative Commons: By Attribution 4.0 License
+http://creativecommons.org/licenses/by/4.0/
+Changes: trimmed to 70 s, fade in/out, loudness normalised to -20 LUFS.
+```
+
+Licence link: https://creativecommons.org/licenses/by/4.0/
+
+The Musopen recordings (Satie, Chopin) are public domain/CC0; crediting the performer is optional, not required.

package/src/skills-lib/wizz-video-styles/assets/audio/LIBRARIES.md

@@ -0,0 +1,31 @@
+# Bibliotecas para buscar mais áudio
+
+Resumos de licença abaixo vêm da checagem de 2026-10-04 (páginas dos arquivos do kit) ou, onde marcado "não verificado", do conhecimento geral. Confira a licença na página de cada arquivo antes de usar.
+
+## Pode ir no pacote (redistribuição permitida)
+
+| Biblioteca | Licença | Pode | Não pode / cuidado |
+|---|---|---|---|
+| [Kenney](https://kenney.nl/assets/category:Audio) | CC0 (confirmado) | Tudo, inclusive redistribuir e vender | nada; crédito opcional |
+| [OpenGameArt](https://opengameart.org/art-search-advanced?field_art_type_tid%5B%5D=12&field_art_licenses_tid%5B%5D=4) (filtrar CC0) | Varia por arquivo: CC0, CC-BY 3.0/4.0, OGA-BY, GPL (confirmado que varia) | CC0 sem restrição | Só CC0 ou CC-BY 4.0 no pacote; CC-BY 3.0, GPL e CC-BY-SA não entram (a pasta do kit só aceita CC0/4.0) |
+| [Freesound](https://freesound.org/search/?f=license%3A%22Creative+Commons+0%22) (filtro "Creative Commons 0") | Varia por arquivo: CC0, CC-BY, CC-BY-NC | CC0 sem restrição | Baixar o original exige login; o preview HQ mp3 é público. CC-BY-NC nunca entra |
+| [Wikimedia Commons - Musopen](https://commons.wikimedia.org/wiki/Category:Musopen) | Domínio público / CC0 por arquivo (confirmado nos arquivos do kit) | Clássicos (Satie, Chopin, Bach) | Ler a licença de cada arquivo: há versões de outros intérpretes com licença diferente |
+| [incompetech (Kevin MacLeod)](https://incompetech.com/music/royalty-free/) | CC BY 4.0 nas faixas atuais; arquivos antigos na Commons estão em CC BY 3.0 (confirmado na Commons) | Redistribuir com atribuição e indicar alterações | Exige a linha de crédito; só entra no pacote a faixa confirmada em 4.0. A página é JS, confirme na página da faixa |
+| [Free Music Archive](https://freemusicarchive.org/search?license=CC0) (filtro CC0) | Varia: CC0, CC-BY, NC, ND | CC0 sem restrição | Não verificado nesta rodada. NC/ND nunca entram |
+| [ccMixter](https://ccmixter.org/) | CC0 ou CC-BY por faixa | Idem | Não verificado nesta rodada |
+
+FreePD (freepd.com) mostrava aviso de encerramento em 2026-10-04: não usar como fonte nova. Arquivos antigos de lá só se a licença for confirmada em outra página.
+
+## Só usar no projeto (não redistribuir o arquivo)
+
+Servem para a edição de um vídeo, mas o arquivo não pode ir dentro de pacote ou repositório público. Dê só o link.
+
+| Biblioteca | Uso permitido (resumo, não verificado) | Por que fica fora do pacote |
+|---|---|---|
+| [Pixabay](https://pixabay.com/music/) | Uso comercial em projetos sem crédito | A Pixabay Content License proíbe redistribuir o arquivo isolado/como conteúdo autônomo |
+| [YouTube Audio Library](https://studio.youtube.com/channel/UC/music) | Uso em vídeos | Termos ligados à conta e ao YouTube; sem redistribuição |
+| [Uppbeat](https://uppbeat.io/) | Plano grátis com crédito e limite mensal | Licença por conta/uso, sem redistribuição |
+| [Epidemic Sound](https://www.epidemicsound.com/) | Assinatura, uso em canais licenciados | Sem redistribuição; some se a assinatura acabar |
+| [Artlist](https://artlist.io/) | Assinatura, licença perpétua para os vídeos feitos | Sem redistribuição |
+| [Mixkit](https://mixkit.co/free-stock-music/) | Uso em vídeos com a Mixkit License | Não verificado; não redistribuir como arquivo avulso |
+| [Bensound](https://www.bensound.com/) | Grátis com crédito | Licença própria, sem redistribuição |

package/src/skills-lib/wizz-video-styles/assets/audio/kit.json

@@ -0,0 +1,182 @@
+[
+  {
+    "file": "music/piano-editorial.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "piano calmo / editorial",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "Public domain (dedicado pelo autor da gravação)",
+    "fonte": "https://commons.wikimedia.org/wiki/File:Erik_Satie_-_gymnopedies_-_la_1_ere._lent_et_douloureux.ogg"
+  },
+  {
+    "file": "music/lofi-chill.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "lo-fi / chill beat",
+    "duracao_s": 70.0,
+    "lufs": -20.5,
+    "licenca": "CC0 1.0",
+    "fonte": "https://opengameart.org/content/lofi-hip-hop-loop"
+  },
+  {
+    "file": "music/tech-pulse.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "eletrônica pulsante / tech (synthwave-house 114 BPM)",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://opengameart.org/content/synthwave-house-loop"
+  },
+  {
+    "file": "music/corporate-light.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "corporativo leve / otimista (ambient com batida lenta; aproximação)",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://opengameart.org/content/feel-good-slow-ambient-track-with-a-beat"
+  },
+  {
+    "file": "music/cinematic-tense.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "cinematográfico / tenso (mistério, crime)",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "CC BY 4.0",
+    "fonte": "https://commons.wikimedia.org/wiki/File:Hitman_by_Kevin_MacLeod.ogg"
+  },
+  {
+    "file": "music/acoustic-lifestyle.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "acústico / lifestyle (violão suave + pads)",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://opengameart.org/content/sunset-plains"
+  },
+  {
+    "file": "music/classical-light.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "clássico leve (piano romântico)",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://commons.wikimedia.org/wiki/File:Chopin_Nocturne_No._2_in_E_Flat_Major,_Op._9.ogg"
+  },
+  {
+    "file": "music/meme-beat.mp3",
+    "tipo": "music",
+    "clima_ou_uso": "humor / meme (pizzicato e flautas, 144 BPM)",
+    "duracao_s": 70.0,
+    "lufs": -20.4,
+    "licenca": "CC BY 4.0",
+    "fonte": "https://commons.wikimedia.org/wiki/File:Kevin_MacLeod_~_Monkeys_Spinning_Monkeys.ogg"
+  },
+  {
+    "file": "sfx/whoosh-soft.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "whoosh suave",
+    "duracao_s": 0.6,
+    "lufs": -16.8,
+    "licenca": "CC0 1.0",
+    "fonte": "https://freesound.org/people/qubodup/sounds/60013/"
+  },
+  {
+    "file": "sfx/whoosh-fast.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "whoosh rápido",
+    "duracao_s": 0.6,
+    "lufs": -19.3,
+    "licenca": "CC0 1.0",
+    "fonte": "https://freesound.org/people/Garysguff/sounds/575836/"
+  },
+  {
+    "file": "sfx/swoosh-text.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "swoosh de texto (entrada de título)",
+    "duracao_s": 0.6,
+    "lufs": -16.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://opengameart.org/content/swishes-sound-pack"
+  },
+  {
+    "file": "sfx/pop-bubble.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "pop / bolha",
+    "duracao_s": 0.6,
+    "lufs": -19.9,
+    "licenca": "CC0 1.0",
+    "fonte": "https://kenney.nl/assets/interface-sounds"
+  },
+  {
+    "file": "sfx/click-mouse.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "clique de mouse",
+    "duracao_s": 0.6,
+    "lufs": -25.1,
+    "licenca": "CC0 1.0",
+    "fonte": "https://kenney.nl/assets/ui-audio"
+  },
+  {
+    "file": "sfx/typing-short.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "digitação curta",
+    "duracao_s": 1.6,
+    "lufs": -19.0,
+    "licenca": "CC0 1.0",
+    "fonte": "https://opengameart.org/content/typing-soundeffect"
+  },
+  {
+    "file": "sfx/ding-notify.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "ding / notificação",
+    "duracao_s": 0.6,
+    "lufs": -16.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://kenney.nl/assets/interface-sounds"
+  },
+  {
+    "file": "sfx/boom-impact.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "impacto grave (boom)",
+    "duracao_s": 0.6,
+    "lufs": -17.1,
+    "licenca": "CC0 1.0",
+    "fonte": "https://kenney.nl/assets/impact-sounds"
+  },
+  {
+    "file": "sfx/riser-short.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "riser curto",
+    "duracao_s": 0.6,
+    "lufs": -16.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://kenney.nl/assets/digital-audio"
+  },
+  {
+    "file": "sfx/glitch-short.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "glitch curto (bipes aleatórios; aproximação)",
+    "duracao_s": 0.6,
+    "lufs": -16.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://kenney.nl/assets/digital-audio"
+  },
+  {
+    "file": "sfx/ka-ching.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "ka-ching / caixa registradora",
+    "duracao_s": 2.2,
+    "lufs": -16.4,
+    "licenca": "CC0 1.0",
+    "fonte": "https://freesound.org/people/deleted_user_96253/sounds/351304/"
+  },
+  {
+    "file": "sfx/record-scratch.mp3",
+    "tipo": "sfx",
+    "clima_ou_uso": "record scratch (meme)",
+    "duracao_s": 0.7,
+    "lufs": -16.5,
+    "licenca": "CC0 1.0",
+    "fonte": "https://freesound.org/people/ZeSoundResearchInc./sounds/117511/"
+  }
+]

package/src/skills-lib/wizz-video-styles/assets/remotion/editorial/EditorialReel.tsx

@@ -0,0 +1,111 @@
+import React, { useMemo } from "react";
+import { AbsoluteFill, Audio, Sequence, interpolate, staticFile } from "remotion";
+import { Captions } from "./captions";
+import { Backdrop, Stage, clamp } from "./primitives";
+import { SceneView, type SceneDef } from "./scenes";
+import { ThemeContext, mergeTheme, type EditorialTheme } from "./theme";
+import { at, buildScenes, toFrames, totalSeconds, type WordsData } from "./timeline";
+import exampleWords from "./example-words.json";
+
+// Composição genérica do estilo "motion editorial": um objeto por vez no centro,
+// troca por transformação (cena sobe enquanto a próxima entra), música baixa contínua,
+// SFX raro, legenda pequena. Tudo que muda de vídeo para vídeo entra por props.
+
+export type SfxDef = { atWord: string; offset?: number; src: string; volume?: number; durationSec?: number };
+
+export type AudioProps = {
+  voice?: string; // staticFile, ex.: "editorial/voice.wav"
+  music?: string; // cama contínua
+  musicVolume?: number; // padrão 0.2
+  sfx?: SfxDef[]; // em ordem de aparição na fala; no máximo ~1 a cada 10 s
+};
+
+export type EditorialReelProps = {
+  words: WordsData;
+  scenes: SceneDef[];
+  theme?: Partial<EditorialTheme>;
+  audio?: AudioProps;
+  overlap?: number; // s de sobreposição entre cenas
+  tailSeconds?: number; // respiro depois da última palavra
+};
+
+export const exampleScenes: SceneDef[] = [
+  { kind: "hook", at: "I", a: "I shipped an app", b: "in one weekend." },
+  { kind: "prompt", at: "Here", a: "I only tell", b: "the agent what I want.", prompt: "build the signup page", marks: { typed: "want" }, typedMark: "typed" },
+  { kind: "phone", at: "Look", scale: 1 },
+  {
+    kind: "numbers", at: "In", chip: "48 hours",
+    marks: { c1: "31", c2: "12" },
+    counters: [{ to: 31, label: "commits", mark: "c1" }, { to: 12, label: "tests", mark: "c2" }],
+  },
+  { kind: "steps", at: "Three", prompt: "three agents", items: ["writes", "tests", "reviews"], marks: { typed: "agents" }, typedMark: "typed" },
+  {
+    kind: "doc", at: "First", title: "spec.md", altTitle: "agent coding",
+    marks: { code: "then", review: "code" },
+    pages: [
+      { lines: ["# Signup page", "", "- email and password", "- validate on submit", "- show errors inline", "- redirect to dashboard"] },
+      { mono: true, mark: "code", lines: ["export async function signUp(", "  input: SignUpInput", ") {", "  const data = schema.parse(input)", "  return createUser(data)", "}"] },
+    ],
+    reviewers: { labels: ["correctness", "security", "regression", "scope"], mark: "review" },
+  },
+  { kind: "cta", at: "Comment", a: "Comment", b: "SHIP", keyword: "SHIP", footer: "and I send you the prompt", hideCaptions: true },
+];
+
+export const exampleProps: EditorialReelProps = {
+  words: exampleWords as WordsData,
+  scenes: exampleScenes,
+  // Áudio entra por staticFile (arquivos em public/): descomente e troque os nomes.
+  // audio: { voice: "editorial/voice.wav", music: "editorial/music.mp3", sfx: [{ atWord: "Here", offset: -0.15, src: "editorial/swoosh.mp3", volume: 0.16 }] },
+};
+
+export const exampleSeconds = totalSeconds(exampleProps.words);
+
+export const EditorialReel: React.FC<EditorialReelProps> = ({
+  words, scenes, theme, audio, overlap = 0.12, tailSeconds = 1.4,
+}) => {
+  const merged = useMemo(() => mergeTheme(theme), [theme]);
+  const end = totalSeconds(words, tailSeconds);
+  const timed = useMemo(() => buildScenes(words.words, scenes, { end, overlap }), [words, scenes, end, overlap]);
+  const ctaStart = timed.find((s) => s.def.kind === "cta" && s.def.hideCaptions)?.from;
+  const sfx = useMemo(
+    () =>
+      (audio?.sfx ?? []).reduce<{ cursor: number; items: { from: number; def: SfxDef }[] }>(
+        (acc, def) => {
+          const t = at(words.words, def.atWord, acc.cursor);
+          return { cursor: t, items: [...acc.items, { from: Math.max(0, t + (def.offset ?? 0)), def }] };
+        },
+        { cursor: 0, items: [] },
+      ).items,
+    [audio, words],
+  );
+  const endFrame = toFrames(end);
+  const fadeOutFrame = toFrames(end - 2);
+  const musicVolume = audio?.musicVolume ?? 0.2;
+  return (
+    <ThemeContext.Provider value={merged}>
+      <AbsoluteFill>
+        <Backdrop />
+        {audio?.music ? (
+          <Audio
+            src={staticFile(audio.music)}
+            volume={(f) => interpolate(f, [0, 15, fadeOutFrame, endFrame], [0, musicVolume, musicVolume, 0], clamp)}
+          />
+        ) : null}
+        {audio?.voice ? <Audio src={staticFile(audio.voice)} /> : null}
+        {timed.map((s, i) => (
+          <Sequence key={i} from={toFrames(s.from)} durationInFrames={Math.max(1, toFrames(s.dur))}>
+            <Stage dur={s.dur}>
+              <SceneView scene={s.def} ctx={{ dur: s.dur, mark: (name, fb = 0) => (name ? s.marks[name] ?? fb : fb) }} />
+            </Stage>
+          </Sequence>
+        ))}
+        {sfx.map((s, i) => (
+          <Sequence key={`sfx${i}`} from={toFrames(s.from)} durationInFrames={toFrames(s.def.durationSec ?? 1)}>
+            <Audio src={staticFile(s.def.src)} volume={s.def.volume ?? 0.16} />
+          </Sequence>
+        ))}
+        <Captions words={words.words} hideFrom={ctaStart === undefined ? undefined : ctaStart} />
+      </AbsoluteFill>
+    </ThemeContext.Provider>
+  );
+};

package/src/skills-lib/wizz-video-styles/assets/remotion/editorial/README.md

@@ -0,0 +1,77 @@
+# remotion-editorial
+
+Molde do estilo "motion editorial" (referência: shorts do Greg Isenberg): um objeto por vez no centro de um fundo claro com grade, cards escuros com sombra funda, serifa itálica bicolor, texto digitado em pílulas, conectores tracejados, música baixa e legenda pequena. Tudo guiado por palavras-âncora da fala (ctc-align).
+
+Testado com Remotion 4.0.527, React 18, `@remotion/google-fonts` 4.0.527. Canvas 1080x1920, 30 fps. Sem outras dependências.
+
+## Arquivos
+
+| arquivo | papel |
+|---|---|
+| `theme.ts` | `EditorialTheme`, `defaultTheme`, `mergeTheme`, `ThemeContext`, fontes (Playfair Display itálico, Inter, JetBrains Mono), `W/H/FPS` |
+| `primitives.tsx` | `Stage`, `Backdrop`, `Headline`, `Rays`, `Ring`, `Pill`, `Chip`, `Dash`, `PhoneCard`, `Counter`, `DocCard` |
+| `captions.tsx` | `Captions` (blocos de até 4 palavras, palavra falada em destaque) e `buildChunks` |
+| `timeline.ts` | `at(words, texto, after)`, `resolveMarks`, `buildScenes` (âncoras + sobreposição), `totalSeconds` |
+| `scenes.tsx` | tipo `SceneDef` (cenas como dados) e `SceneView` (7 tipos: hook, prompt, phone, numbers, steps, doc, cta) |
+| `EditorialReel.tsx` | composição genérica + `exampleScenes`, `exampleProps`, `exampleSeconds` |
+| `example-words.json` | palavras de exemplo no formato do ctc-align |
+
+## Como usar
+
+1. Copie a pasta inteira para `src/` do projeto Remotion (ex.: `src/editorial/`).
+2. Registre no `Root.tsx`:
+
+```tsx
+import { EditorialReel, exampleProps, exampleSeconds } from "./editorial/EditorialReel";
+import { FPS, H, W } from "./editorial/theme";
+
+<Composition
+  id="editorial-example"
+  component={EditorialReel}
+  defaultProps={exampleProps}
+  durationInFrames={Math.ceil(exampleSeconds * FPS)}
+  fps={FPS}
+  width={W}
+  height={H}
+/>
+```
+
+3. Troque as três entradas, nesta ordem:
+   - **palavras**: `words` = saída do ctc-align `{ words: [{ text, start, end }], total }`. Trocou a voz, realinhe o JSON; as cenas acompanham.
+   - **cenas**: array de `SceneDef`. Cada cena tem `at` (palavra onde ela começa) e `marks` opcional (nome -> palavra interna, ex.: quando o contador sobe). Palavra repetida: a busca é monotônica, então basta manter as cenas na ordem da fala. Palavra inexistente lança erro claro.
+   - **tema**: `theme={{ bg, accent, ... }}` parcial. Campos: `bg grid glow vignette ink card cardHi line onAccent accent accentWarm accentLight accentShadow dash shadow serif sans mono`.
+4. Duração: `totalSeconds(words, tail)` = fim da fala + 1,4 s.
+5. Áudio (opcional, arquivos em `public/`): `audio={{ voice: "x/voz.wav", music: "x/cama.mp3", musicVolume: 0.2, sfx: [{ atWord: "Here", offset: -0.15, src: "x/swoosh.mp3", volume: 0.16 }] }}`. Nomes passam por `staticFile`.
+6. Screenshot: `{ kind: "phone", src: "x/tela.png", ratio: altura/largura }` (iPhone 1206x2622 = `2622/1206`, é o padrão). Sem `src`, desenha uma tela de exemplo. `src` também aceita URL `https:` ou `data:`.
+7. Fontes: Playfair Display itálico (600/700) via `@remotion/google-fonts/PlayfairDisplay`, carregada em `theme.ts`.
+
+## Tipos de cena
+
+- `hook`: `a`, `b` (título bicolor) + anel girando.
+- `prompt`: título + pílula digitada + raios; `typedMark` define até quando digita.
+- `phone`: screenshot em card de celular.
+- `numbers`: chip + até 2 contadores (`mark` = palavra em que cada um começa a subir).
+- `steps`: pílula + raios + 3 chips ligados por tracejado.
+- `doc`: card de documento com páginas (texto, depois código mono) e até 4 chips de revisão.
+- `cta`: título + palavra-chave digitada + frase; `hideCaptions: true` some com a legenda dali em diante.
+
+Para criar um tipo novo: componha as primitivas num componente em `scenes.tsx`, acrescente o ramo na união `SceneDef` e no `switch` de `SceneView`.
+
+## Regras do estilo
+
+- Um objeto por vez no centro. Faixa útil y 180 a 1300; o terço de baixo é da legenda.
+- Troca por transformação, nunca corte seco: a cena sai subindo e sumindo enquanto a próxima entra por mola (`overlap` 0,12 s).
+- Música baixa e contínua, volume ~0,2, com fade de entrada e de saída.
+- SFX raro: no máximo ~1 a cada 10 s, volume baixo (~0,16), só em viradas grandes.
+- Legenda pequena, sem contorno, palavra falada em destaque; some quando a cena já carrega texto grande.
+- Serifa itálica só nos momentos-chave (títulos, pílulas, chips); sans na legenda e no corpo do documento; mono só em código.
+- Cor de destaque única; sobre a cor de destaque use `onAccent` (claro).
+- Timing sempre por âncora de palavra, nunca por segundo fixo.
+
+## Verificar
+
+```bash
+npx tsc --noEmit
+npx remotion still src/index.ts editorial-example out/f.png --frame=330
+```
+

package/src/skills-lib/wizz-video-styles/assets/remotion/editorial/captions.tsx

@@ -0,0 +1,56 @@
+import React, { useMemo } from "react";
+import { interpolate } from "remotion";
+import { clamp, useSeconds } from "./primitives";
+import { useTheme } from "./theme";
+import type { Word } from "./timeline";
+
+// Legenda discreta: blocos curtos de até 4 palavras, sem contorno, palavra falada em destaque.
+
+export type Chunk = { words: Word[]; start: number; end: number };
+
+const BREAK = /[,.:!?]$/;
+
+// Agrupa palavras em blocos: corta em 4 palavras, pontuação ou pausa > 0.35 s.
+export const buildChunks = (all: readonly Word[], maxWords = 4): Chunk[] => {
+  const ws = all.filter((w) => w.text.trim());
+  const raw = ws.reduce<{ done: Chunk[]; cur: Word[] }>(
+    (acc, w, i) => {
+      const cur = [...acc.cur, w];
+      const next = ws[i + 1];
+      const cut = cur.length === maxWords || BREAK.test(w.text) || !next || next.start - w.end > 0.35;
+      return cut
+        ? { done: [...acc.done, { words: cur, start: cur[0].start, end: w.end }], cur: [] }
+        : { ...acc, cur };
+    },
+    { done: [], cur: [] },
+  ).done;
+  // Cola o fim do bloco no começo do próximo quando a pausa é curta; senão segura 0,15 s.
+  return raw.map((c, i) => {
+    const next = raw[i + 1];
+    return { ...c, end: next && next.start - c.end < 0.5 ? next.start : c.end + 0.15 };
+  });
+};
+
+export const Captions: React.FC<{
+  words: readonly Word[];
+  hideFrom?: number; // s: some a partir daqui (ex.: cena final com texto próprio)
+  top?: number;
+  size?: number;
+}> = ({ words, hideFrom, top = 1560, size = 50 }) => {
+  const c = useTheme();
+  const t = useSeconds();
+  const chunks = useMemo(() => buildChunks(words), [words]);
+  if (hideFrom !== undefined && t >= hideFrom) return null;
+  const chunk = chunks.find((x) => t >= x.start && t < x.end);
+  if (!chunk) return null;
+  const opacity = interpolate(t, [chunk.start, chunk.start + 0.1], [0, 1], clamp);
+  return (
+    <div style={{ position: "absolute", top, left: 90, right: 90, textAlign: "center", opacity, fontFamily: c.sans, fontWeight: 700, fontSize: size, lineHeight: 1.25, color: c.ink }}>
+      {chunk.words.map((w) => (
+        <span key={w.start} style={{ color: t >= w.start && t < w.end + 0.05 ? c.accent : c.ink }}>
+          {w.text.replace(BREAK, "")}{" "}
+        </span>
+      ))}
+    </div>
+  );
+};