wizz-method 2.2.0 → 2.3.0

package/src/skills-lib/cerebro/references/comandos-sessao.md

@@ -1,146 +1,146 @@
-# Comandos de Sessão: /iniciar, /ver, /salvar
+# Session Commands: /iniciar, /ver, /salvar
 
-Carregue este arquivo ao executar `/iniciar`, `/ver` ou `/salvar`. Antes de tudo, releia a REGRA DE OURO e a seção Vault no SKILL.md principal — esses comandos dependem delas.
+Load this file when running `/iniciar`, `/ver` or `/salvar`. Before anything else, re-read the GOLDEN RULE and the Vault section in the main SKILL.md — these commands depend on them.
 
-## O bloco Estado
+## The State block
 
-Todo arquivo em `projetos/` começa com um bloco `## Estado` de no **máximo 12 linhas**, logo abaixo do título. Ele é sobrescrito a cada `/salvar` e é a única coisa que o `/ver` precisa ler.
+Every file in `projetos/` starts with a `## Estado` block of **at most 12 lines**, right below the title. It gets overwritten on every `/salvar` and it's the only thing `/ver` needs to read.
 
 ```markdown
 ## Estado
-- **Fase:** [em que ponto o projeto está, 1 linha]
-- **Stack:** [1 linha]
-- **Onde parou:** [1 linha]
-- **Próximo passo:** [1 linha, a primeira coisa a fazer ao voltar]
-- **Bloqueio:** [1 linha, ou "nenhum"]
-- **Última sessão:** [YYYY-MM-DD] — [1 linha]
+- **Fase:** [where the project currently stands, 1 line]
+- **Stack:** [1 line]
+- **Onde parou:** [1 line]
+- **Próximo passo:** [1 line, the first thing to do when picking this back up]
+- **Bloqueio:** [1 line, or "none"]
+- **Última sessão:** [YYYY-MM-DD] — [1 line]
 ```
 
-Por que 12 linhas: o `/ver` vira 1 Read de 14 linhas em vez de um tail de 60. E o bloco fica no topo, onde qualquer humano abrindo a nota também lê primeiro.
+Why 12 lines: `/ver` becomes 1 Read of 14 lines instead of a tail of 60. And the block sits at the top, where any human opening the note also reads it first.
 
-O que **não** entra no bloco: histórico, decisão, aprendizado, lista longa de pendências. Histórico é a tabela `Sessões`; decisão é `_decisions/`; aprendizado é a auto-memória do agente; a lista completa de pendências é a seção `O que falta`.
+What does **not** go in the block: history, decisions, learnings, a long list of pending items. History is the `Sessões` table; decisions go in `_decisions/`; learnings are the agent's auto-memory; the full list of pending items is the `O que falta` section.
 
 ## /iniciar
 
-**Objetivo:** configurar projeto novo. Só cria arquivos — não lê nada além do CEREBRO.md mínimo.
+**Goal:** set up a new project. Only creates files — doesn't read anything beyond the minimal CEREBRO.md.
 
-**Passos:**
+**Steps:**
 
-1. Descobrir vault (ver seção Vault)
-2. `grep -c "$PROJ" "$VAULT/CEREBRO.md"` → verificar se projeto já existe (0 = novo)
-3. Se novo: entrevistar em 1 mensagem (organização, info essencial, estilo, modo)
-4. Write `projetos/[nome].md` com template
-5. `grep -n "## Projetos" "$VAULT/CEREBRO.md"` → Edit para inserir entrada
-6. Confirmar
+1. Discover the vault (see Vault section)
+2. `grep -c "$PROJ" "$VAULT/CEREBRO.md"` → check whether the project already exists (0 = new)
+3. If new: interview in 1 message (organization, essential info, style, mode)
+4. Write `projetos/[name].md` with the template
+5. `grep -n "## Projetos" "$VAULT/CEREBRO.md"` → Edit to insert the entry
+6. Confirm
 
