🔵 Prática

A skill são dois arquivos numa pasta: SKILL.md (o pipeline em texto) e report-template.html (o molde do relatório).

Entender que "skill = dois arquivos" desmistifica a instalação e mostra exatamente o que copiar.

SKILL.md · report-template.html · pasta da skill.

O bloco no topo do SKILL.md com name, description e argument-hint; a description é o gatilho que o Claude lê para invocar a skill.

É a description que faz o STORM disparar quando você pede uma pesquisa — entender isso evita o "por que não rodou?".

name · description · argument-hint · gatilho.

A skill usa apenas ferramentas nativas (Agent, Write, busca/fetch na web); sem scripts externos, APIs ou serviços pagos.

Por ser autocontida, basta soltar a pasta em .claude/skills/ e ela funciona em qualquer máquina.

Autocontida · portátil · ferramentas nativas.

report-template.html é o molde visual do relatório; o pipeline o clona e preenche, sem reescrever o CSS.

Manter o template intacto garante relatórios limpos e consistentes — Montserrat, Roboto Mono e destaque azul.

Template · clonar · identidade visual.

Uma execução cria cerca de 9 a 11 agentes: 5 lentes na Fase 1 e ~4 a 6 verificadores na Fase 4.

Saber o custo esperado evita surpresa e te impede de inflar o painel além do recomendado.

Custo · 5 lentes · 1 verificador por cluster.

As regras de segurança da skill: só fontes reais, nada inventado, e o que não verifica é rebaixado ou cortado.

São essas proteções que tornam o briefing confiável — é a "promessa cumprida" do método.

Pesquisa real · rebaixar · verificação obrigatória.

Os quatro arquivos para download: SKILL.md e report-template.html, em português e inglês.

É o ponto de partida — sem os arquivos não há skill para instalar. Este módulo carrega os links de download.

Download · PT/EN · skill + template.

Os dois arquivos vão juntos em .claude/skills/storm-research/, no seu projeto ou na sua home.

A pasta certa é o que faz o Claude Code encontrar e reconhecer a skill.

.claude/skills · pasta da skill · arquivos juntos.

A mesma skill funciona em outros agentes (Codex e afins); só muda a pasta — .codex/ ou .agents/.

Mostra que a skill é portátil e que você não fica preso a um único agente.

Portabilidade · .codex · .agents.

Um prompt simples para o Claude listar as skills e confirmar que storm-research aparece.

Confirma que a instalação deu certo antes de você depender dela.

Listar skills · reconhecimento · checagem.

Contar ao Claude quem você é e qual o seu negócio, para que os relatórios mirem no seu papel.

Contexto faz o insight acionável falar diretamente com a sua realidade, não com uma pessoa genérica.

Contexto · leitor-alvo · tailored.

As falhas típicas: pasta errada, só o SKILL.md sem o template, ou permissões de arquivo.

Conhecer os erros comuns resolve a maioria dos "não funcionou" em segundos.

Pasta errada · template ausente · permissões.

O Claude lê o tópico, resume em uma linha, identifica o leitor-alvo e deriva um topic-slug.

Um bom escopo mira a seção prática no leitor certo e nomeia o arquivo final.

Interpretação · leitor-alvo · topic-slug.

Cinco agentes general-purpose disparados numa única mensagem, cada um com o mesmo frame e a sua lente, em menos de 400 palavras.

É o coração multi-perspectiva — e rodar em paralelo é o que torna o painel viável.

Paralelo · general-purpose · frame compartilhado.

O Claude cruza os cinco briefings e nomeia conflitos diretos, evidência forte versus fraca, acordo universal e ponto cego.

É a matéria-prima dos achados e dos chips "apoia/desafia" do relatório.

Conflito direto · acordo universal · ponto cego.

Clonar report-template.html e preencher resumo, 5 achados, conexão oculta, 6ª lente, insight, fronteira e referências.

É onde a pesquisa vira um relatório legível, salvo em storm-reports/.

Clonar template · seções · storm-reports.

Autoavaliação (notas 1–10, elo fraco, viés, 6ª lente) mais ~4 a 6 verificadores em paralelo conferindo cada citação.

É o que separa STORM de um relatório comum; sem ela, o briefing não é confiável.

Adversarial · verificação · banner.

A entrega pós-verificação: o HTML v2, aberto com xdg-open, mais um resumo no chat (placar, achado universal, fronteira).

Saber o que esperar na saída ajuda a julgar a qualidade do que você recebeu.

v2 · placar · achado universal.

Um bom tópico tem múltiplos pontos de vista e afirmações que dá para checar — não uma consulta factual simples.

O tópico certo é metade do resultado; um tópico raso desperdiça o painel inteiro.

Contestado · checável · adequação.

Um comando simples — "Rode um Storm Research sobre <seu tópico>. O leitor é <seu papel>." — com as partes variáveis marcadas.

É o gatilho real; saber preenchê-lo é o que coloca o pipeline para rodar.

Prompt · variáveis · leitor-alvo.

Durante a Fase 1 você vê 5 subagentes rodando em paralelo; dá para clicar e ver o prompt de cada um.

Acompanhar mostra que a pesquisa é real e ajuda a confiar no resultado.

Subagentes · paralelo · transparência.

Ao fim da Fase 1, o Claude posta 2 a 3 linhas dizendo onde as lentes convergem e qual é a divergência mais forte.

É um resumo honesto do painel — não um despejo dos briefings brutos no chat.

Convergência · divergência · síntese.

O relatório fica em storm-reports/<slug>-briefing.html; abra com xdg-open (Linux), open (macOS) ou start "" (Windows).

Saber abrir o arquivo é o último passo para ler seu briefing.

xdg-open · caminho · briefing HTML.

Você pode pedir uma nova versão — por exemplo: "rode a 6ª lente ausente e gere uma V3".

Iterar refina o relatório e explora ângulos que o primeiro passe deixou de fora.

Iteração · 6ª lente · V2/V3.