Communitygithub.com

DemoDay

Convierte un repositorio (GitHub o carpeta local) y su app web o macOS nativa en un video demo de 45–75s a 1080p, con storyboard, grabación guionada y estilo visual acorde a la aplicación.

¿Qué es DemoDay?

DemoDay es una herramienta CLI en Node/TypeScript que transforma un repositorio de código (GitHub o local) y su aplicación web o macOS nativa en un video promocional de alta calidad (45–75 segundos, 1080p). Funciona como un director de producción: tú defines el storyboard (`plan.json`) y la herramienta graba, captura y renderiza el video automáticamente, sin necesidad de claves API externas. El video incluye zooms automáticos, subtítulos, efectos de sonido sintetizados y una apariencia que coincide con los colores, tipografías e iconos de la aplicación original, dando un resultado profesional y consistente con la marca. La habilidad soporta tanto aplicaciones web (grabando desde el navegador) como aplicaciones nativas de macOS (usando la API de Accesibilidad y ScreenCaptureKit). El flujo de trabajo incluye: preparación del repositorio y captura de snapshot, análisis de diseño (colores, fuentes, mascota), escritura del storyboard estructurado, grabación guionizada paso a paso, renderizado con Remotion y revisión visual del video final. Además, gestiona automáticamente efectos de sonido, música de fondo y animaciones de transición, y permite re-renderizados rápidos sin regrabar si solo cambian aspectos visuales o de sonido. Es ideal para desarrolladores, startups y equipos de producto que quieran generar videos de lanzamiento, demostraciones o tutoriales de sus aplicaciones de forma automatizada y con alta fidelidad visual.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/amoveablefeastym/demoday/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace DemoDay?

Convierte un repositorio (GitHub o una carpeta local) + su aplicación web o app macOS nativa en un video demo de 45–75s a 1080p que parece hecho por el propio diseñador de la app. La herramienta es una CLI Node/TS que se entrega con esta habilidad. Tú eres el director: escribes el storyboard (plan.json); la herramienta graba y renderiza. No se necesita clave API.

0. Encontrar y configurar la herramienta (TOOL)

TOOL es el directorio base de esta habilidad si contiene package.json (instalación normal: el repositorio completo clonado en ~/.claude/skills/demoday). De lo contrario, es ~/demoday. Si ninguno existe, detente e indica al usuario que siga los pasos de instalación en el README.

Primera ejecución en una máquina (cuando falta TOOL/node_modules):

  1. Verifica node --version (necesita ≥ 20). Si falta, dile al usuario que instale Node.js (brew install node o nodejs.org) y detente.
  2. Ejecuta npm install && npx playwright install chromium en TOOL. Descarga ~300 MB, así que avisa al usuario antes de empezar.
  3. Para una app macOS, también verifica xcrun swiftc --version. Si falta, pide al usuario que ejecute xcode-select --install. El helper se compila solo en el primer uso.

Todos los comandos siguientes se ejecutan desde TOOL. OUT = out/<owner>__<repo> (lo imprime la herramienta). Los videos se guardan dentro de TOOL/out/, así que dile al usuario la ruta completa.

1. Recopilar

npx tsx src/cli.ts <owner/repo o url github> [--url <url app viva>] --prepare

Necesita una URL web activa (--url, o la página principal del repo) — o, para una app macOS nativa, consulta "Apps nativas macOS" más abajo. Esto lee el repositorio y sondea la app, escribiendo en OUT: prompt.md (reglas del director + README + manifiestos + árbol de archivos + snapshot de accesibilidad), probe.png (captura de primera pantalla), probe.aria.yml.

Lee prompt.md y mira probe.png. Lee src/schema.ts — es la forma exacta de plan.json, y sus descripciones de campos son reglas (límites de palabras, qué debe hacer cada beat).

2. Encontrar la historia antes de escribir nada

El video vive o muere por dos cosas: por qué el statu quo es malo y qué tiene de especial este producto.

  • Statu quo: el flujo de trabajo concreto que el usuario objetivo hace hoy sin este producto, con un costo de tiempo honesto por paso. Solo afirmaciones justas sobre competidores nombrados.
  • Especial: el mecanismo que lo hace posible (del README/código), no adjetivos. "Solo X …".
  • Lee el código para funciones que el README minimiza: un icono siempre presente en escritorio o barra de menús, un atajo global, almacenamiento local/local, una mascota. A menudo son los verdaderos diferenciadores. Verifica cada funcionalidad que afirmes en el código antes de ponerla en el video.
  • Si el usuario te dijo su posicionamiento, competidor o diferenciador, usa el suyo. Si nada revela qué lo hace diferente, haz una pregunta corta antes de escribir el plan.

