Con la skill instalada, indicas un tema y el pipeline ejecuta cinco fases (cian): alcance, perspectivas, mapa, síntesis y verificación, hasta obtener el informe HTML verificado. Es el mapa mental de la Ruta 2.
Mapa de la ruta
Contenido detallado
📄 Anatomía de la skill storm-research
Cómo está hecha la skill por dentro: dos archivos, un frontmatter que la activa y las protecciones que hacen confiable el informe.
La skill son dos archivos en una carpeta: SKILL.md (el pipeline en texto) y report-template.html (la plantilla del informe).
Entender que "skill = dos archivos" desmitifica la instalación y muestra exactamente qué copiar.
SKILL.md · report-template.html · carpeta de la skill.
El bloque de la parte superior del SKILL.md con name, description e argument-hint; a description es el disparador que Claude lee para invocar la skill.
É a description que hace que STORM se active cuando pides una investigación; entender esto evita el "¿por qué no se ejecutó?".
name · description · argument-hint · gatilho.
La skill solo usa herramientas nativas (Agent, Write, búsqueda/fetch en la web); sin scripts externos, APIs ni servicios de pago.
Como es autocontenida, basta con soltar la carpeta en .claude/skills/ y funciona en cualquier máquina.
Autocontenida · portátil · herramientas nativas.
report-template.html es la plantilla visual del informe; el pipeline la clona y la completa, sin reescribir el CSS.
Mantener intacta la plantilla garantiza informes limpios y coherentes: Montserrat, Roboto Mono y resaltado azul.
Template · clonar · identidad visual.
Una ejecución crea alrededor de 9 a 11 agentes: 5 perspectivas en la Fase 1 y ~4 a 6 verificadores en la Fase 4.
Conocer el costo esperado evita sorpresas y te impide ampliar el panel más allá de lo recomendado.
Costo · 5 perspectivas · 1 verificador por clúster.
Las reglas de seguridad de la skill: solo fuentes reales, nada inventado, y lo que no se verifica se degrada o se elimina.
Estas protecciones son las que hacen que el briefing sea confiable: son la "promesa cumplida" del método.
Investigación real · rebajar · verificación obligatoria.
⬇️ Instalar la skill
Descarga la skill, suéltala en la carpeta correcta y confirma que Claude reconoce la skill — con los errores comunes que traban a quienes recién empiezan.
Los cuatro archivos para descargar: SKILL.md e report-template.html, en portugués e inglés.
Es el punto de partida — sin los archivos no hay ninguna skill que instalar. Este módulo incluye los enlaces de descarga.
Descarga · PT/EN · skill + plantilla.
Los dos archivos van juntos en .claude/skills/storm-research/, en tu proyecto o en tu página de inicio.
La carpeta correcta es lo que permite que Claude Code encuentre y reconozca la skill.
.claude/skills · carpeta de la skill · archivos juntos.
La misma skill funciona en otros agentes (Codex y similares); solo cambia la carpeta: .codex/ o .agents/.
Muestra que la skill es portátil y que no estás atado a un único agente.
Portátil · .codex · .agents.
Un prompt simple para que Claude liste las skills y confirme que storm-research aparece.
Confirma que la instalación se realizó correctamente antes de depender de ella.
Listar skills · reconocimiento · verificación.
Contarle a Claude quién eres y cuál es tu negocio para que los informes se enfoquen en tu función.
El contexto hace que el insight accionable hable directamente de tu realidad, no de una persona genérica.
Contexto · lector objetivo · tailored.
Los fallos típicos: carpeta equivocada, solo el SKILL.md sin la plantilla o los permisos de archivo.
Conocer los errores comunes resuelve la mayoría de los casos de «no funcionó» en segundos.
Carpeta incorrecta · falta la plantilla · permisos.
⚙️ El pipeline en 4 fases
Del alcance a la entrega: las fases que convierten un tema en un briefing verificado — alcance, cinco perspectivas, mapa de contradicciones, síntesis y verificación.
Claude lee el tema, lo resume en una línea, identifica al lector objetivo y deriva un topic-slug.
Un buen alcance apunta a la sección práctica para el lector adecuado y nombra el archivo final.
Interpretación · lector objetivo · topic-slug.
Cinco agentes de propósito general activados en un solo mensaje, cada uno con el mismo marco y su perspectiva, en menos de 400 palabras.
Es el corazón multiperspectiva — y ejecutarlo en paralelo es lo que hace viable el panel.
Paralelo · general-purpose · marco compartido.
Claude cruza los cinco briefings y señala los conflictos directos, la evidencia sólida frente a la débil, el acuerdo universal y el punto ciego.
Es la materia prima de los hallazgos y de las etiquetas "apoya/desafía" del informe.
Conflicto directo · acuerdo universal · punto ciego.
Clonar report-template.html y completar el resumen, 5 hallazgos, la conexión oculta, la 6.ª lente, el insight, el límite y las referencias.
Es donde la investigación se convierte en un informe legible, guardado en storm-reports/.
Clonar plantilla · secciones · storm-reports.
Autoevaluación (puntuaciones del 1 al 10, eslabón más débil, sesgo, 6.ª perspectiva) más ~4 a 6 verificadores en paralelo que revisan cada cita.
Es lo que distingue a STORM de un informe común; sin ella, el briefing no es confiable.
Adversarial · verificación · banner.
La entrega posterior a la verificación: el HTML v2, abierto con xdg-open, más un resumen en el chat (marcador, hallazgo universal, frontera).
Saber qué esperar del resultado te ayuda a evaluar la calidad de lo que recibiste.
v2 · marcador · hallazgo universal.
🧭 Tu primer informe
En la práctica: elegir un buen tema, iniciar el pipeline, seguir las lentes, abrir el HTML e iterar hasta obtener una versión mejor.
Un buen tema tiene múltiples puntos de vista y afirmaciones que se pueden comprobar; no es una consulta factual simple.
Elegir el tema correcto es la mitad del resultado; un tema superficial desperdicia todo el panel.
Cuestionado · verificable · adecuación.
Un comando simple: «Ejecuta un Storm Research sobre <seu tópico>. El lector es <seu papel>." — con las partes variables marcadas.
Es el disparador real; saber completarlo es lo que pone el pipeline en marcha.
Prompt · variables · lector objetivo.
Durante la Fase 1 ves 5 subagentes ejecutándose en paralelo; puedes hacer clic y ver el prompt de cada uno.
Seguirlas muestra que la investigación es real y ayuda a confiar en el resultado.
Subagentes · paralelo · transparencia.
Al final de la Fase 1, Claude publica de 2 a 3 líneas que indican dónde convergen las lentes y cuál es la divergencia más marcada.
Es un resumen honesto del panel — no un volcado de los briefings sin procesar en el chat.
Convergencia · divergencia · síntesis.
El informe queda en storm-reports/<slug>-briefing.html; ábrelo con xdg-open (Linux), open (macOS) o start "" (Windows).
Saber cómo abrir el archivo es el último paso para leer tu informe.
xdg-open · ruta · briefing HTML.
Puedes pedir una nueva versión; por ejemplo: "ejecuta la 6.ª lente que falta y genera una V3".
Iterar refina el informe y explora ángulos que la primera pasada dejó fuera.
Iteración · 6.ª lente · V2/V3.