Video de capacitación: primero el storyboard, luego la app real en pantalla
Un video de capacitación aquí es un conjunto de tarjetas con forma de teléfono. Cada tarjeta tiene un título, una línea de ayuda, un fotograma clave de la app real con anotaciones y una línea de narración. Algunas tarjetas reproducen un clip corto de la app en lugar de una imagen fija. Las mismas tarjetas se entregan como diapositivas y un PDF.
Un archivo lo controla todo: storyboard.json. Dave lo edita a través de un lienzo de diseño; cada script de compilación lo lee.
Cuándo usarlo
Úsalo para:
- Un video de capacitación, guía de inicio rápido o tutorial que muestre la app
- Capturas de pantalla anotadas o una guía de diapositivas para técnicos, asesores o personal de refacciones
- Una revisión de un video creado con este skill (nuevo redactado, nueva tarjeta, nuevo clip)
No lo uses para:
- Video de marketing o promocional (tono diferente, reglas diferentes; pregúntale a Dave)
- Videos de inspección de clientes grabados dentro del producto
- Un mockup de una pantalla que aún no existe (usa
/visual)
Principios
- Storyboard antes de la producción. Nada se narra ni ensambla hasta que Dave haya editado el lienzo del storyboard y haya dicho que terminó.
- Muestra la app real, haciendo lo real. Escaneo real, dictado real, historia real generada. Nunca una pantalla simulada, nunca resultados escritos a mano.
- Dave manda en el lienzo, no en el chat. Lee el lienzo de nuevo y haz un diff. No reconstruyas su dirección a partir de la conversación.
- Una toma aprobada se conserva. La narración se regenera solo para líneas cuyas palabras cambiaron. Nunca sobrescribas una versión que Dave haya revisado; envía
-v2,-v3. - Claude no puede oír ni ver. Dilo en cada devolución. Prueba las palabras mediante transcripción y las imágenes mediante fotogramas de muestra, y nombra lo que no se verificó.
- Deja la tienda como se encontró. Modo restaurado y confirmado, órdenes de reparación de retoma cerradas.
Leer primero
/Users/davidsonders/ro-bot/shared/product-facts.mdyshared/brand.md: nombres, conteos, palabras prohibidas. Sin guiones largos, sin emojis, "TenthGear" como una sola palabra. Nunca digas "single player" o "multi-player" en nada que el espectador vea u oiga.reference.mden esta carpeta: las trampas técnicas, cada una ya pagada una vez.- Notas de memoria sobre el lienzo de diseño:
reference_design_canvas_mechanics,reference_design_canvas_roundtrip,reference_design_canvas_entity_crash.
Dónde viven las cosas
| Qué | Dónde |
|---|---|
| Carpeta del proyecto de un video | /Users/davidsonders/ro-bot/training-videos/<slug>/ (nunca el scratchpad de la sesión, que muere con la sesión) |
| La única fuente de verdad | <project>/storyboard.json |
| Fotogramas clave, clips, narración | <project>/frames/, footage/, narration/ |
| Compilaciones | <project>/out/ |
| Lo que recibe Dave | ~/Desktop/<Title>/ |
| Ejemplo trabajado | training-videos/story-writer-getting-started/ y examples/story-writer/ aquí |
Los scripts están en scripts/ aquí. Toman la carpeta del proyecto como su primer argumento.
Flujo de trabajo
Crea una lista de tareas para estos pasos y trabaja en ellos en orden.
Paso 0: Definir el encargo
Encuentra estos elementos en la solicitud. Pregunta solo lo que falte, una pregunta, recomendación primero.
| Decidir | Por defecto |
|---|---|
| Quién ve, y en qué rol | Técnico |
| Teléfono o escritorio | Teléfono, 390 x 844 |
| Qué flujo, de principio a fin | El esquema de Dave |
| Tienda y modo de trabajo | Pregúntale a Dave. Ver Paso 2. |
| Solo imágenes fijas, o imágenes fijas más clips | Clips donde la pantalla se mueve: grabación, carga, abrir y cerrar |
| Duración | Menos de 2:30 |
Paso 1: Storyboard en un lienzo de diseño
Esto es lo primero que ve Dave y el lugar donde edita el guion y las anotaciones.
-
Crea la carpeta del proyecto y renderiza cualquier accesorio (
props/render-paper.mjshace la muestra de orden de reparación en papel). -
Explora el flujo en busca de fotogramas clave. Los fotogramas clave provienen de la app real, por lo que este paso necesita una ejecución de captura (Paso 2 y Paso 3, solo imágenes fijas). Copia
examples/story-writer/capture-stills.mjsen el proyecto y reescribe el flujo. Mira cada fotograma antes de continuar. -
Redacta
storyboard.json. Una tarjeta por cada cosa que hace el espectador. Forma:{ "id": "write-story", "part": 2, "img": "10-write-story", "title": "Toca [[Write Story]]", "body": "El escritor de IA revisará tus notas y escribirá las 3Cs por ti.", "boxes": [[183, 400, 191, 44]], "arrow": [162, 768], "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "Lo que muestra el clip" }, "narration": "Cuando estés listo, toca Write Story." }boxesyarrowestán en píxeles del teléfono; la captura escribe el cuadro de cada control junto a su fotograma.[[Label]]dibuja un chip de botón. Sigue las reglas de estilo a continuación desde el primer borrador. -
Crea el lienzo. Herramienta de artefacto:
quickstartcon intencióndesign, luego publica con eltype_urlque devuelve y un título. Guarda la url en<project>/storyboard/artifact.json. -
Sube los fotogramas clave al lienzo como activos (JPEG, 1688 px de alto, preparados en el scratchpad para que vayan en una sola llamada). Registra cada url
/_blob/...devuelta bajoassetsenartifact.json, con clave por nombre de fotograma. -
Genera y publica.
node scripts/storyboard-canvas.mjs <project>escribestoryboard/project/. Copia esa carpeta en el scratchpad y publícala:canvas.jsoncomofile_path, cada.dc.htmlenfiles. -
Entrega el enlace a Dave y detente. Dile: vuelve a escribir cualquier palabra en una tarjeta, la nota azul debajo de cada tarjeta es la pista de voz, arrastra las anotaciones amarillas, escribe cualquier otra cosa en una nota. No comiences la producción.
-
Recoge sus ediciones. Artefacto
readconpaths(el índice y cada mesa de trabajo) y unout_dir, luegonode scripts/storyboard-harvest.mjs <project> <out_dir>. Lee el informe en palabras simples, actúa sobre cualquier nota que haya agregado y luego vuelve a ejecutar con--write. -
¿Otra ronda? Lee
project/canvas.jsonde nuevo, regenera con--live <ese archivo>, vuelve a publicar. Una publicación que no comience desde el índice en vivo será rechazada.
Paso 2: Tomar prestada una tienda
La app debe estar en el modo que muestra el video. Solo se pueden usar tiendas de prueba.
| Tienda | Id | Modo normal | Notas |
|---|---|---|---|
| Summit Auto Group (demo) | demo-dealership | flujo de equipo | Demo de prospecto de Dave. Inicios de sesión [email protected] (técnico), marcus@ (asesor), priya@ (refacciones). Usada para el primer video. |
| Test Dealership 1 | mlTaPo12wbpUtJB9GXJM | flujo de equipo | Compartida con sesiones de compilación. A menudo ocupada. |
ListAgents, luegoSendMessagea cada par: ¿está usando la tienda, y necesita el modo? Espera la respuesta. Si un par lo necesita, usa la otra tienda o pregúntale a Dave.- Lee el modo primero:
NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id>desde la carpeta de la app. - Cámbialo solo durante los minutos que dure una captura, en la misma cadena de comandos que la captura y la restauración. Luego léelo de nuevo y confirma.
- Nunca toques una tienda de cliente. Nunca cambies las preferencias de una cuenta de prueba.
Paso 3: Capturar
- Imágenes fijas:
dpr: 3. Un fotograma por tarjeta, tomado después de que la pantalla se haya estabilizado. - Clips:
dpr: 2convt.recorder. Abre cada clip con un momento de quietud, muestra el marcador de dedo, luego actúa. Leemarks.jsonpara elegirfootage.runs. - El dictado es real.
vt.dictationreproduce un clip de voz en un micrófono falso; la app lo graba y transcribe. Imprime cada transcripción y léela: el transcriptor reescribe números y nombres de marca. - Una retoma necesita una orden de reparación nueva. Numéralas hacia arriba y enumera cada id en
created-ros.txt.
Paso 4: Diapositivas
node scripts/build-slides.mjs <project> escribe out/slides/*.png, el PDF y las capas que necesita el video. Mira una hoja de contactos de cada tarjeta. Verifica que ninguna anotación cubra lo que señala.
Paso 5: Narración
cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>
Voz ash, modelo gpt-audio-1.5 (migrado de gpt-4o-mini-tts, que OpenAI apagará el 2027-01-06). Una toma cuyo transcript no coincida con las palabras de la tarjeta se reintenta, luego se rechaza. Dave aprobó esta voz y rechazó las voces integradas del Mac por robóticas. Usa la clave de OpenAI de la app y cuesta unos centavos por compilación: dilo en el resumen de cada nuevo video, para que el gasto nunca sea una sorpresa. DRY=1 lista lo que se regeneraría.
Escribe la narración para el oído: "R O", "tres Cs", "tenthgear punto A I". Anuncia cada parte en su primera tarjeta.
Paso 6: Video
node scripts/build-video.mjs <project>. La velocidad es 1.25 ("Fast" de QuickTime), el ritmo que Dave aprobó. Una tarjeta con un clip dura tanto como lo que dure lo más largo entre su narración y su clip.
Paso 7: Verificar, y decir lo que no se verificó
check-audio.mjstranscribe el video y puntúa cada tarjeta. Lee cada líneaLOOK.- Extrae un fotograma de cada tarjeta que tenga un clip o una flecha y míralo.
- En la devolución, declara claramente: no se escuchó, no se vio de principio a fin.
Paso 8: Entregar
Copia el video, el PDF y out/slides/ a ~/Desktop/<Title>/. Mantén las versiones anteriores. Indica la duración, qué cambió y cualquier cosa que Dave pueda notar (un número de orden de reparación diferente en un clip, una anotación caída sobre el metraje).
Paso 9: Limpiar
- Modo de tienda restaurado, luego leído de nuevo y confirmado.
node scripts/close-ros.mjs <project> <email> <org-id>cierra las retomas. Eliminar órdenes de reparación es decisión de Dave.- Dile a cualquier par al que hayas enviado un mensaje que la tienda está libre.
Reglas de estilo (Dave, 2026-09-29)
| Regla | Ejemplo |
|---|---|
| Un botón que el espectador toca se dibuja como un botón | Toca [[New RO]] |
| Los encabezados de parte son cortos, sin "de 3" | PARTE 2: HISTORIA DE GARANTÍA |
| La portada no tiene número de paso | |
| Una tarjeta por paso. Combina tarjetas que muestren una sola decisión. | Revisar y guardar son una tarjeta |
| Descarta una tarjeta cuyo punto sea evidente | Leer Causa y Corrección |
| Di quién actúa y con qué | "Agrega una nota de voz", no "Agrega una nota" |
| Cuando dos cosas en pantalla podrían estar implicadas, señala una | Flecha en el botón verde |
| Cualquier cosa que se mueva en la app debe moverse en el video | Forma de onda, spinner, tarjeta abriéndose |
| Palabras de taller | RO, línea, historia, 3Cs, CP |
Dave da ediciones de diapositivas por número de página PDF. La página 1 es la portada, por lo que "pg 7" es el paso 6. Reformula cada edición por nombre de paso antes de aplicarla.
Criterios de éxito
- Dave editó el lienzo del storyboard y sus ediciones se recogieron, no se adivinaron
- Cada fotograma y clip es la app real, en el modo del que trata el video
- Las diapositivas, el PDF y el video provienen del mismo
storyboard.json - Narración verificada por transcripción; líneas poco claras nombradas
- La devolución dice lo que no se escuchó o vio
- Modo de tienda restaurado y confirmado; órdenes de reparación de retoma cerradas
- Carpeta del proyecto mantenida fuera del scratchpad
Skills relacionados
/visualpara mockups de pantallas que aún no existen/app-testingpara las cuentas de prueba y el arnés de pase en vivo que esto toma prestado/compounddespués, si una captura expuso un error del producto o una nueva trampa