-**Template `projetos/[nome].md`:**
+**Template `projetos/[name].md`:**
 
 ```markdown
-# [Nome] — Estado Atual
-> Atualizado: [data]
+# [Name] — Current State
+> Updated: [date]
 
 ## Estado
-- **Fase:** [fase]
+- **Fase:** [phase]
 - **Stack:** [stack]
-- **Onde parou:** [1 linha]
-- **Próximo passo:** [1 linha]
-- **Bloqueio:** nenhum
-- **Última sessão:** [data] — [1 linha]
+- **Onde parou:** [1 line]
+- **Próximo passo:** [1 line]
+- **Bloqueio:** none
+- **Última sessão:** [date] — [1 line]
 
-## Preferências
-- Organização: [resposta]
-- Info essencial: [resposta]
-- Estilo: [resposta]
-- Modo: [registro / sugestivo]
+## Preferences
+- Organization: [answer]
+- Essential info: [answer]
+- Style: [answer]
+- Mode: [logging / suggestive]
 
-## Contexto
-[o que o bloco Estado não cabe: stack detalhada, restrições, links]
+## Context
+[what doesn't fit in the State block: detailed stack, constraints, links]
 
-## O que falta
+## What's left
 - [ ]
 
-## Sessões
-| Data | Resumo |
-|------|--------|
-|      |        |
+## Sessions
+| Date | Summary |
+|------|---------|
+|      |         |
 ```
 
-**Template bloco em CEREBRO.md:**
+**Template block in CEREBRO.md:**
 
 ```markdown
-### [Nome] [emoji]
+### [Name] [emoji]
 - **Stack:** [stack]
-- **Última sessão:** [data] — [resumo]
-- **Pendente:** [pendências]
-- **Estado atual:** [[projetos/nome]]
+- **Última sessão:** [date] — [summary]
+- **Pendente:** [pending items]
+- **Estado atual:** [[projetos/name]]
 ```
 
 ## /ver
 
-**Objetivo:** mostrar estado atual rápido. Máximo: 1 Read de 14 linhas.
+**Goal:** show current state quickly. Maximum: 1 Read of 14 lines.
 
-**Passos:**
+**Steps:**
 
-1. Read `projetos/[nome].md` com `limit=14` (o bloco Estado está no topo)
-2. Devolver o bloco quase como está, sem reescrever
+1. Read `projetos/[name].md` with `limit=14` (the State block is at the top)
+2. Return the block almost as-is, without rewriting it
 
-**Arquivo antigo, sem bloco Estado no topo:** cai no caminho lento uma única vez — `wc -l` e Read das últimas 60 linhas — e ao devolver, ofereça criar o bloco. Aceito, o próximo `/ver` volta a custar 1 Read curto.
+**Old file, with no State block at the top:** falls onto the slow path exactly once — `wc -l` and Read of the last 60 lines — and when returning it, offer to create the block. Once accepted, the next `/ver` goes back to costing 1 short Read.
 
 ## /salvar
 
-**Objetivo:** fechar sessão, persistir o que aconteceu. Máximo de tokens: ~800 input + edits.
+**Goal:** close out the session, persist what happened. Token budget: ~800 input + edits.
 
-**Passos (executar em ordem, sem desvios):**
+**Steps (execute in order, no detours):**
 
-**1. Localizar projeto e bloco no CEREBRO.md (1 bash call)**
+**1. Locate the project and the block in CEREBRO.md (1 bash call)**
 
 ```bash
 VAULT=~/Documents/projects/Obsidian\ Vault
-PROJ=construcao   # inferir do diretório atual ou contexto
+PROJ=construcao   # infer from the current directory or context
 grep -n "### \|Última sessão\|Pendente" "$VAULT/CEREBRO.md" | grep -A2 -i "$PROJ"
 wc -l "$VAULT/projetos/$PROJ.md"
 ```
 
-**2. Ler o topo e o fim do arquivo do projeto (2 Reads curtos)**
+**2. Read the top and the end of the project file (2 short Reads)**
 
-- topo: `limit=14` → bloco Estado
-- fim: `offset = (total_linhas - 40)`, `limit = 40` → O que falta e tabela Sessões
+- top: `limit=14` → State block
+- end: `offset = (total_lines - 40)`, `limit = 40` → What's left and Sessions table
 
