danielsite.dev← Recursos

Para quien construye con Claude Code

Entiende tu app en un solo video

Un prompt. Claude lee tu proyecto completo y te entrega un video con voz y diagramas animados que explica tu app tan simple que se la puedes enseñar a tu mamá.

1 promptlo copias y lo pegas
5–10 minde video con voz
100% localtu código no sale de tu compu

Cómo se corre

Tres pasos, tú haces uno.

  1. 1

    Abre Claude Code en tu proyecto

    En la terminal, entra a la carpeta de tu app y escribe claude.

  2. 2

    Pega el prompt de abajo

    Claude revisa qué tienes instalado y te dice si falta Node.js, Python o ffmpeg.

  3. 3

    Aprueba la lista de escenas

    Es lo único que te pregunta. Después instala, escribe, graba la voz, anima y revisa el video solo.

El prompt

Cópialo tal cual.

Prompt · Claude Code
Quiero entender esta app en un video. Hazlo tú de principio a fin.

QUÉ QUIERO
Un video MP4 de 1920x1080 con voz en español y animaciones que explique cómo funciona esta app: qué hace, cómo entran los datos, dónde se guardan, cómo se conectan las partes y cómo se publica.

CÓMO EXPLICARLO
- Simple, como si se lo explicaras a un niño de 10 años: ejemplos de la vida diaria y cero jerga. Si usas un término técnico, explícalo en una frase.
- Diagramas simples de cajas y flechas, máximo 6 cajas por escena.
- Cada parte del diagrama aparece justo cuando la voz la menciona.
- Duración: de 5 a 10 minutos.

REGLAS
- Solo lectura: no modifiques nada del proyecto. Todo lo nuevo va en la carpeta guia-video/.
- Cada dato sale del código (archivo:línea). Lo que no puedas comprobar, dilo como "sin verificar". No adivines.
- Nunca muestres llaves, contraseñas, archivos .env, URLs de bases de datos ni datos de clientes.
- Todo local: no subas el código ni el audio a servicios externos.

HERRAMIENTAS
- Video: Remotion (npx create-video@latest).
- Voz: Piper (pip install piper-tts) con la voz es_MX-claude-high.
- Genera un audio por frase y mide su duración real con ffprobe, para que la animación caiga exacta con la voz.
- Si me falta Node.js, Python o ffmpeg, dime cómo instalarlo y espera.

ANTES DE ENTREGAR
- Primero muéstrame la lista de escenas y espera mi OK.
- Al terminar, revisa el video: saca cuadros con ffmpeg y confirma que nada está cortado y que la animación coincide con la voz. Corrige lo que falle.
- Dame la ruta del video, la duración y la lista de lo "sin verificar".

"Como para un niño"

Obliga a la IA a usar ejemplos y a explicar cada término. Sale mejor explicado para todos, también para ti.

Un audio por frase

Así Claude sabe el segundo exacto en que empieza cada frase y la animación cae con la voz.

"Sin verificar"

Si algo no está en el código, lo dice. Mejor un hueco marcado que una explicación inventada.

Revisión al final

Claude mira cuadros del video antes de decir "listo". Los agentes dicen "listo" con mucha seguridad.

Ajústalo

¿No te gusta algo? Pídelo así.

Cámbialo en el prompt o díselo a Claude después con la frase de la derecha.

PiezaPor defectoDile
FormatoHorizontal 1920x1080"Hazlo vertical 1080x1920 para Reels"
Duración5 a 10 minutos"Resume todo en 2 minutos"
NivelPara un niño de 10 años"Explícalo para un desarrollador junior"
VozPiper es_MX, local y gratis"Usa la voz de mi sistema"
EstiloEl que Claude elija"Fondo negro, texto blanco, sin colores"
VideoRemotion"Hazlo con HTML animado y grábalo con Playwright"
IdiomaEspañol"Hazlo en inglés con una voz en_US"

Si algo falla

Lo que más pasa.

Piper no se instala

Dile a Claude: "usa la voz de mi sistema". En Windows y Mac ya trae una voz en español; suena menos natural, pero funciona igual.

El render tarda mucho

Es normal: un video de 10 minutos puede tardar varios minutos en generarse. Para probar rápido, pide primero "solo las 2 primeras escenas".

La animación no va con la voz

Dile: "revisa la sincronización sacando un cuadro al inicio de cada frase y corrige". Eso hace que use los tiempos reales del audio.

Algo se ve cortado

Dile: "nada de zoom ni movimientos de cámara; el diagrama completo siempre visible".

¿Remotion es gratis?

Sí para personas, organizaciones sin fines de lucro y empresas de hasta 3 empleados. Si tu empresa es más grande, revisa su licencia.

¿Lo puedo enseñar a otros?

Si la app es tuya, sí. Si es de un cliente o de tu empresa, pide permiso antes de compartir el video, y revisa la lista de lo "sin verificar" con alguien que conozca el sistema.