wizz-method 2.16.0 → 2.17.1

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.1",
   "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/model-ladder.md

@@ -4,7 +4,7 @@ The names `wizz-exec-mechanical`/`wizz-exec-standard`/`wizz-exec-strong`/`wizz-e
 
 ## The recommended session (the boss)
 
-The recommended session model is the Standard tier (Sonnet / gpt-5.6-terra / claude-sonnet-5-5 / gemini-3.5-flash). The boss does common work itself — commands, questions, implementation with a spec — dispatches subagents for isolation or parallel work, arbitrates conflict between executor and reviewer, and takes architecture/product decisions WITH the user.
+The recommended session model is the Standard tier (Sonnet / gpt-6-sol / claude-sonnet-5-5 / gemini-3.5-flash). The boss does common work itself — commands, questions, implementation with a spec — dispatches subagents for isolation or parallel work, arbitrates conflict between executor and reviewer, and takes architecture/product decisions WITH the user.
 
 A session running above Standard (Opus, Fable, Mythos...) absorbs every tier at or below its own model: an Opus session does Strong work itself, and dispatches `wizz-exec-ultra` only after that attempt returns `ESCALAR` per the escalation signals below. A session on the Ultra model (Fable) absorbs Ultra too: it takes strong's `ESCALAR` itself and never dispatches `wizz-exec-ultra`. Review is the exception — it's NEVER absorbed: it always runs on `wizz-exec-review`, pinned to the Strong tier, so in a Fable session review moves off the boss and onto Opus.
 
@@ -14,11 +14,13 @@ How to know who the boss is in Claude Code: the system prompt states the session
 
 | Tier | Subagent | Use | Claude Code | Codex | OpenCode | Gemini CLI |
 |---|---|---|---|---|---|---|
-| Mechanical | `wizz-exec-mechanical` | scanning, rename, repetitive diff, 100% specified change | haiku (maxTurns 50, no effort field) | gpt-5.6-luna, effort low | anthropic/claude-haiku-4-5 | gemini-3.1-flash-lite (max_turns 50, no effort field) |
-| Standard | `wizz-exec-standard` | small/medium defined feature, bug with known cause, tests | sonnet, effort medium (maxTurns 80) | gpt-5.6-terra, effort medium | anthropic/claude-sonnet-5-5 | gemini-3.5-flash (max_turns 80) |
-| Strong | `wizz-exec-strong` | bug with unclear cause after one investigation cycle, refactor spanning modules, schema/auth/payment changes, local technical decision | opus, effort high (maxTurns 120) | gpt-5.6-sol, effort high | anthropic/claude-opus-5-5 | gemini-3.1-pro-preview (max_turns 120) |
+| Mechanical | `wizz-exec-mechanical` | scanning, rename, repetitive diff, 100% specified change | haiku (maxTurns 50, no effort field) | gpt-6-luna, effort low | anthropic/claude-haiku-4-5 | gemini-3.1-flash-lite (max_turns 50, no effort field) |
+| Standard | `wizz-exec-standard` | small/medium defined feature, bug with known cause, tests | sonnet, effort medium (maxTurns 80) | gpt-6-sol, effort medium | anthropic/claude-sonnet-5-5 | gemini-3.5-flash (max_turns 80) |
+| Strong | `wizz-exec-strong` | bug with unclear cause after one investigation cycle, refactor spanning modules, schema/auth/payment changes, local technical decision | opus, effort high (maxTurns 120) | gpt-6-sol, effort high | anthropic/claude-opus-5-5 | gemini-3.1-pro-preview (max_turns 120) |
 | Ultra | `wizz-exec-ultra` | ultra-hard work the Strong tier returned `ESCALAR` on, plus its findings | fable, effort xhigh (maxTurns 150) | gpt-6-astra, effort xhigh | anthropic/claude-fable-5-1 | no ultra tier on this platform |
-| Review | `wizz-exec-review` | review of a diff produced by any tier; pinned to Strong, never inherits the session | opus, effort high (maxTurns 60) | gpt-5.6-sol, effort high | anthropic/claude-opus-5-5 | gemini-3.1-pro-preview (max_turns 60) |
+| Review | `wizz-exec-review` | review of a diff produced by any tier; pinned to Strong, never inherits the session | opus, effort high (maxTurns 60) | gpt-6-sol, effort high | anthropic/claude-opus-5-5 | gemini-3.1-pro-preview (max_turns 60) |
+
+Staying current: Claude Code tiers are aliases that Claude Code points at the newest model, so they never need a bump. Codex has no such alias: on install and on every `wizz update`, the installer reads the machine's Codex models cache (`~/.codex/models_cache.json`) and swaps each pinned Codex model for the newest current model of the same class (fast, workhorse, frontier). The table's Codex column is the fallback, used when the cache is missing, older than the spec, or the newer model lacks the tier's effort. OpenCode and Gemini CLI stay pinned to the table.
 
 OpenCode gets the model only: its per-agent effort field isn't documented, and it has no per-agent turn cap field either. Claude Code and Gemini CLI enforce turn caps natively (`maxTurns` / `max_turns`); Codex and OpenCode have no per-agent turn cap field, so briefs to them should always carry `max_calls`.
 

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/modules/wizz/subagents/codex/wizz-exec-mechanical.toml

@@ -1,9 +1,9 @@
 # Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 name = "wizz-exec-mechanical"
 description = """
-Mechanical Wizz Method executor, the cheapest tier. File sweeps, lookups, renames, repetitive diffs, and applying already 100%-specified changes. Dispatch 1 instance when the work fits in 3 files or fewer; parallel instances only when partitioned by file/module (never two on the same file), up to 4 at once. Model on this platform: gpt-5.6-luna, effort low.
+Mechanical Wizz Method executor, the cheapest tier. File sweeps, lookups, renames, repetitive diffs, and applying already 100%-specified changes. Dispatch 1 instance when the work fits in 3 files or fewer; parallel instances only when partitioned by file/module (never two on the same file), up to 4 at once. Model on this platform: gpt-6-luna, effort low.
 """
-model = "gpt-5.6-luna"
+model = "gpt-6-luna"
 model_reasoning_effort = "low"
 developer_instructions = """
 You are a mechanical executor for the Wizz Method. You receive a closed brief and execute it to the letter.

package/src/modules/wizz/subagents/codex/wizz-exec-review.toml

@@ -1,9 +1,9 @@
 # Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 name = "wizz-exec-review"
 description = """
-Wizz Method reviewer pinned to the Strong tier (gpt-5.6-sol, effort high), never to the session's model. Receives a diff or an executor's result and reviews correctness, security, regressions, and scope adherence. Doesn't implement: returns a verdict and a list of issues with file:line.
+Wizz Method reviewer pinned to the Strong tier (gpt-6-sol, effort high), never to the session's model. Receives a diff or an executor's result and reviews correctness, security, regressions, and scope adherence. Doesn't implement: returns a verdict and a list of issues with file:line.
 """
-model = "gpt-5.6-sol"
+model = "gpt-6-sol"
 model_reasoning_effort = "high"
 sandbox_mode = "read-only"
 developer_instructions = """

package/src/modules/wizz/subagents/codex/wizz-exec-standard.toml

@@ -1,9 +1,9 @@
 # Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 name = "wizz-exec-standard"
 description = """
-Standard Wizz Method executor for day-to-day implementation. Well-defined small/medium features, bug fixes with a known cause, multi-file edits, tests. Same tier as the recommended session model: dispatch it for isolation or parallel work (1 per file/module, up to 4 at once), not to escalate. Model on this platform: gpt-5.6-terra, effort medium.
+Standard Wizz Method executor for day-to-day implementation. Well-defined small/medium features, bug fixes with a known cause, multi-file edits, tests. Same tier as the recommended session model: dispatch it for isolation or parallel work (1 per file/module, up to 4 at once), not to escalate. Model on this platform: gpt-6-sol, effort medium.
 """
-model = "gpt-5.6-terra"
+model = "gpt-6-sol"
 model_reasoning_effort = "medium"
 developer_instructions = """
 You are an implementation executor for the Wizz Method. You receive a brief with a goal and context, and you implement it.

package/src/modules/wizz/subagents/codex/wizz-exec-strong.toml

@@ -1,9 +1,9 @@
 # Gerado por tools/generate-subagents.mjs a partir de src/modules/wizz/subagents/spec.yaml. Não edite este arquivo direto: edite o spec.yaml e rode `npm run generate:subagents`.
 name = "wizz-exec-strong"
 description = """
-Strong Wizz Method executor for hard work. Bugs with no known cause after one investigation cycle, cross-module refactors, schema/auth/payment changes, local technical decisions. The session dispatches it when the work is too hard for the session's own tier. If the work turns out to be ultra hard, it returns ESCALAR with its findings; it never dispatches anything itself. Model on this platform: gpt-5.6-sol, effort high.
+Strong Wizz Method executor for hard work. Bugs with no known cause after one investigation cycle, cross-module refactors, schema/auth/payment changes, local technical decisions. The session dispatches it when the work is too hard for the session's own tier. If the work turns out to be ultra hard, it returns ESCALAR with its findings; it never dispatches anything itself. Model on this platform: gpt-6-sol, effort high.
 """
-model = "gpt-5.6-sol"
+model = "gpt-6-sol"
 model_reasoning_effort = "high"
 developer_instructions = """
 You are a senior executor for the Wizz Method. You receive a brief with a goal and context for hard work, where the root cause or the path forward isn't clear yet.

package/src/modules/wizz/subagents/spec.yaml

@@ -169,12 +169,15 @@ models:
     strong: anthropic/claude-opus-5-5
     ultra: anthropic/claude-fable-5-1
     review: anthropic/claude-opus-5-5
+  # GPT-6 has three models for five tiers (2026-10-05, Codex models cache):
+  # luna = fast/cheap, sol = workhorse, astra = frontier. Strong/review
+  # reuse sol at higher effort; ultra stays on astra.
   codex:
-    mechanical: gpt-5.6-luna
-    standard: gpt-5.6-terra
-    strong: gpt-5.6-sol
+    mechanical: gpt-6-luna
+    standard: gpt-6-sol
+    strong: gpt-6-sol
     ultra: gpt-6-astra
-    review: gpt-5.6-sol
+    review: gpt-6-sol
 
 # Codex `model_reasoning_effort`.
 codex_effort:

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/"
+  }
+]