-**3. Construir as alterações na memória, depois aplicar (Edits atômicos)**
+**3. Build the memory changes, then apply them (atomic Edits)**
 
-Em `projetos/[nome].md`:
+In `projetos/[name].md`:
 
-- **Sobrescrever o bloco `## Estado`** inteiro, mantendo os mesmos 6 campos e o teto de 12 linhas. Não empilhar bloco novo: o histórico é a tabela.
-- Atualizar a seção `O que falta` (marcar o que saiu, acrescentar o que entrou).
-- Acrescentar 1 linha ao fim da tabela `Sessões`:
+- **Overwrite the entire `## Estado` block**, keeping the same 6 fields and the 12-line cap. Don't stack a new block: history is the table.
+- Update the `O que falta` section (mark what's done, add what's new).
+- Add 1 line to the end of the `Sessões` table:
 
 ```markdown
-| [data] | [resumo 1 linha] |
+| [date] | [1-line summary] |
 ```
 
-Arquivo sem bloco `## Estado`: criar agora, logo abaixo do título, com o que a sessão apurou.
+File with no `## Estado` block: create it now, right below the title, with what this session found.
 
-**4. Atualizar bloco do projeto em CEREBRO.md (1 Edit)**
+**4. Update the project's block in CEREBRO.md (1 Edit)**
 
-- Usar grep do passo 1 para saber as linhas exatas
-- Edit cirúrgico apenas nas linhas "Última sessão" e "Pendente"
+- Use the grep from step 1 to know the exact lines
+- Surgical Edit only on the "Última sessão" and "Pendente" lines
 
-**5. Se houve decisão relevante:** criar arquivo em `_decisions/` (ver `comandos-rotina-e-captura.md` para o frontmatter e a regra de grep-antes-de-gravar).
-Aprendizado técnico (armadilha de stack, bug não óbvio, pegadinha de ambiente) **não vai para o vault**: vai para a auto-memória do agente. No vault ninguém lia. No Claude Code ela carrega sozinha no início da sessão; em Codex, OpenCode e Gemini o caminho de leitura é o `/memoria` (ver `comandos-pesquisa-e-memoria.md`).
+**5. If there was a relevant decision:** create a file in `_decisions/` (see `comandos-rotina-e-captura.md` for the frontmatter and the grep-before-writing rule).
+A technical learning (stack gotcha, non-obvious bug, environment trap) **does not go to the vault**: it goes to the agent's auto-memory. Nobody read it in the vault. In Claude Code it loads on its own at session start; in Codex, OpenCode and Gemini the read path is `/memoria` (see `comandos-pesquisa-e-memoria.md`).
 
-**6. Higiene do índice (compactação)**
+**6. Index hygiene (compaction)**
 
 ```bash
 wc -l "$VAULT/CEREBRO.md"
 ```
 
-- Se > 150 linhas: mover o conteúdo mais antigo/menos essencial (projeto ✅ concluído ou ❌ descontinuado com histórico longo, ou entradas de "Decisões recentes" além das ~15 mais novas) para `_index/cerebro-archive.md`, deixando no lugar só 1 linha de referência `[[_index/cerebro-archive]]`. Nunca apagar, só mover.
-- Se ≤ 150 linhas: pular este passo.
+- If > 150 lines: move the oldest/least essential content (a project marked ✅ done or ❌ discontinued with long history, or "Decisões recentes" entries beyond the ~15 newest) to `_index/cerebro-archive.md`, leaving only a 1-line `[[_index/cerebro-archive]]` reference in its place. Never delete, only move.
+- If ≤ 150 lines: skip this step.
 
 ```bash
 grep -c "^| " "$VAULT/projetos/$PROJ.md"
 ```
 
