Haz un video explicativo de 60 segundos
Convierte un tema en un video terminado de 1080 × 1920 con el pipeline de este repositorio. No cuesta nada: tú haces la investigación, la escritura y las reparaciones; los scripts verifican y renderizan. Trabaja desde la raíz del repositorio. Lee .claude/skills/make-explainer/rules.md antes de escribir un storyboard.
Reglas estrictas
- Cada número, fecha, nombre y cita que aparezca en pantalla proviene de un hecho en
facts.jsoncuya fuente realmente abriste con WebFetch. Nunca escribas una cifra de memoria. Si no puedes respaldar una afirmación, elimínala. La narración solo dice lo que una página que abriste indica; no añadas afirmaciones de fondo que no hayas leído. - Nunca edites
src/,tests/, los validadores ni este skill para que un storyboard pase la validación. Arregla el storyboard o los hechos. Nunca cambies los datos de un hecho para que coincidan con un storyboard, o viceversa, sin volver a leer la fuente. - DETENTE en la puerta de revisión (paso 6). No ejecutes
npm run producehasta que el usuario apruebe la hoja de revisión. - Finanzas e inversiones son educativas e históricas: sin consejos, sin predicciones, sin "deberías". Indica el período y la fuente de cada cifra.
Flujo de trabajo
Todo lo de un video vive en videos/<slug>/ (letras minúsculas, dígitos, guiones): facts.json, storyboard.json, review/.
- Brief. Acuerda el tema, una oración que el video demuestre, y la audiencia. Haz solo una pregunta si la afirmación no es clara. Voz por defecto
en-US-AndrewNeural, músicanull. - Investigación. WebSearch, luego WebFetch fuentes primarias (BLS, Reserva Federal, SEC, informes de empresas; Wikipedia o páginas de museos y bibliotecas para fechas históricas). Copia los números de la página. Escribe de 5 a 8 hechos:
id,claim(una oración completa con unidades y período, tal como lo dice la fuente),valuepara un número odatasetpara los datos exactos que mostrará un gráfico o lista, ysourcecon nombre y url. Nunca dejes redacción de "datos demo" en una afirmación. - Verificar.
npm run verify-facts -- --facts videos/<slug>/facts.json --out videos/<slug>/verify.json. Por cadanot-found,partialounreachable: vuelve a abrir la fuente, corrige o elimina el hecho. La herramienta es orientativa; tú eres responsable de la precisión. Un número entero pequeño (8, 9, 27) aparece en casi cualquier página, así quesupporteddice poco sobre él: lee tú mismo la línea de la fuente. Después de editarfacts.jsonpor cualquier motivo, ejecutaverify-factsnuevamente; la hoja de revisión marca un resultado desactualizado. - Guion y storyboard. Aproximadamente 155 palabras de narración en total (55 a 60 segundos), de 6 a 10 escenas, un gancho en la escena 1, una idea por escena, tipos de escena variados (nunca tres iguales consecutivos). Usa
storyboard.schema.jsonpara conocer los campos exactos y límites, y copia la forma defixtures/finance.storyboard.json,fixtures/history.storyboard.jsonyfixtures/ancient.storyboard.json. Escribevideos/<slug>/storyboard.json. - Revisar y reparar.
npm run check -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json. Corrige cada problema (cada mensaje nombra la escena y la solución) y vuelve a ejecutar, como máximo 6 rondas; si algo aún bloquea, informa exactamente qué. Trata las advertencias (longitud, redacción de consejos, texto no rastreado) como cosas que debes corregir o justificar. La estimación de longitud es buena dentro de aproximadamente el 10% (las palabras reales por segundo oscilaron entre 2.5 y 3.2), así que apunta a 55–60 s;producees la autoridad y una longitud rechazada solo significa ajustar la narración y volver a ejecutar. - Puerta de revisión.
npm run sheet -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --verify videos/<slug>/verify.json --out videos/<slug>/review. Dile al usuario que abravideos/<slug>/review/review.html. Resume: la afirmación, lista de escenas, recuento de palabras y duración estimada, cada hecho con su verificación de fuente, y cada advertencia. Pide aprobación o ediciones. DETENTE y espera. - Producir. Después de la aprobación:
npm run produce -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --out out/<slug>. Tarda unos dos minutos. Si rechaza la duración o una escena es demasiado corta, cambia la narración, vuelve a ejecutarcheck, produce de nuevo (el audio de voz se almacena en caché por texto). Informa la ruta del archivo, duración y volumen. Di claramente lo que no has juzgado: calidad de voz, pronunciación, ritmo y gusto. Pide al usuario que lo vea.
Cuando algo sale mal
- Un mensaje de verificación que no entiendes: nombra un id de escena; abre esa escena en
rules.mdpara conocer sus límites. No adivines la solución. - El hecho y la escena no coinciden: vuelve a abrir la fuente. Corrige el que esté mal según la fuente, nunca copiando uno sobre el otro.
- No se encuentra una región del mapa: usa la ortografía del atlas que sugiere el mensaje ("Estados Unidos de América"); las regiones deben superponerse al cuadro de
focus. - Problemas de voz (red):
npm run producenecesita internet para Edge TTS;--voice standinproporciona un audio de marcador de posición casi silencioso solo para una ejecución de prueba. - Configuración faltante: ejecuta
npm installynpm run setup:ttsuna vez.
Salida para el usuario
Mantén la brevedad: la ruta del archivo, lo que afirma el video, duración, volumen, los hechos y fuentes utilizados, y cualquier advertencia que hayas aceptado y por qué.