⬇️ Descargar los archivos
La skill storm-research está compuesta por dos archivos de texto: o SKILL.md (el pipeline de 4 fases) y el report-template.html (la plantilla del informe). Descarga ambos: no hay instalador, dependencia ni servicio de pago. Elige el idioma: PT-BR o EN ofrecen el mismo método; solo cambia el idioma de los prompts internos.
Ninguno de estos pasos es «instalar» en el sentido tradicional: descargas dos archivos de texto (paso 1), los colocas en la carpeta que revisa el agente (paso 2) y llamas a la skill en lenguaje natural (paso 3). Los siguientes temas detallan cada paso.
⬇️ Descarga la skill y la plantilla
Los dos archivos que componen la skill storm-research. En el siguiente tema los pondrás en .claude/skills/storm-research/ y la skill funciona, sin dependencias, scripts ni servicios de pago.
Elige PT-BR o EN. No hace falta descargar los dos idiomas: un par (SKILL.md + template) es suficiente.
💡 Consejo — ¿PT o EN?
Elige el idioma que te resulte cómodo leer: afecta el idioma de los prompts de las cinco perspectivas y de los títulos del informe. El método, las fases y la verificación son idénticos. Si vas a compartir el briefing con un público angloparlante, descarga la versión EN.
Descarga el par
SKILL.md + report-template.html, en el mismo idioma. Por defecto, están en tu carpeta de descargas.
Mover a la carpeta de la skill
Los dos juntos en .claude/skills/storm-research/ (tema 2).
Confirma que aparece
Pídele a Claude Code que liste las skills (tema 4). Listo para ejecutar.
📁 Dónde colocarlo
Los dos archivos están juntos en una carpeta con el nombre de la skill, dentro de ~/.claude/skills/. Claude Code revisa esta carpeta al iniciarse y descubre la skill por su description del frontmatter. Un detalle importante: dentro de la carpeta, el archivo de instrucciones debe llamarse SKILL.md (sin el sufijo .pt/.en) y la plantilla, report-template.html. Los sufijos de idioma solo sirven para que puedas diferenciarlos al descargar.
🎯 Objetivo: crear la carpeta de la skill y mover los dos archivos descargados dentro de ella, ya con los nombres finales (SKILL.md e report-template.html).
mkdir -p ~/.claude/skills/storm-research mv <PASTA_DOWNLOADS>/storm-research.SKILL.<pt>.md \ ~/.claude/skills/storm-research/SKILL.md mv <PASTA_DOWNLOADS>/report-template.<pt>.html \ ~/.claude/skills/storm-research/report-template.html
Cambia las partes en amarillo: <PASTA_DOWNLOADS> en la carpeta donde el navegador lo guardó (p. ej., ~/Downloads) e <pt> por pt o en, según el idioma que descargaste. El mv ya los renombra con los nombres finales.
✅ Cómo verificar: lista el contenido de la carpeta.
ls ~/.claude/skills/storm-research # esperado: SKILL.md report-template.html
Si aparecen ambos nombres, la skill está en el lugar correcto.
✓ Carpeta correcta
- ✓Los dos archivos JUNTOS en la misma carpeta
- ✓Carpeta con el nombre
storm-research - ✓Archivo de instrucciones llamado
SKILL.md
✗ Dónde suele salir mal
- ✗Archivos dispersos en distintas carpetas
- ✗Mantener el nombre
...SKILL.pt.md - ✗Olvidar el
report-template.html
🔀 Otros agentes
Cómo está hecha la skill solo texto + herramientas nativas, es portátil: funciona en otros agentes de línea de comandos que siguen la misma convención de skills. No cambias nada en los archivos: solo cambia la carpeta raíz. La carpeta interna skills/storm-research/ y los dos archivos siguen siendo idénticos.
~/.claude/skills/storm-research/
~/.codex/skills/storm-research/
~/.agents/skills/storm-research/
🧳 Por qué esto funciona
A storm-research no llama a ningún script, API ni servicio de pago. Usa solo lo que cualquier agente compatible ya ofrece: iniciar subagentes, buscar/abrir páginas web y guardar archivos. Por eso el mismo par de archivos es "instalable" en cualquiera de ellos: basta con ponerlos en la carpeta de skills del agente que usas.
✅ Verificar la instalación
Antes de iniciar una ejecución real, confirma que el agente "ve" la skill. La forma más sencilla es abrir Claude Code en la carpeta donde estás trabajando y pedirlo en lenguaje natural que enumere las skills disponibles.
🎯 Objetivo: confirmar que Claude Code reconoce la storm-research y leyó tu frontmatter.
Liste as skills disponíveis e confirme que "storm-research" aparece. Mostre a descrição dela.
✅ Cómo verificar: Claude responde enumerando las skills y cita storm-research — por lo general repitiendo la description del frontmatter (algo como «ejecutar Storm Research / briefing en HTML con múltiples perspectivas»). Si la skill no aparece, revisa la carpeta y los nombres de los archivos (tema 6) y reinicia la sesión.
💡 Consejo
Si acabas de mover los archivos con la sesión ya abierta, es posible que el agente no haya vuelto a leer la carpeta de skills. Cierra y vuelve a abrir Claude Code para que la explore .claude/skills/ de nuevo.
🎯 Dar contexto
STORM apunta a la sección práctica — el «insight accionable» — en el lector objetivo que identifica en la Fase 0. Si no dices nada, asume "un profesional o responsable de tomar decisiones en el área". Pero, si cuentas quién eres y cuál es tu negocio, cada informe se adapta a tu función, en lugar de dirigirse a una persona genérica.
Sou <fundador de uma agência de automação em n8n>. Quando rodar storm-research, mire o insight acionável no meu papel: <o que eu preciso decidir>.
Cambia las partes en amarillo por tu contexto real. Cuanto más específico sea el rol, más útil será la sección de acciones concretas del informe.
💡 Consejo — contexto persistente
Si ejecutas STORM con frecuencia, vale la pena registrar ese contexto en tu CLAUDE.md del proyecto. Así, cada informe nace enfocado en tu función, sin necesidad de repetir la línea de contexto en cada ejecución. (La personalización más profunda queda para la Ruta 3.)
🧯 Errores comunes
Casi todo problema de «la skill no aparece» o «se ejecutó sin la plantilla» se debe a una de estas cuatro causas. Revisa la columna de la derecha antes de pedir ayuda.
✗ Qué suele fallar
- ✗Carpeta incorrecta, fuera de
.claude/skills/ - ✗Descargaste solo el SKILL.md, sin la plantilla
- ✗Mantuvo el nombre
...SKILL.pt.md - ✗Sin permiso de lectura en la carpeta
✓ La forma correcta
- ✓Carpeta
~/.claude/skills/storm-research/ - ✓Los dos archivos juntos en la carpeta
- ✓Renombrados como
SKILL.mdereport-template.html - ✓Volviste a abrir el agente después de mover los archivos
Recuperación automática (opcional): ¿dónde deben estar los dos archivos de la skill?
📌 Resumen del módulo
Siguiente módulo:
2.3 — El pipeline en 4 fases