-- Tabela Sessões com mais de 15 linhas: mover as mais antigas para `_index/cerebro-archive.md`, sob `## Sessões antigas — [projeto]`, deixando as 15 mais novas no arquivo do projeto. Nunca apagar, só mover.
+- Sessions table with more than 15 lines: move the oldest ones to `_index/cerebro-archive.md`, under `## Sessões antigas — [project]`, leaving the 15 newest in the project file. Never delete, only move.
 
-**7. Confirmar em 2 linhas** o que foi salvo.
+**7. Confirm in 2 lines** what was saved.

package/src/skills-lib/ctc-align/SKILL.md

@@ -1,60 +1,60 @@
 ---
 name: ctc-align
-description: Timestamps palavra a palavra confiáveis para narração TTS via alinhamento forçado (ctc-forced-aligner + âncora nos silêncios reais). Usar SEMPRE antes de definir tempo de legenda, corte de cena, animação ou elemento sincronizado com fala em qualquer vídeo (HyperFrames ou outro editor). Substitui o Whisper como fonte de timing quando o texto do roteiro é conhecido. Gatilhos - sincronizar legenda, timing de cena, alinhar áudio e texto, palavra a palavra, forced alignment, legenda karaokê, corrigir sync de vídeo. Use quando o roteiro exato da narração for conhecido e for preciso decidir timing de legenda, corte de cena ou animação sincronizada com a fala.
+description: Reliable word-by-word timestamps for TTS narration via forced alignment (ctc-forced-aligner + anchoring on real silences). ALWAYS use before setting caption timing, scene cuts, animation, or any speech-synchronized element in any video (HyperFrames or other editor). Replaces Whisper as the timing source when the narration script text is known. Triggers - sincronizar legenda, timing de cena, alinhar áudio e texto, palavra a palavra, forced alignment, legenda karaokê, corrigir sync de vídeo. Use when the exact narration script is known and you need to decide caption timing, scene cuts, or speech-synchronized animation.
 ---
 
-# ctc-align — timing de fala como fonte única de verdade
+# ctc-align — speech timing as the single source of truth
 
-## Quando usar
+## When to use
 
-Sempre que um vídeo tiver narração cujo TEXTO é conhecido (roteiro de TTS, VSL,
-explainer) e for preciso decidir QUANDO algo aparece: legenda, corte de cena,
-animação, texto na tela.
+Whenever a video has narration whose TEXT is known (TTS script, VSL,
+explainer) and you need to decide WHEN something appears: caption, scene cut,
+animation, on-screen text.
 
-**Regra do método: nunca estimar tempo à mão e nunca confiar no timestamp do Whisper.**
-O Whisper adivinha as palavras e deriva (medido: até 6s); interpolação proporcional
-entre silêncios desloca palavras para o bloco vizinho. O alinhamento CTC recebe o texto
-exato e só procura onde cada palavra está: precisão de dezenas de ms.
+**Method rule: never estimate timing by hand and never trust Whisper's timestamp.**
+Whisper guesses words and derives timing (measured: drift up to 6s); proportional
+interpolation between silences shifts words into the neighboring block. CTC alignment gets the
+exact text and only looks for where each word is: precision within tens of ms.
 
-## Instalação (uma vez por projeto)
+## Installation (once per project)
 
     mkdir -p tools/ctc-align && cd tools/ctc-align
     uv venv --python 3.12 .venv
     uv pip install --python .venv/bin/python "git+https://github.com/MahmoudAshraf97/ctc-forced-aligner.git"
 
-Copiar o `scripts/align.py` desta skill para `tools/ctc-align/align.py`.
-Roda em CPU (Mac ARM ok, sem CUDA). Primeiro uso baixa o modelo MMS (~1GB).
+Copy this skill's `scripts/align.py` to `tools/ctc-align/align.py`.
+Runs on CPU (Mac ARM ok, no CUDA needed). First use downloads the MMS model (~1GB).
 
-## Uso
+## Usage
 
-1. Gerar um .txt com o roteiro EXATO que o TTS falou (texto corrido; se o TTS falou
-   diferente do escrito, usar o que foi FALADO).
-2. Rodar:
+1. Generate a .txt with the EXACT script the TTS spoke (running text; if the TTS spoke
+   something different from what was written, use what was SPOKEN).
+2. Run:
 
