Kit + skill para Claude Code · 9:16

Reels de ciencia «¿Y si…?» hechos solo con código

Tú haces la pregunta y decides en qué confías. Claude investiga las fuentes, construye el mundo 3D, genera la voz en tu computadora y entrega el MP4. Ninguna imagen fue dibujada por IA y el renderizado es gratis.

Banner: Ciencia en código: reels ¿Y si…? en 3D con fuente en cada dato
En resumen

reel-ciencia-3d es un kit con una skill para Claude Code: convierte una pregunta como «¿Y si la Tierra no tuviera inclinación?» en un video vertical de unos 60 segundos para Reels, Shorts y TikTok. Está pensado para docentes, divulgadores y creadores que quieren hacer videos de ciencia sin equivocarse con los datos. Todo se crea con código (HyperFrames para el video, Three.js para el 3D), cada dato aparece con su fuente, la voz se genera en tu computadora y el reel vuelve al inicio sin salto. Necesitas Node.js, ffmpeg y Claude Code.

Qué es

Por qué código y no IA de video

La ciencia exige datos exactos. Un generador de video se equivoca en las etiquetas, cambia el gráfico de una escena a otra y cada corrección cuesta créditos. Con código, el dato que aparece en pantalla es el que escribiste.

Banner: hechos con fuentes, mundo 3D, voz local, subtítulos palabra por palabra, vuelve al inicio, renderizado gratis

📚 Fuente para cada dato

Antes de animar, Claude escribe fatos.md. Sin fuente (NASA, NOAA, la Marina, una universidad), el dato no aparece en pantalla ni en la voz. Los cálculos propios se marcan como CÁLCULO.

🌍 Mundo 3D con dos apariencias

Los mismos objetos aparecen como el mundo actual y como una «planta técnica» azul del mundo «¿y si…?». Hay un globo con los continentes reales (Natural Earth) y un solo color cálido: el amarillo del elemento principal.

🎙️ Voz local sincronizada con cada palabra

La voz se genera en tu computadora (Chatterbox + Whisper) con el tiempo de cada palabra. Los subtítulos, las tarjetas y la cámara aparecen justo cuando se dice cada palabra.

Cómo funciona

Tú diriges, Claude es el estudio

Tú tomas cuatro decisiones: la herramienta, los datos, el mensaje con los elementos visuales y tu evaluación del resultado. Claude y los scripts se encargan del resto del trabajo pesado.

Pregunta «¿Y si…?»→ fatos.md con fuentes→ roteiro.json→ voz + tiempo por palabra→ mundo 3D + tarjetas→ 1 imagen por escena→ MP4 1080×1920

🧠 Tú

Eliges la pregunta y la respuesta que el reel debe demostrar, apruebas el guion, revisas las imágenes fijas y pides un cambio a la vez.

🤖 Claude Code

Investiga y verifica las fuentes, escribe el guion, crea la página y el 3D, genera las imágenes de revisión y evalúa el MP4 con las 3 preguntas.

📖 Términos del kit

HyperFrames: convierte una página HTML animada en MP4. Three.js: 3D en el navegador. Indicador: medidor fijo en la esquina (inclinación, cronómetro). Bloque: cada parte del guion. Planta técnica: apariencia azul del mundo «¿y si…?». LUFS: medida de volumen de las redes (−14). Skill: instrucciones que Claude Code sigue automáticamente. Whisper: transcribe la voz y marca el tiempo de cada palabra.

⚙️ Scripts del kit

voz.py (voz + Whisper), montar.py (reloj y subtítulos), mezcla.py (música por código), preparar.py y HyperFrames para revisar y renderizar.

Requisitos previos

Qué necesitas tener instalado

El renderizado, la voz y la música funcionan en tu computadora. El único costo es tu plan de Claude.

Node.js 22+, ffmpeg y Python 3

HyperFrames se descarga solo la primera vez (junto con el navegador que renderiza). La música por código usa numpy.

node --version
ffmpeg -version
python3 -m pip install numpy
npx hyperframes doctor  # indica qué falta

Claude Code (o Codex)

instalar.sh conecta la skill con ambos y prueba el ejemplo.

git clone https://github.com/inematds/reel-ciencia-3d
cd reel-ciencia-3d
bash instalar.sh

Voz local (opcional)

voz.py usa Chatterbox (genera la voz a partir de ~15 s de una grabación tuya) y Whisper (escucha y marca el tiempo de cada palabra), instalados mediante inemavox (kit abierto de voz y transcripción local; sigue su README (en portugués)). Si no los tienes, usa el modo sin voz del paso 3.

export INEMAVOX_DIR=~/inemavox          # Whisper + worker de Chatterbox
export CHATTERBOX_PYTHON=~/miniconda3/envs/chatterbox/bin/python3
export VC_VOZ=/ruta/tu-voz.wav      # ~15 s limpios
export VC_IDIOMA=es                # idioma de la voz y la alineación (por defecto: pt)
Guía de uso · paso a paso

De la pregunta al MP4 en 8 pasos

Reemplaza <id> por el nombre de la carpeta de tu reel (p. ej., dia-48h). Los 3 ejemplos de exemplos/ se hicieron exactamente así.

1

Pega la tarjeta de solicitud con tu pregunta

Abre Claude Code en la carpeta del kit y pega la tarjeta de prompts/1-cartao-de-pedido.md (en portugués), cambiando la pregunta, la respuesta, los bloques y el indicador.

