wizz-method 2.16.0 → 2.17.0

package/THIRD-PARTY-NOTICES.md

@@ -136,3 +136,9 @@ the `<Font>-OFL.txt` file in the same folder.
 - Path: `src/skills-lib/wizz-supabase-postgres-best-practices/`
 - Origin: [supabase/agent-skills](https://github.com/supabase/agent-skills)
 - License: MIT (full text at `src/skills-lib/wizz-supabase-postgres-best-practices/LICENSE`, copyright (c) 2026 Supabase)
+
+## wizz-video-styles (audio kit)
+
+- Path: `src/skills-lib/wizz-video-styles/assets/audio/music/cinematic-tense.mp3`, `src/skills-lib/wizz-video-styles/assets/audio/music/meme-beat.mp3`
+- Origin: "Hitman" and "Monkeys Spinning Monkeys" by Kevin MacLeod ([incompetech.com](https://incompetech.com)), via Wikimedia Commons
+- License: Creative Commons Attribution 4.0 (CC BY 4.0). Both tracks were trimmed, faded and loudness-normalised; the exact changes and the credit text to paste are in `src/skills-lib/wizz-video-styles/assets/audio/CREDITS.md`.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "wizz-method",
-  "version": "2.16.0",
+  "version": "2.17.0",
   "description": "Wizz Method: método de agência orientado por IA em PT-BR",
   "keywords": [
     "agile",

package/skills-registry.yaml

@@ -171,7 +171,7 @@ areas:
         door: motion
         when: "MONTAR o filme: vídeo em React (Remotion) com áudio, SFX, legenda e timing com precisão de frame. No pipeline de vídeo é o Remotion que faz a montagem final; o hyperframes só desenha as telas mudas (regra: HyperFrames desenha, Remotion monta — ver _shared/video-pipeline.md do módulo wizz)."
         rel:
-          after: [buttercut, ctc-align, get-brolls, hyperframes, wizz-motion-3d-director, wizz-video-effects]
+          after: [buttercut, ctc-align, get-brolls, hyperframes, wizz-motion-3d-director, wizz-video-effects, wizz-video-styles]
       - id: wizz-canvas-design
         door: motion
         when: "Gerar PNG/PDF editável por código (carrossel, quote card, infográfico) com fonte/cor/logo sempre certos. Traz canvas-fonts."
@@ -186,7 +186,7 @@ areas:
         door: motion
         when: "Timing por forced alignment: timestamps palavra a palavra de narração TTS para sincronizar legenda, corte de cena e animação com a fala. Fonte única de timing no pipeline de vídeo; substitui Whisper e estimativa manual."
         rel:
-          after: [voicebox]
+          after: [voicebox, wizz-video-styles]
           before: [wizz-remotion-best-practices, wizz-video-effects]
       # Motor de decisão de efeitos (Python) portado do sistema de efeitos do
       # trafego em 2026-09-24: orçamento anti-excesso, som por evento semântico,
@@ -199,15 +199,27 @@ areas:
           - "Montar o filme em React (sequência de cenas, legenda, <Audio>): é wizz-remotion-best-practices; esta skill decide os efeitos que ele monta."
           - "Filme de lançamento de produto com trilha e direção visual: é wizz-huashu-design."
         rel:
-          after: [ctc-align, hyperframes]
+          after: [ctc-align, hyperframes, wizz-video-styles]
           before: [wizz-remotion-best-practices]
           pairs_with: [wizz-ad-creative]
+      # Catálogo de estilos de vídeo curto medido em 99 shorts reais: decide QUAL
+      # estilo copiar antes de voz, timing, efeitos e montagem.
+      - id: wizz-video-styles
+        door: motion
+        when: "Decidir QUAL estilo de vídeo curto copiar a partir do inventário do material (pessoa real, só voz, b-roll, telas, produto) e entregar a receita medida em 99 shorts reais (ritmo de corte, legenda, áudio, zoom, gancho), para qualquer nicho. Gatilhos: 'estilo do vídeo', 'editar no estilo de', 'copiar a edição de', 'que estilo usar no reel', 'o vídeo ficou amador'."
+        not_when:
+          - "Decidir efeitos e SFX por evento, volume, LUFS e portões de zona segura: é wizz-video-effects; esta skill escolhe o estilo que ele depois refina."
+          - "Montar o filme em React (cenas, legenda, <Audio>): é wizz-remotion-best-practices."
+        rel:
+          before: [ctc-align, wizz-video-effects, wizz-remotion-best-practices]
+          pairs_with: [wizz-social-content, get-brolls, hyperframes]
     clis:
       - id: hyperframes
         when: "DESENHAR telas de vídeo em HTML/CSS (HTML→MP4, agent-native, 20+ skills): cena isolada e MUDA — maqueta de WhatsApp/ChatGPT, gráfico animado, título, loop. NÃO usar para montagem com áudio/SFX/legenda sincronizada (posicionador de áudio falhou em produção, ~2,76s de drift; CSS vaza entre telas): a montagem final é do Remotion (regra: HyperFrames desenha, Remotion monta — ver _shared/video-pipeline.md do módulo wizz). Precisa ffmpeg + Node 22 + Chrome headless."
         not_when: "Montagem com áudio/SFX/legenda sincronizada (posicionador de áudio falhou em produção, ~2,76s de drift; CSS vaza entre telas)."
         rel:
           before: [wizz-remotion-best-practices, wizz-video-effects]
+          pairs_with: [wizz-video-styles]
         platform: [darwin, linux]
         # O check confere o SHA fixado, não só a existência da pasta: o bundle é
         # copiado (não clonado), então o pin é gravado num marcador no install.
@@ -248,7 +260,7 @@ areas:
         rel:
           after: [wizz-social-content]
           before: [buttercut, wizz-remotion-best-practices]
-          pairs_with: [claude-video]
+          pairs_with: [claude-video, wizz-video-styles]
         # macOS apenas: o upstream declara macOS/Windows (Linux não é testado lá)
         # e o `install` daqui é POSIX. Windows fica fora porque o installer do
         # Wizz não roda nele — quem estiver no Windows segue o README do upstream.
@@ -296,7 +308,7 @@ areas:
       - id: ctc-align
         when: "Timestamps palavra a palavra CONFIÁVEIS de narração TTS (texto conhecido): sincronizar legenda, corte de cena, animação e elemento gráfico com a fala. Fonte única de timing em vídeo — substitui timestamps do Whisper e estimativa manual. Skill da lib: ctc-align (instalação + helper align.py + regras de âncora monotônica e duração mínima). Roda em CPU, sem CUDA."
         rel:
-          after: [voicebox]
+          after: [voicebox, wizz-video-styles]
           before: [wizz-remotion-best-practices, wizz-video-effects]
         platform: [darwin, linux]
         # O pip grava o commit instalado no direct_url.json: o check compara com o pin.
@@ -580,7 +592,7 @@ areas:
           - "Pedir SÓ o asset de um Reel/vídeo — b-roll, 'imagens de apoio', 'cenas de apoio', imagem de corte, footage — sem que o texto ou o roteiro façam parte do pedido: a captação é get-brolls, na área designer. Esta entrada entra quando o TEXTO ou o ROTEIRO é parte do que se pede; se o pedido junta roteiro E captação, são 2 áreas."
         rel:
           before: [buffer, get-brolls]
-          pairs_with: [wizz-canvas-design, wizz-content-strategy, wizz-copy-editing, wizz-launch-strategy]
+          pairs_with: [wizz-canvas-design, wizz-content-strategy, wizz-copy-editing, wizz-launch-strategy, wizz-video-styles]
       - id: wizz-content-strategy
         when: "Decidir O QUE produzir de conteúdo (topic clusters, calendário, pilares)."
         rel:

package/src/modules/wizz/_shared/video-pipeline.md

@@ -21,6 +21,7 @@
 | Short video WITHOUT synced audio (loop, overlay, silent motion graphic) | `hyperframes` |
 | Assemble the film: sequence of scenes + narration + SFX + captions + frame timing | **Remotion** (skill `wizz-remotion-best-practices`) |
 | Captions passing behind the person on a recorded talking head (matte) | embedded-captions (HyperFrames bundle), then the clip goes to Remotion |
+| Pick WHICH short-video style to copy (from the inventory of the material) and get its measured recipe, before voice, timing and effects | `wizz-video-styles` |
 | Word-by-word timestamps of the TTS narration (sync captions/cuts/animation) | `ctc-align` |
 | Decide which effects and SFX go where (and where not), then gate the render: safe zone (ad or organic), density, excess, rhythm, loudness | `wizz-video-effects` |
 | Narration / voice / TTS / voice cloning | `voicebox` |

package/src/skills-lib/wizz-router/references/routing-table-flat.md

@@ -55,6 +55,7 @@ Use this table to map skills/CLIs/MCPs directly **outside a Wizz project** (no `
 | **Video with audio, narration, SFX, or synced captions** (film assembly) | `wizz-remotion-best-practices` (Remotion assembles; frame timing). Pipeline rule: HyperFrames draws the mute screens, Remotion assembles the film — don't use hyperframes to position audio/captions (~2.76s drift and CSS leaking between screens in production) | 1 |
 | Draw a video SCREEN/scene in HTML/CSS, mute visual (app mockup, animated chart, title, loop; HTML→MP4) | CLI `hyperframes` (designer registry; `npx skills add heygen-com/hyperframes`) — mute screens only; assembly with audio goes to Remotion (line above) | 2 |
 | Word-by-word timestamps for TTS narration (sync captions/cuts/animation with speech) | `ctc-align` (designer registry; single source of timing, replaces Whisper) | 2 |
+| Which short-video STYLE to copy, from the inventory of the material (real person, voice only, B-roll, screens, product), with the recipe measured on 99 real shorts; "edit it in the style of", "the video looks amateur" | `wizz-video-styles` (designer registry; picks the style before voice, timing, effects and assembly) | 2 |
 | Effects and sound of a short vertical video (ad or Reels): which effect goes where and when not, which SFX for each event and at what level, ducking, master loudness, safe-zone/density/excess/rhythm gates | `wizz-video-effects` (designer registry; decides the effects, Remotion assembles them) | 2 |
 | **Find B-roll / inserts / cutaways / supporting footage** for a video or Reel (real footage of the fact, person, product, news item or screen the script names; YouTube/Instagram/TikTok/Pexels/Pixabay/Commons/NASA) | CLI `get-brolls` (designer registry; **macOS**, global `skills add` + its own `install.sh`; needs ffmpeg with drawtext, Node 22+, Python 3.11+). Ends in a Storyboard the HUMAN approves — the agent never self-approves. Stock only when the user explicitly asks for stock | 1 |
 | **Edit/cut video** (cuts, selects, roughcut) | CLI `buttercut` (designer registry; **Apple Silicon only**, clone-and-run in the project, heavy deps) | 1 |

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>
+  );
+};