-    tools/ctc-align/.venv/bin/python tools/ctc-align/align.py narracao.mp3 roteiro.txt transcript.json
+    tools/ctc-align/.venv/bin/python tools/ctc-align/align.py narration.mp3 script.txt transcript.json
 
-Saída: JSON [{"text","start","end","score"}] por palavra, bordas já encostadas nos
-silêncios reais (silencedetect embutido). Score perto de 0 = confiável; o helper avisa
-palavras com score < -1.0 (conferir de ouvido).
+Output: JSON [{"text","start","end","score"}] per word, edges already snapped to
+real silences (built-in silencedetect). Score near 0 = reliable; the helper flags
+words with score < -1.0 (check by ear).
 
-## Como converter em tempos de cena/legenda
+## How to convert into scene/caption timings
 
-- Legenda: usar start/end da palavra direto.
-- Corte de cena/elemento: âncora = start da PRIMEIRA palavra da frase que o elemento
-  ilustra. Buscar a palavra de forma MONOTÔNICA (cada âncora procurada a partir da
-  anterior), nunca busca global — palavra repetida ("10", "bónus") pega ocorrência errada.
-- Duração mínima de cena: 1,2s; se a frase for mais curta, empurrar a próxima cena
-  dentro da própria frase dela.
-- Nada aparece antes de ser mencionado; nada continua depois que o assunto mudou.
+- Caption: use the word's start/end directly.
+- Scene cut/element: anchor = start of the FIRST word of the sentence the element
+  illustrates. Search for the word MONOTONICALLY (each anchor searched starting from the
+  previous one), never a global search — a repeated word ("10", "bonus") would grab the wrong occurrence.
+- Minimum scene duration: 1.2s; if the sentence is shorter, push the next scene
+  within that same sentence.
+- Nothing appears before it's mentioned; nothing continues after the subject has changed.
 
-## QA obrigatório antes do render
+## Mandatory QA before rendering
 
-Nenhuma palavra pode sobrepor o miolo de um silêncio real, e cada fim de frase do
-roteiro deve terminar num silêncio. Medir isso, não o desvio de âncoras que o próprio
-método criou. Áudio concatenado de blocos: alinhar bloco a bloco ou conferir fronteiras.
+No word may overlap the core of a real silence, and every sentence end in the
+script must end in a silence. Measure this, not the anchor drift the method itself
+created. Audio concatenated from blocks: align block by block or check the boundaries.
 
-## Limitações honestas
+## Honest limitations
 
-- Precisa do texto exato; não transcreve. Áudio sem roteiro: transcrever com Whisper,
-  revisar o texto à mão e SÓ ENTÃO alinhar com este fluxo.
-- Acentos exigem a flag --romanize (o helper já passa).
+- Needs the exact text; doesn't transcribe. Audio with no script: transcribe with Whisper,
+  review the text by hand and ONLY THEN align with this flow.
+- Accented characters require the --romanize flag (the helper already passes it).

package/src/skills-lib/find-skills/SKILL.md

@@ -7,7 +7,7 @@ description: Helps users discover and install agent skills OR MCP servers when t
 
 This skill helps you discover and install **skills** from the open agent skills ecosystem AND configure **MCP servers** that extend the agent with real tool access. When a request needs a capability you don't have, the missing piece is almost always one of these two — a skill (knowledge/workflow) or an MCP (live tool/API access).
 
-> Skill = conhecimento/fluxo (texto que o agente segue). MCP = acesso real a ferramenta/API (rodar SQL, dirigir browser, gerir ads). Se o pedido precisa AGIR num sistema externo, é MCP; se precisa SABER COMO, é skill.
+> Skill = knowledge/workflow (text the agent follows). MCP = real access to a tool/API (running SQL, driving a browser, managing ads). If the request needs to ACT on an external system, it's an MCP; if it needs to KNOW HOW, it's a skill.
 
 ## When to Use This Skill
 