3. Igualar el estilo de la app (obligatorio)

El video debe verse como parte de la app: mismos colores, mismas fuentes, misma mascota o icono, mismo tono de voz. Una plantilla de lanzamiento oscura genérica sobre una app acogedora pastel (o viceversa) se percibe como fuera de marca. Los usuarios lo notan de inmediato.

  1. Extrae los tokens de diseño de la app del código:
    • SwiftUI/AppKit: un archivo tipo Theme.swift, Assets.xcassets/*.colorset, llamadas Color(hex:).
    • Web: propiedades personalizadas CSS, tailwind.config.*, archivos de tema, <meta name="theme-color">.
    • Recopila: fondo, texto, tarjeta/panel, acento, y las fuentes display/body.
    • Fuentes: prefiere archivos de fuente incluidos en el repo (Resources/Fonts/*.ttf, public/fonts, fuentes @font-face, next/font/local).
    • Mascota/icono: sprites, el icono de la app (AppIcon.icns → sips -s format png … --out icon.png), o el logo SVG/favicon.
  2. Elige el estado de ánimo de la interfaz de la app, no de su categoría. Usa mood: "soft" cuando la UI es clara, cálida, juguetona o minimalista. Usa bold (el look oscuro de lanzamiento por defecto) cuando la app es oscura, técnica o de alto contraste.
  3. Rellena plan.look:
    "look": { "mood": "soft", "paper": "<bg app>", "ink": "<texto app>", "surface": "<tarjeta app>",
              "fontFile": "<archivo fuente repo>", "bodyFontFile": "<opcional>",
              "motifImage": "<icono/mascota app png/svg>" }
    
    • Establece product.accent al acento de la app, en el tono que sea legible sobre paper. Los acentos en modo claro suelen ser la elección correcta para soft.
    • El texto atenuado y las líneas se derivan automáticamente de paper/ink.
    • Sin archivo de fuente, usa display (Inter Tight, Pixelify Sans, Fredoka, Nunito). Para añadir otra fuente de Google, agrégala a DISPLAY en remotion/lib.ts y al enum del esquema.
    • motif: "loaf" es un sprite de loaf de píxeles incorporado (solo apps de panadería). De lo contrario, usa motifImage.
    • La CLI copia estos archivos en OUT/brand/. Las rutas pueden ser absolutas o relativas a un repo local.
  4. Iguala la voz: toma prestados los microtextos y metáforas de la app para subtítulos y titulares (ej. una app de panadería: "masa / levando / horneado").
  5. Mínimo por defecto:
    • Presupuesto de copia: gancho ≤ 8 palabras, unos 3 pasos de la forma antigua, 3 filas de comparación, subtítulos de 2–5 palabras, sin etiquetas ni estadísticas más allá de lo esencial.
    • Demasiadas palabras y un estilo de advertencia rojo fuerte fueron las quejas principales. El look soft ya elimina contadores, etiquetas de dolor, sacudidas y sellos.

4. Escribir OUT/plan.json

Sigue las reglas de director al inicio de prompt.md. Reglas de grabación (newWay.actions):

  • Cubre todo el bucle principal, no solo el camino más corto a un resultado. Los usuarios notan cuando faltan funciones destacadas. Apunta a 10–20 acciones (máx. 20), cada funcionalidad su propio beat con subtítulo, haciendo el mismo trabajo que la forma antigua y terminando en el beneficio. Web: la primera acción es goto a la URL activa.
  • Subtitula casi cada acción. Un beat sin subtítulo se siente como silencio para un espectador con audio silenciado.
  • Cámara: se acerca al cuadro del objetivo de cada acción. Las acciones fill/press sin objetivo apuntan al campo que tiene el foco. El grabador registra su posición después de enviar las teclas, y los planos de escritura hacen zoom a 2× al inicio del texto. Los subtítulos se colocan en su propia banda debajo de la ventana y nunca cubren la app. Si un plano enfoca lo incorrecto, corrige el objetivo. No edites cuadros manualmente.
  • Selectores vienen del snapshot. Prefiere {role, name} copiado textualmente (macOS: id, luego placeholder, luego role+name). Las entradas ocultas dentro de editores de código están bien; el grabador hace clic en su contenedor visible.
  • Guioniza pantallas más profundas a partir de snapshots reales, no de suposiciones:
    1. Escribe un script desechable que navegue hasta allí y termine con un clic en un id inexistente.
    2. Ejecútalo: mac/.build/macdriver run --app X.app --out <scratch> --script s.json -- --demo <scratch>/data. El archivo es {"actions":[…]}. Web: una ejecución --from plan.
    3. Lee failures[].aria en <scratch>/events.json.
  • Escritura: valores fill > 80 caracteres se pegan; los más cortos se escriben visiblemente. Usa datos realistas, nunca "test". Si las pulsaciones se pierden justo después de un clic en un nuevo campo (título truncado, campo vacío, clic posterior que no encuentra el texto), divídelo: haz click en el campo, wait 500, luego fill sin objetivo.
  • Beneficio: exactamente una acción tiene emphasis: true. Ponla en un wait final (~2000ms) con un subtítulo, justo después del clic que lo desencadena, no en el clic mismo. La cámara se aleja para mostrar el resultado completo, y las esperas con énfasis se reproducen en tiempo real. Otras esperas largas se aceleran.
  • Beat de lanzador: si la app vive como un icono siempre presente (escritorio, barra de menús) o detrás de un atajo global, establece plan.launcher (captions, hint opcional como el atajo, badge opcional).
    • El video entonces tiene un beat antes del recorrido: el icono se sienta en un escritorio tranquilo entre ventanas borrosas, el cursor hace clic en él, y la ventana real crece a partir de él, aterrizando exactamente donde comienza el recorrido.
    • Se compone en Remotion (el grabador solo captura la ventana de la app) y usa motifImage/motif como icono. Úsalo solo cuando el código confirme el comportamiento.

5. Grabar + renderizar

npx tsx src/cli.ts <repo> --plan OUT/plan.json --from plan

Observa el log: ✓ por acción, ✗ con el error en fallos. En caso de fallo, lee OUT/events.json → failures[] (cada uno tiene el snapshot de accesibilidad en el momento del fallo), corrige los objetivos y vuelve a ejecutar. Las acciones fallidas se saltan, no son fatales. No entregues un video cuyo beneficio haya fallado. Si una acción temprana falla, todo lo posterior normalmente se ejecuta en la pantalla equivocada: trata toda la grabación como mala y mira los fotogramas de raw.mp4 para ver qué pasó realmente.

Re-ejecutar de forma barata:

  • Cambios en copia, look, launcher, sonido o código de escena: --from render, sin regrabar.
  • Subtítulos de acciones están incrustados en events.json en el momento de la grabación. Parchéalos allí desde plan.json (por index), reconstruye la línea de tiempo con npx tsx -e 'import {editRecording} from "./src/edit.ts"; editRecording("OUT")', luego --from render.
  • Cambios de paso: --from plan (regraba).

6. Revisar antes de informar

Revisa el MP4 renderizado, no solo las imágenes fijas. Haz hojas de contacto y mira cada fotograma:

ffmpeg -v error -y -i OUT/demo.mp4 -vf "fps=1/2,scale=640:-1,tile=4x8" -frames:v 1 <scratch>/sheet.jpg

Verifica:

  • Coincidencia de estilo: pon probe.png junto a las imágenes fijas. ¿Misma familia de fondo, fuentes, acento y mascota? Si el video parece de otra marca, corrige look antes que nada.
  • Cada valor fill aparece en pantalla exactamente como se escribió. Un ✓ solo significa que la acción se ejecutó, no que el texto se depositó.
  • La cámara está enfocada en lo que importa (el texto que se escribe, el control que se pulsa), no en plano general o sobre un lienzo vacío.
  • Los subtítulos son legibles y nunca cubren la app. El texto cabe; nada se desborda.
  • El fotograma "ajá" muestra el beneficio (no un estado de carga ni un botón recortado).
  • El beat de comparación "X → Y" es creíble. Si la relación es absurda, los segundos de la forma antigua están inflados.
  • El audio existe y no supera 0 dB: ffmpeg -i OUT/demo.mp4 -af volumedetect -vn -f null -. Para verificar sincronía, dibuja un showwavespic de un tramo de escritura y compáralo con los fotogramas.

7. Informar

Dale al usuario:

  • la ruta a OUT/demo.mp4 y su duración
  • el gancho, la forma antigua y las líneas "solo nosotros", una línea cada una
  • cómo se igualó el look (qué colores, fuentes y mascota vinieron de la app)
  • cualquier cosa que no hayas podido hacer funcionar, o que se compuso en lugar de grabar (ej. el beat de lanzador)
  • cualquier error que hayas notado en su aplicación (ej. pulsaciones perdidas)

Menciona el comando npx remotion studio … que la herramienta imprime para ajustes en vivo, y --music <archivo> para una banda sonora.

Efectos de sonido

Activados por defecto; --no-sfx los desactiva. scripts/make-sfx.py sintetiza todo (sin muestras, sin licencias) en assets/sfx/, y remotion/Sfx.tsx temporiza cada sonido según los eventos grabados:

  • Escritura: un sonido de interruptor mecánico táctil por carácter (golpe de clic, fondo, liberación), a la velocidad real de escritura del grabador. Los espacios obtienen un sonido estabilizado más profundo, Enter uno más pesado.
  • Clics: un clic de ratón donde el cursor grabado hizo clic, incluido el clic de lanzador.
  • Transiciones: un whoosh en cada cambio de escena.
  • Forma antigua: un sonido de aterrizaje de tarjeta por paso (pop en soft, golpe sordo en bold) y un sonido de veredicto (pop suave en soft, sello en bold).
  • Beneficio: un timbre.
  • Comparación: un pop por fila, y un timbre (soft) o sello (bold) en el resultado de tiempo.

Con --music, la música se baja bajo los efectos. Cambia los volúmenes en Sfx.tsx y vuelve a ejecutar --from render. Vuelve a ejecutar el script después de editarlo para regenerar los WAV.

Apps nativas macOS

Mismo flujo, grabador diferente (mac/macdriver.swift: API de Accesibilidad para encontrar controles, eventos reales de ratón/teclado, ScreenCaptureKit graba solo la ventana de la app). Añade --app y pasa argumentos de lanzamiento después de --:

npx tsx src/cli.ts <repo o ./dir/local> --app ruta/a.app [--app-seed demo/items.json] --prepare -- --demo {data}
  • {data} se convierte en una carpeta desechable nueva por ejecución, y --app-seed se copia en ella. Nunca grabes contra los datos reales del usuario. Si la app no tiene un flag de lanzamiento demo/directorio-de-datos, añade uno (o pídele al usuario) antes de grabar. Reconstruye la app primero si el usuario tiene cambios sin commit.
  • Ejecuta mac/.build/macdriver check --open primero. Necesita permisos de Accesibilidad y Grabación de Pantalla y Audio del Sistema para la app que aloja la terminal. Si falta alguno, abre el panel de Configuración exacto y nombra la app a habilitar (código de salida 3). El usuario debe reiniciar esa app después de concederlo, lo que termina esta sesión, así que detente y dile que vuelva en lugar de reintentar. Sin Grabación de Pantalla, --prepare sigue funcionando pero la grabación no. Escribe el storyboard mientras tanto para que esté listo.
  • La grabación toma el control del ratón y teclado reales del usuario (~20–60s, cuenta atrás de 3s). Avisa al usuario justo antes de cada ejecución, incluidas pruebas cortas. No comiences mientras pueda estar escribiendo: su entrada roba el foco y arruina la toma.
  • Objetivos: id, luego placeholder, luego role+name. Sin goto. fill sin objetivo escribe en el campo enfocado. Usa press para Enter/Tab/Meta+N.
  • Los botones de icono sin etiqueta son invisibles para la automatización. Si un control clave no tiene nombre y tú tienes el código, añade .accessibilityLabel/.accessibilityIdentifier.
  • No consultes el árbol de Accesibilidad mientras se escriben teclas. En apps SwiftUI, una consulta AX puede desencadenar un re-renderizado que reinicia un campo de texto a texto obsoleto, perdiendo pulsaciones. El controlador solo lee el elemento enfocado después de escribir. Si cambias el controlador, mantén esa lógica. Si las pulsaciones aún desaparecen, la app probablemente tiene este error (un NSViewRepresentable text view cuyo updateNSView sobrescribe el string con un binding obsoleto). Informa al usuario.

Límites

Las páginas web detrás de un inicio de sesión necesitan que el flujo comience desde una página pública o una URL pre-autenticada. La grabación nativa es solo macOS y graba una sola ventana de la aplicación. Cualquier cosa fuera de ella (escritorio, barra de menús, otras apps) se compone en Remotion, no se graba, así que menciónalo en el informe.

Skills relacionados