📄 Los dos archivos
La skill storm-research no es un programa complicado. Es una carpeta con dos archivos de texto: o SKILL.md, que describe el pipeline de 4 fases, y el report-template.html, que es la plantilla del briefing final. Nada más. Toda la inteligencia está en el texto de esos dos archivos.
El diagrama de abajo muestra esta estructura anidada: el SKILL.md contiene todo el pipeline (las 4 fases), y junto a él está la plantilla que la Fase 3 clona para generar el informe.
El gran recuadro azul es el SKILL.md — abarca las 4 fases (recuadros cian). La Fase 3 sale del archivo del pipeline y clona o report-template.html para armar el informe. Dos archivos, un pipeline.
.claude/skills/storm-research/ ├── SKILL.md # o pipeline em 4 fases └── report-template.html # o molde do briefing final
Las instrucciones en Markdown. Describe las 4 fases, los prompts de las 5 perspectivas y las reglas de verificación. Es lo que Claude lee y ejecuta.
El HTML vacío con el diseño listo. La Fase 3 completa las secciones; el CSS y la identidad visual no se tocan.
🟡 ¿Nuevo por aquí? — «skill» y «carpeta de la skill»
Una skill es un conjunto de instrucciones que Claude Code carga cuando la necesitas. La "carpeta de la skill" es solo un directorio con el nombre de la skill dentro de .claude/skills/. Todo lo que está en esta carpeta viaja junto, por eso bastan los dos archivos.
🏷️ El frontmatter
En la parte superior del SKILL.md vive el frontmatter: un pequeño bloque entre --- con tres campos. Es la «tarjeta de identidad» de la skill. El campo más importante es la description — es a través de ella que Claude sabes cuándo debe activarse la skill.
--- name: storm-research description: Use quando alguém pedir para rodar Storm Research, aplicar o método STORM em um tópico… executa um pipeline em 4 fases: cinco lentes → mapa de contradições → relatório HTML → revisão adversarial + verificação. argument-hint: "[tópico a pesquisar]" ---
El identificador de la skill. Debe coincidir con el nombre de la carpeta.
El activador. Le dice a Claude cuándo usar la skill, en lenguaje natural.
Consejo sobre qué pasar como argumento: el tema que se va a investigar.
🎯 Por qué la description es el corazón
- •Claude lee todas las descripciones disponibles y elige la skill cuya
descriptionse ajusta a lo que pediste. - •Por eso menciona los activadores: "ejecutar Storm Research", "método STORM", "informe verificado", etc.
- •No escribes un comando especial: lo pides en lenguaje natural y la
descriptionhace de puente.
🟡 ¿Nuevo por aquí? — «frontmatter»
"Frontmatter" es ese bloque de metadatos al inicio de un archivo Markdown, delimitado por --- arriba y abajo. No aparece en el contenido; sirve para que el programa que lee el archivo (aquí, Claude Code) conozca sus datos.
🧳 Autónomo y portátil
La skill es autocontenida: depende únicamente de las herramientas nativas de Claude Code. No hay scripts externos, APIs, claves ni servicios de pago que configurar. Sueltas la carpeta en .claude/skills/ y funciona, en cualquier máquina.
Activa los subagentes general-purpose de las lentes y de los verificadores.
Se usan dentro de los agentes para la investigación real y la verificación de fuentes.
Guarda el informe final en storm-reports/.
✓ Lo que usa
- ✓Herramientas nativas: Agent, Write, búsqueda/fetch web
- ✓O
report-template.htmlque viene en la misma carpeta - ✓Solo la carpeta dentro de
.claude/skills/
✗ Qué NO necesita
- ✗Scripts en Python/Node o un build
- ✗APIs externas, claves o servicios de pago
- ✗Otras skills o dependencias instaladas
Por qué esto importa
La portabilidad significa que compartes la skill enviando una carpeta. Quien la recibe no instala nada: la suelta en .claude/skills/ y funciona. También permite llevarla a otros agentes (lo verás en la Ruta 3) y auditarla, ya que todo es texto legible.
🎨 La plantilla HTML
El segundo archivo, report-template.html, es la plantilla visual. La regla de oro está escrita en la propia skill: clonar la plantilla y completar las secciones — nunca recrear el CSS. El diseño ya está pensado; modificarlo solo introduce inconsistencias.
Fondo claro, diseño sobrio, nivel «tomador de decisiones».
Tipografía fija: título en Montserrat, código en Roboto Mono.
Un solo color de acento. Sin arcoíris de colores.
🧱 Clonar, no reinventar
Piensa en la plantilla como un formulario en blanco: el trabajo de la Fase 3 es completar los campos (resumen, hallazgos, referencias), no rediseñar el papel. El CSS, las fuentes y la paleta permanecen intactos.
- •Cambias el contenido de las secciones, no el estilo.
- •Los distintos informes mantienen la misma identidad: son fáciles de leer y comparar.
💡 Consejo práctico
Personalizar la plantilla con seguridad (sin romper la identidad) es tema de la Trilha 3, módulo «Personalizar y ampliar». Por ahora: trata el CSS como intocable.
💸 Costo: ~9–11 agentes por ejecución
Una ejecución completa crea alrededor de 9 a 11 agentes: 5 perspectivas en la Fase 1 y ~4 a 6 verificadores en la Fase 4. Esto es esperado y previsible: es el precio de cubrir varios ángulos y verificar las citas. El cálculo de abajo muestra de dónde sale el número.
Fase 1 — cinco perspectivas
Profesional práctico, académico, escéptico, economista e historiador. Cinco agentes general-purpose en un único mensaje, en paralelo.
Fase 4 — verificadores
Alrededor de 4 a 6 agentes, uno por cluster de citas relacionadas. Cada uno verifica las afirmaciones contra la fuente primaria.
Total: ~9 a 11 agentes
Las Fases 0, 2 y 3 las realiza la sesión principal, sin agentes. Por eso el costo no se dispara por sorpresa.
⚖️ No infles el pipeline
Más agentes no es mejor. La skill lo indica explícitamente: no ampliar más allá de 5 perspectivas ni usar más de 1 verificador por grupo de citas. La ventaja proviene de la diversidad de roles, no de la cantidad bruta.
🛡️ Protecciones integradas
La skill no es solo un bonito generador de HTML: también incluye protecciones escritas en el propio SKILL.md. Solo investigación real; nada inventado; si una cifra no se puede verificar, se rebaja o se elimina; y la verificación de la Fase 4 es obligatoria. Estas reglas son lo que diferencia un briefing STORM de cualquier texto plausible.
✓ Promesa cumplida
- ✓Cada lente y cada cita apuntan a una fuente real consultada
- ✓El número que no se verifica se degrada o se elimina — nunca se disfraza
- ✓La Fase 4 (verificación) es obligatoria; el banner de verificación debe ser verdadero
- ✓El informe revela que el panel es autoral: la convergencia no es consenso del campo
✗ Señales de alerta (no es STORM)
- ✗Estudios, cifras o URL inventados para «completar» el texto
- ✗Entregar sin ejecutar la Fase 4 de verificación
- ✗Presentar el acuerdo entre perspectivas como prueba independiente
- ✗Ampliar a más de 5 perspectivas pensando que así mejora
Recuperación automática (opcional): ¿qué afirmación sobre la skill storm-research es correcta?
📌 Resumen del módulo
Siguiente módulo:
2.2 — Instalar la skill (con los enlaces de descarga)