@@ -134,50 +134,50 @@ If this is something you do often, you could create your own skill:
 npx skills init my-xyz-skill
 ```
 
-## Adicionar um MCP Server
+## Adding an MCP Server
 
-Quando o pedido precisa de **acesso real a uma ferramenta/API** (rodar SQL, dirigir um browser, gerir anúncios, buscar docs de lib atualizadas), o que falta é um **MCP**, não uma skill.
+When the request needs **real access to a tool/API** (running SQL, driving a browser, managing ads, fetching up-to-date lib docs), what's missing is an **MCP**, not a skill.
 
-### Passo 1: Checar o que já existe
+### Step 1: Check what already exists
 
 ```bash
 claude mcp list
 ```
 
-### Passo 2: Ver o registry do Wizz Method (fonte única)
+### Step 2: Check the Wizz Method registry (single source of truth)
 
-Se o projeto tem Wizz Method instalado, o `skills-registry.yaml` já mapeia os MCPs recomendados por área (campos `mcps:` e `mcp_utility:`). Resolva o caminho na ordem:
+If the project has Wizz Method installed, `skills-registry.yaml` already maps the recommended MCPs per area (`mcps:` and `mcp_utility:` fields). Resolve the path in this order:
 
 1. `{project-root}/_wizz/_config/skills-registry.yaml`
 2. `{project-root}/skills-registry.yaml`
 
-Cada entrada traz `id`, `when` e o bloco `server` (command/args/env) pronto. Prefira esse mapa antes de inventar config.
+Each entry has `id`, `when` and the ready-made `server` block (command/args/env). Prefer this map over inventing config.
 
-### Passo 3: Adicionar o MCP
+### Step 3: Add the MCP
 
 ```bash
-# Sintaxe geral (Claude Code):
-claude mcp add <id> [-e VAR=valor ...] -- <command> [args...]
+# General syntax (Claude Code):
+claude mcp add <id> [-e VAR=value ...] -- <command> [args...]
 
-# Exemplos comuns (SEMPRE pin de versão fixa, nunca @latest — supply chain,
-# mesma convenção do skills-registry.yaml; atualizar conscientemente quando
-# necessário):
+# Common examples (ALWAYS pin an exact version, never @latest — supply chain,
+# same convention as skills-registry.yaml; update deliberately when
+# needed):
 claude mcp add context7 -- npx -y @upstash/context7-mcp@3.2.2
 claude mcp add exa -e EXA_API_KEY=$EXA_API_KEY -- npx -y exa-mcp-server@3.2.1
 claude mcp add supabase -e SUPABASE_ACCESS_TOKEN=$SUPABASE_ACCESS_TOKEN -- npx -y @supabase/mcp-server-supabase@0.8.2 --read-only
 ```
-Versões acima são as pinadas hoje em `skills-registry.yaml` — confira lá antes de copiar, pode ter mudado. Não sugira o MCP do Playwright: browser é sempre via CLI `wizz-agent-browser` neste framework, nunca Playwright.
+The versions above are the ones currently pinned in `skills-registry.yaml` — check there before copying, it may have changed. Don't suggest the Playwright MCP: browser automation is always via the `wizz-agent-browser` CLI in this framework, never Playwright.
 
-Ou edite o `.mcp.json` do projeto (merge aditivo, nunca apague servers existentes):
+Or edit the project's `.mcp.json` (additive merge, never delete existing servers):
 
 ```json
 { "mcpServers": { "context7": { "command": "npx", "args": ["-y", "@upstash/context7-mcp@3.2.2"] } } }
 ```
 
-### Passo 4: Secrets
+### Step 4: Secrets
 
-NUNCA escreva token real em arquivo commitado. Use variável de ambiente (`-e VAR=$VAR`) ou placeholder `${VAR}` no `.mcp.json` e peça pro usuário exportar a variável. Avise quais variáveis o MCP exige.
+NEVER write a real token into a committed file. Use an environment variable (`-e VAR=$VAR`) or a `${VAR}` placeholder in `.mcp.json` and ask the user to export the variable. Tell them which variables the MCP requires.
 
-### Quando não há MCP pronto
+### When there's no ready-made MCP
 
-Diga que não existe MCP conhecido pra isso e ofereça resolver com as ferramentas atuais (ex: `wizz-agent-browser` no lugar do MCP playwright, ou chamadas diretas de API).
+Say that no known MCP exists for this and offer to solve it with current tools (e.g. `wizz-agent-browser` instead of the Playwright MCP, or direct API calls).

package/src/skills-lib/pesquisa-de-publico-do-piva/README.md

@@ -1,82 +1,82 @@
-# Pesquisa de Público do Piva — skill para Claude
+# Pesquisa de Público do Piva — a skill for Claude
 
-Transforma **um documento de oferta** em um arsenal completo de pesquisa de público para tráfego pago: seis relatórios encadeados (VoC, Perfil Psicográfico, Níveis de Consciência, Trend, Matriz de Ângulos e Léxico) compilados num HTML navegável por abas, pronto para entregar ao cliente ou usar como base de copy.
+Turns **an offer document** into a complete audience research arsenal for paid traffic: six chained reports (VoC, Psychographic Profile, Levels of Awareness, Trend, Angle Matrix and Lexicon) compiled into a tab-navigable HTML, ready to hand to the client or use as a copy foundation.
 
-Feito por **[@soupiva](https://www.instagram.com/soupiva/)**.
+Made by **[@soupiva](https://www.instagram.com/soupiva/)**.
 
 ---
 
-## O que vem na caixa
+## What's in the box
 
 ```
 pesquisa-de-publico-do-piva/