# fragmento de la tarjeta
Usa la skill reel-ciencia-3d. Haz un reel vertical de ~60 s: «¿Y si el día durara 48 horas?»
1. Primero, los datos. Escribe exemplos/dia-48h/fatos.md: cada dato con su fuente...
2

Revisa fatos.md antes de cualquier escena

Es la decisión más importante. Lee la tabla «Dejado fuera»: ahí quedan las curiosidades famosas sin fuente. Tú decides en qué confías.

cat exemplos/<id>/fatos.md   # fuente + cita + fecha en cada línea
3

Genera la voz, el reloj y la música

La voz marca el ritmo del reel: cada subtítulo, tarjeta y movimiento de cámara se sincroniza con el tiempo de las palabras. <rid> es el campo "id" de roteiro.json (en los ejemplos: terra, sol, lua). mezcla.py crea la música por código y la mezcla con la voz.

# carpeta nueva a partir del ejemplo (solo la página y el código 3D; la voz y el sonido se generan abajo)
mkdir -p exemplos/<id>/js
cp exemplos/terra-sem-inclinacao/{index.html,hyperframes.json,package.json,roteiro.json} exemplos/<id>/
cp exemplos/terra-sem-inclinacao/js/mundo.js exemplos/<id>/js/
# edita exemplos/<id>/roteiro.json: "id", "tela" (voz → pantalla) y los bloques b0…bN con las frases

# con voz local
python3 ferramentas/voz.py --projeto exemplos/<id> exemplos/<id>/roteiro.json
python3 ferramentas/montar.py --projeto exemplos/<id>      # → js/tempos.js (subtítulos listos)
python3 ferramentas/mezcla.py --projeto exemplos/<id> --id <rid> --musica tranquila

# sin voz: solo subtítulos y música (el tiempo de cada palabra se estima a partir del texto)
python3 ferramentas/montar.py --projeto exemplos/<id> --sem-voz   # muestra el "fin" en segundos
python3 ferramentas/mezcla.py --projeto exemplos/<id> --id <rid> --duracao <fin> --musica tranquila
4

Claude crea la página y el mundo 3D

Cambia el contenido de la página copiada en el paso 3: indicador en la parte superior, tarjetas con la línea de la fuente y las escenas de js/mundo.js. preparar.py configura el sonido para el reel de esa carpeta.

python3 ferramentas/preparar.py --projeto exemplos/<id>   # motor + duración + sonido final
cd exemplos/<id> && npx hyperframes check            # 0 errores
5

Revisa una imagen por escena antes de renderizar

Revisar una imagen toma segundos; corregir una animación terminada lleva mucho más. Elige segundos que caigan en medio de cada bloque de tu reel (montar.py muestra el final; los bloques están en js/tempos.js).

npx hyperframes snapshot --at 0,5,15,25,35,45,55,67 --no-end -o stills
6

Evalúa con 3 preguntas y pide un cambio a la vez

¿Se puede leer todo en el celular? ¿La escala es honesta? ¿Hay algo claro que mirar? Pide un solo cambio a la vez y deja todo lo demás igual.

Cambia solo la cámara de la escena de la Antártida para que se vea completa la estación. Mantén todo lo demás igual. Vuelve a generar la imagen.
7

Renderiza

Unos 5 minutos para un reel de 65 s, en tu computadora.

npx hyperframes render --output renders/<id>.mp4
8

Evalúa el MP4 final y publícalo

Revisa fotogramas del archivo final, no de la vista previa. Comprueba las dimensiones y el volumen, y sigue checklists/antes-de-publicar.md (en portugués).

ffmpeg -i renders/<id>.mp4 -vf fps=1/3,scale=216:-1,tile=8x3 renders/folha.jpg
ffprobe renders/<id>.mp4                      # 1080x1920, 30 fps
ffmpeg -i renders/<id>.mp4 -af ebur128 -f null -   # ≈ −14 LUFS
Ejemplos

3 reels hechos con el propio kit

Cada uno incluye fatos.md, roteiro.json, el código del mundo 3D, la voz y el sonido listos en exemplos/<id>/. El MP4 se genera con npx hyperframes render dentro de la carpeta. Los 3 reels están narrados en portugués.

¿Y si la Tierra no tuviera inclinación? Indicador 23,4° → 0°. Porto Alegre, Manaus, Estación Antártica Comandante Ferraz, el Sol rodando sobre el horizonte del polo y Júpiter. Ver en YouTube ↗
¿Y si el Sol desapareciera ahora? Cronómetro «tiempo sin Sol». Los 8 min 20 s que tarda la luz, la Tierra saliendo de su órbita en línea recta y la vida en las fuentes hidrotermales. Ver en YouTube ↗
¿Y si la Luna desapareciera? Las mareas de São Luís, los corales que desovan con la Luna y el eje de la Tierra, con la salvedad de que aún hay aspectos en debate. Ver en YouTube ↗
Próximamente

Qué sigue

El formato se puede repetir; el tema y la investigación, no. Cada reel debe enseñar algo nuevo.

Ahora
Kit, skill y 3 ejemplosMotor con dos apariencias, globo con continentes reales, voz local, subtítulos palabra por palabra y listas de verificación.
Siguiente
Versiones EN y ES de los reelsMismo código, guion traducido y voz en el idioma correspondiente.
Después
Más escenas listas en el motorOcéano con olas, ciudad nocturna y sistema solar a una escala realista.