Video explicativo corto (9:16, ~60-90 s, voz en tailandés, cualquier tema)
Manual para un video explicativo vertical: noticias, reseña de una herramienta o repositorio, un concepto, un tutorial o una demostración de algo que el propietario haya creado. La mecánica de construcción y el traspaso de estilos residen en la habilidad create-video; cárgala antes del paso 4. Motores de voz y sus peculiaridades: references/voice-options.md.
Requiere: bun, ffmpeg/ffprobe, python3, y para measure_ink.py Pillow + numpy (uv run --with pillow --with numpy ...). El pulido de la prosa tailandesa usa las habilidades kien-thai y kode-thai (npx skills add chakrit/kien-thai).
Valores predeterminados (no es necesario volver a preguntar)
- 9:16, 1080x1920, 8-10 compases, aproximadamente 60 s (Shorts permite hasta 3 min; un guion leído por uno mismo suele durar entre 80 y 90 s)
- Estilo: el último estilo Atlas que el propietario aprobó. Kits en la plantilla: Bolígrafo (
src/style/ballpoint.js, window.BP) y Pizarra (src/style/whiteboard.js, window.WB). Un estilo nuevo necesita el prompt de Futurepedia AI Style Atlas pegado. - Visuales dibujados en código. Solo logotipos reales para el tema y como créditos de fuente. Sin fotos de noticias. Excepción: cuando el tema es una demostración web en vivo, mezcla capturas de pantalla reales del navegador que tomes tú mismo para los compases de "verlo funcionar" con compases dibujados para el mecanismo.
- Voz: el propietario la graba él mismo. Entregar
read-script.md, él deja una grabación,scripts/split_recording.pyoscripts/assemble_takes.pyla divide en compases. Voces sintéticas solo si él lo solicita (references/voice-options.md). - Sin emojis, sin claves de API, citar fuentes.
Elegir primero la forma de la historia
Formas y plantillas de compases: templates/story-shapes.md.
| Forma | Uso | Revisión en vivo |
|---|---|---|
| Noticia | Algo sucedió, puede que siga sucediendo | Sí, antes de renderizar |
| Reseña / demo de herramienta | Un repositorio, app o producto: qué hace y el inconveniente | Pruébalo tú mismo |
| Concepto | Cómo funciona algo | No |
| Tutorial | Pasos para hacer algo | No, pero prueba los pasos |
Pasos y puntos de aprobación
- Selección del tema. Preferir historias con un mecanismo que dibujar por encima de noticias de quién hizo qué; omitir escándalos/chismes y demandas recientes sin nada que explicar aún. Dar 3-4 opciones clasificadas con el motivo, y decir que provienen de titulares aún no verificados. Comprobar
dateprimero.- Actualidad: un clip de noticias que no pueda enviarse en ~1-2 días del evento está desactualizado; decirlo antes de invertir tiempo. Ofrecer en su lugar: esperar el informe de seguimiento principal (ej. un informe posterior al incidente), o reformularlo como un clip de Concepto atemporal usando el incidente como ejemplo.
- Investigación. Leer la fuente principal (repositorio, documentación, página de estado, publicación oficial) además de otros medios. Mantener tres etiquetas separadas: verificado por mí / afirmado por la fuente / mi interpretación.
- Problemas/instrucciones de entrega: verificar cada afirmación de "estado actual" contra el estado en vivo (¿está fusionado el PR?, ¿está la URL activa?, ¿está el archivo donde dice?). Leer archivos de GitHub (
gh api repos/O/R/contents/PATH -H 'Accept: application/vnd.github.raw') en lugar de clonar o revisar el repositorio local del propietario. - Demostraciones: ejecutar el producto real en un navegador, reproducir cualquier número indicado y medir los tamaños de los assets (
curl -sIL ... content-length) en lugar de confiar en estimaciones codificadas en la fuente. Reportar discrepancias en una tabla de afirmación/real. - Afirmaciones de "sin servidor" / privacidad: listar las solicitudes de red de la página (
performance.getEntriesByType('resource')). Las balizas de análisis de alojamiento (ej. Cloudflare/cdn-cgi/rum) aparecen en una captura de DevTools; filtrar para obtenerlas o explicarlas en pantalla.
- Problemas/instrucciones de entrega: verificar cada afirmación de "estado actual" contra el estado en vivo (¿está fusionado el PR?, ¿está la URL activa?, ¿está el archivo donde dice?). Leer archivos de GitHub (
- Guion a partir de la plantilla de la forma, números en palabras, duración ajustada recortando palabras, nunca acelerando. Escribir
read-script.md(compases numerados, un respiro cada uno).- Noticia = pirámide invertida: el compás 1 es un encabezado completo (quién, hizo qué, cuándo) que se sostiene por sí solo; luego de lo más a lo menos importante; atribuir cada afirmación ("X ระบุว่า", "ด้าน ... เชื่อว่า"); sin opinión ni moraleja en la voz, los aprendizajes van en el pie de foto.
- Los créditos y URL que requiera el resumen van en el último compás y en pantalla.
- Pulir con
kien-thaimediante el buclekode-thai: auditar, citar reglas, corregir, releer, repetir hasta que una pasada no encuentre nada. Los explicativos hablados por el propietario = registro de blog personal, masculino: ผม, ครับ solo al despedirse, คุณ para el espectador, เรา para el equipo. Correcciones recurrentes en borradores del modelo: เรา oscilando entre el creador y el espectador (deixis-continuity), ทิ้ง para "soltar" (verb-calque), "ไม่ใช่ X เป็น Y" sin ต่างหาก (f4/targhak-closure), mezcla เมกะ/เมกะไบต์ (una forma por término), repetición de ก็เลย/พอ en compases adyacentes.
- Voz -> PUNTO DE CONTROL 1 (el propietario escucha). Instrucciones de grabación (QuickTime > Archivo > Nueva grabación de audio, Calidad Máxima, no AirPods; o Notas de voz del iPhone + AirDrop): pausa ~2 s entre compases, claramente más larga que un respiro (los silencios auto-grabados salieron de 0.6-0.9 s, igual que los respiros entre frases, por lo que ningún umbral los dividió exactamente en N); releer un compás con error inmediatamente; leer los nombres en inglés de forma natural. Ofrecer verificar primero una prueba de 10 s del compás 1.
- Encontrar la grabación: puede dejar varios archivos (tomas) en una subcarpeta y decir solo "listo". Buscar recursivamente en la carpeta del proyecto más
find ~ -mmin -30 -iname '*.m4a', luego por archivo reportar duración,volumedetectmedia/máxima y mapa de silencios antes de cortar. Poner rutas entre comillas en los bucles (los nombres de Notas de voz contienen espacios). - Un archivo:
python3 split_recording.py <archivo>; se detiene a menos que encuentre exactamente N compases. Si ningún umbral da el recuento correcto, no forzar un corte: preguntar por los tiempos de inicio aproximados de cada compás y ajustar cada corte al silencio más cercano. - Varios archivos / retomas: preguntar qué archivo corresponde a qué compás, luego
assemble_takes.pycon untakes.jsonde {archivo, inicio, fin} por compás. Dividir un archivo de múltiples compases en sus silencios más largos y verificar cada corte con la tasa de habla de los archivos de un solo compás (~11 caracteres tailandeses/s); marcar compases cuyo tiempo de voz sea >20% más corto (posibles palabras omitidas). Iguala el nivel de cada compás (beat_lufs), acorta las pausas entre frases amax_pauserecortando el medio de cada pausa (ffmpegsilenceremoveapenas hace esto), luego comprime antes de loudnorm (cresta de habla ~22 dB; termina cerca de -18 LUFS con TP -1.5).
- Encontrar la grabación: puede dejar varios archivos (tomas) en una subcarpeta y decir solo "listo". Buscar recursivamente en la carpeta del proyecto más
- Storyboard -> PUNTO DE CONTROL 2 (el propietario aprueba). Fotogramas fijos al tiempo de finalización de cada compás como una hoja de contactos más PNG a resolución completa. Listar cualquier suposición o elemento ilustrativo.
- Medir el encuadre a partir de píxeles, nunca a ojo (una vez, el cálculo visual falló por un desplazamiento uniforme a la derecha).
scripts/measure_ink.py --z .. --camx .. --camdy .. fotogramas...ajusta la tinta de cada compás dentro de la caja segura de TikTok/Reels x 140-940, y 230-1500 (de lo contrario, el contenido se derrama bajo la interfaz de la app) e imprime CAMXS/CAMDY/ZS corregidos; una pasada de remedición deja un margen >= 8 px. Entregar unstoryboard-sheet-safezone.pngcon las bandas no seguras teñidas (ffmpegdrawbox). - Tomar cada fotograma justo después de la ÚLTIMA marca de ese compás (su final IO), no al inicio del siguiente compás menos una constante: un compás que termina temprano ya se está desplazando y las medidas salen muy desviadas.
- Mostrar errores de OCR / reconocimiento de texto: las caras tailandesas sin bucle (Sriracha, Mali, la mayoría de las fuentes de interfaz) dibujan น como u latina y บ/ป como U, por lo que una lectura incorrecta como
QนotationSE VE correcta en pantalla y en las verificaciones visuales. Verificar cadenas mediante texto JS, no capturas de pantalla; dibujar las lecturas incorrectas en Itim (con bucle, OFL, incluida en la plantilla) y rodear el glifo invertido usando measureText.WB.mTexttoma un color hexadecimal: pasarB.hexOf(RED), no el array RGB.
- Medir el encuadre a partir de píxeles, nunca a ojo (una vez, el cálculo visual falló por un desplazamiento uniforme a la derecha).
- Renderizar y verificar.
bun run render <slug>. Fotogramas == duración x 30; LUFS de la voz en el mp4 == archivo de voz (narración multiplexada); música ~20+ dB por debajo de la voz; fotogramas fijos de mitad del dibujo (no finales de compás) para comprobar que el lápiz está sobre la tinta y que nada sale de la caja segura. Para Noticias, releer la fuente principal primero y actualizar la marca de tiempo en pantalla. - Entregar en
~/Downloads/<slug>-video/: mp4 completo,-small.mp4(CRF 24), wav de música, subtítulos detemplates/captions.md. Dar rutas absolutas. - Publicación. Nunca publicar públicamente por el propietario. Si se sube por él, configurar como Privado y marcar el recuadro de YouTube "Contenido alterado o sintético" solo cuando la voz sea sintética; él presiona Publicar. De lo contrario, dar un kit de copiar y pegar: ruta del archivo, título, descripción, ajustes a marcar.
Andamio
scripts/new_short.sh <slug> [--out dir] [--from plantilla] [--kits dir] [--no-install] copia la template/ incluida (Itim + fuentes tailandesas, cámara de caja segura, scripts de renderizado/fotogramas, videos de referencia) a ~/Videos/shorts/<slug>/ (o $SHORT_VIDEOS_DIR), conserva videos anteriores como _reference_* para adaptarlos, y copia las herramientas de voz en <slug>/voice/. Las dependencias se instalan automáticamente (--no-install las omite). Pasar --from <un proyecto finalizado> para comenzar desde tu último clip aprobado.
El material de Futurepedia Style Atlas (biblioteca H, kit SOUND, prompts y los kits Bolígrafo/Pizarra adaptados de su código de referencia) NO está en esta habilidad — pertenece a Futurepedia. new_short.sh lo copia desde $CODE_MOTION_KITS (por defecto ~/Videos/shorts/_kits/{src/lib,src/style,prompts}). Sin él: guardar el prompt de Atlas en proj/prompts/, bun run extract-kit prompts/<estilo>.md, luego adaptar el estilo (create-video). Nunca hacer commit de esos archivos.