-├── SKILL.md              → o fluxo de trabalho que o Claude segue
-├── prompts.md            → os seis prompts de pesquisa, testados em produção
+├── SKILL.md              → the workflow Claude follows
+├── prompts.md            → the six research prompts, production-tested
 ├── assets/
-│   └── template.html     → o documento final, já pronto e estilizado
-└── README.md             → este arquivo
+│   └── template.html     → the final document, already styled and ready
+└── README.md             → this file
 ```
 
-O `template.html` já é o relatório inteiro montado — tema escuro, ícones, abas, tabelas, selos de confiança. O Claude só preenche o conteúdo. **Você não precisa programar nada.**
+`template.html` is already the whole report assembled — dark theme, icons, tabs, tables, confidence badges. Claude just fills in the content. **You don't need to write any code.**
 
 ---
 
-## Instalação (Claude web ou desktop)
+## Installation (Claude web or desktop)
 
-1. Baixe o arquivo `pesquisa-de-publico-do-piva.zip` sem descompactar.
-2. Antes de tudo, ligue a execução de código: **Configurações → Capacidades → "Execução de código e criação de arquivos"**. Sem isso, skills não funcionam.
-3. Vá em **Personalizar → Skills**.
-4. Clique em **+ / Adicionar skill** e envie o ZIP.
-5. Deixe a skill **ativada** na lista.
+1. Download the `pesquisa-de-publico-do-piva.zip` file without unzipping it.
+2. First, turn on code execution: **Settings → Capabilities → "Code execution and file creation"**. Without this, skills won't work.
+3. Go to **Customize → Skills**.
+4. Click **+ / Add skill** and upload the ZIP.
+5. Leave the skill **enabled** in the list.
 
-Pronto. Skills que você sobe são privadas da sua conta.
+Done. Skills you upload are private to your account.
 
-### Usando no Claude Code
+### Using it in Claude Code
 
-Descompacte a pasta `pesquisa-de-publico-do-piva/` dentro de `~/.claude/skills/` (para usar em qualquer projeto) ou de `.claude/skills/` na raiz do repositório (para usar só naquele projeto).
+Unzip the `pesquisa-de-publico-do-piva/` folder into `~/.claude/skills/` (to use it across any project) or into `.claude/skills/` at the repo root (to use it only in that project).
 
 ---
 
-## Como usar
+## How to use it
 
-Abra uma conversa, anexe o documento da sua oferta (`.docx`, `.pdf`, `.md` ou `.txt`) e escreva:
+Open a conversation, attach your offer document (`.docx`, `.pdf`, `.md` or `.txt`) and write:
 
 ```
 /pesquisa-de-publico-do-piva
 ```
 
-Ou, sem barra, qualquer coisa nesse espírito:
+Or, without the slash, anything in that spirit:
 
 - "faz a pesquisa dessa oferta"
 - "monta o arsenal disso"
 - "preciso do VoC e da matriz de ângulos desse produto"
 
-O Claude vai ler a oferta, devolver o contexto-base para você confirmar e fazer duas perguntas antes de disparar: **qual recorte de público priorizar** e **se o Trend Report inclui inteligência de concorrência**. Responda e ele roda tudo.
+Claude will read the offer, return the base context for you to confirm, and ask two questions before firing off: **which audience sub-segment to prioritize** and **whether the Trend Report should include competitive intelligence**. Answer and it runs everything.
 
-No fim, você recebe o HTML pronto para abrir no navegador.
+At the end, you get the finished HTML ready to open in the browser.
 
 ---
 
-## O que esta skill NÃO faz
+## What this skill does NOT do
 
-Ela termina na pesquisa. **Não escreve anúncios, roteiros, headlines finais nem criativos.** Os hooks que aparecem na Matriz de Ângulos são direção de escrita construída com o vocabulário do público — matéria-prima para o copywriter, não peça pronta para subir.
+It stops at research. **It doesn't write ads, scripts, final headlines or finished creatives.** The hooks that appear in the Angle Matrix are writing direction built from the audience's own vocabulary — raw material for the copywriter, not a ready-to-run asset.
 
 ---
 
-## O princípio que sustenta o resultado
+## The principle behind the result
 
-Honestidade epistêmica. A skill **não inventa quote, link, data ou estatística**. Cada citação carrega um selo de confiança (verificável / checar verbatim / adaptar) e cada relatório termina com uma seção de limitações declarando o que não foi possível acessar e o que uma segunda rodada preencheria.
+Epistemic honesty. The skill **does not fabricate quotes, links, dates or statistics**. Every quote carries a confidence badge (verifiable / check verbatim / adapt) and every report ends with a limitations section stating what couldn't be accessed and what a second round would fill in.
 
-Isso significa que às vezes você vai receber menos material do que esperava. É proposital: pesquisa com menos quotes reais vale mais do que pesquisa cheia de frase bonita que ninguém nunca disse.
+This means you'll sometimes get less material than you expected. That's intentional: research with fewer real quotes is worth more than research full of pretty phrases nobody ever actually said.
 
 ---
 
-## Dicas para tirar mais da skill
+## Tips to get more out of the skill
 
-- **Ofertas melhores geram pesquisas melhores.** Quanto mais completo o documento (promessa, bônus, preço, objeções, FAQ), mais preciso o contexto-base.
-- **O recorte muda tudo.** "Pessoas que querem aprender X" rende genérico. "Pessoas que já tentaram X e desistiram" rende ouro. Escolha a dor, não o tema.
-- **A fonte-âncora nem sempre é o assunto do produto.** Se você vende um resumo de um livro, talvez a mina não sejam os leitores do livro — sejam as pessoas que vivem o problema que o livro resolve. Diga isso ao Claude na hora de confirmar o contexto.
-- **Rode uma segunda rodada quando os caveats apontarem.** Colar 30–50 comentários reais que você mesmo copiou de vídeos do nicho costuma dobrar a qualidade do Léxico.
+- **Better offers produce better research.** The more complete the document (promise, bonuses, price, objections, FAQ), the more precise the base context.
+- **The segment changes everything.** "People who want to learn X" yields generic results. "People who already tried X and gave up" yields gold. Pick the pain point, not the topic.
+- **The anchor source isn't always the product's subject.** If you sell a book summary, the goldmine might not be the book's readers — it might be the people living the problem the book solves. Tell Claude this when confirming the context.
+- **Run a second round when the caveats point to it.** Pasting 30–50 real comments you copied yourself from niche videos usually doubles the quality of the Lexicon.
 
 ---