Communitygithub.com

tutorial-video-shorts

Produce videos educativos: clases verticales (1080x1920) con un personaje ilustrado frente a una pizarra (`clase.py`), tutoriales de pantalla grabada (un agente de IA o código en VS Code) y explicadores de cualquier tema con escenas animadas. Narración TTS intercambiable o voz grabada propia, música, efectos, transiciones y revisión automática; publica en YouTube o Google Drive. Trigger: "armá una clase con personaje", "video vertical con pizarra", "grabá un tutorial", "narrá con voz", "video explicando X", "cambiá la voz de los videos", "subí los videos a YouTube/Drive".

Qu'est-ce que tutorial-video-shorts ?

tutorial-video-shorts is a Claude Code agent skill that produce videos educativos: clases verticales (1080x1920) con un personaje ilustrado frente a una pizarra (`clase.py`), tutoriales de pantalla grabada (un agente de IA o código en VS Code) y explicadores de cualquier tema con escenas animadas. Narración TTS intercambiable o voz grabada propia, música, efectos, transiciones y revisión automática; publica en YouTube o Google Drive. Trigger: "armá una clase con personaje", "video vertical con pizarra", "grabá un tutorial", "narrá con voz", "video explicando X", "cambiá la voz de los videos", "subí los videos a YouTube/Drive".

Compatible avec✓Claude Code~Codex CLI✓Cursor✓OpenCode
npx skills add https://github.com/JuaniSarmiento/tutorial-video-shorts/tree/main

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait tutorial-video-shorts ?

Produce series de video-tutoriales sin editor de video: graba la pantalla o controla un agente, corta por segmentos, narra con TTS (o voz propia), y entrega .mp4 con subtítulos. La idea que la hace distinta está en el README: la imagen se mide con la voz, no al revés — ver README.md.

Este archivo es un router: lee lo de abajo para decidir el flujo y después abrí sólo el references/*.md de la tabla que corresponda a lo que vas a hacer. No leas el resto por las dudas — cada referencia está pensada para leerse sola.

Cuándo se usa

  • Grabar a un agente (opencode + Active Stack, u otro) resolviendo algo de punta a punta.
  • Convertir grabaciones largas (horas) en videos cortos (≤5 min) con voz de profe.
  • Cambiar la voz de videos ya editados sin regrabar.
  • Publicar la serie en YouTube (playlist) o en una carpeta pública de Drive.
  • Explicar un tema que no es de pantalla (finanzas, biología, historia) con escenas animadas: ver Escenas.
  • Una clase vertical corta con un personaje ilustrado frente a una pizarra, sólo desde un guion JSON (clase.py, ver references/clase.md).

Los flujos

FlujoEn pocas palabrasPor dónde empezar
1. Tutorial de pantalla grabadaentorno.sh/rec.py graban; se escribe el guion mirando frames (no marcas); editar.py imagen + editar.py voz arman el entregablereferences/grabacion.md → references/guion-y-edicion.md
2. Explicador con escenasSin crudo: segmentos "escena" (presentacion, diagrama, datos, imagen, codigo, contador) que se renderizan desde plantillas HTML y entran en la palabra que los nombrareferences/escenas.md
3. Cambiar la voz / publicarMismo guion, otra voz en editar.py imagen VOZ + editar.py voz VOZ (re-arma porque los tiempos cambian); publicar es un paso aparte, con OK explícitoreferences/voces.md → references/publicacion.md

Cualquier flujo puede llevar música, efectos, transiciones y la revisión del Director: son transversales, no un flujo propio (ver la tabla de abajo).

Flujo (en orden)

FaseQué se haceScripts
0. Prepararagente instalado y logueado, carpeta del proyecto con git init, terminal opaca y con letra grande. Bajo Wayland: entorno.sh start primeroentorno.sh
1. Grabarun .mkv por fase/capítulo + marcas de tiemporec.sh
2. Manejar el agentetipear prompts, aprobar permisos seguros, responder preguntasty.py, drive.sh, cmd.sh, answer.sh, lastq.py, oclog.py
3. Guionguion/vNN.json: segmentos {inicio, fin, texto} + tarjeta de títulover assets/guion-ejemplo/
4. Editareditar.py imagen vNN VOZ → editar.py voz vNN VOZeditar.py
5. VerificarWhisper sobre cada tramo (repeticiones) + silencedetectverificar_voz.py
6. Publicarcomprimir <10 MB, subir con Claude in Chrome, playlist/carpeta públicaver Publicación

Reglas duras (valen siempre, en cualquier flujo)

  • Privacidad: lo que se filma no se puede despublicar. Un barrido con tesseract (OCR, no a ojo) sobre el video TERMINADO, y de vuelta sobre el video YA censurado. Ninguna ruta personal en pantalla (home, usuario, ids de cuenta reales): ver references/verificacion.md.
  • El código y las salidas son reales. Nunca tipeado a mano en un spec de escena ni en una diapositiva: se lee de archivos reales y se ejecuta de verdad (references/escenas.md).
  • La voz manda el ritmo. La imagen se estira o se acelera a la duración de la voz, nunca al revés — por eso cambiar de voz re-arma el video entero (references/voces.md).
  • editar.py revisar antes de entregar. Mide tiempo muerto, silencios, roles y contraste; sólo lee, nunca modifica nada (references/director.md).
  • Nunca voces de famosos ni clones de personas reales sin consentimiento, aunque sea "en joda".
  • API keys en ~/.config/<proveedor>/api_key con chmod 600; nunca en guiones ni scripts. Si se pegan en un chat, rotarlas.
  • Publicar (YouTube/Drive público) requiere OK explícito del usuario; avisar si el contenido resuelve una tarea evaluable antes de su cierre (references/publicacion.md).
  • Nunca pgrep -f/pkill -f <patrón> en un loop de espera dentro de un script que contiene ese patrón: compara contra la cmdline completa y el proceso se mata o se confunde a sí mismo. Esperar por ausencia de proceso, no por un pid (references/grabacion.md, references/guion-y-edicion.md → "Un render por vez").

Tabla de ruteo

Si vas a...Leé
Grabar bajo Wayland (Xephyr), manejar una app Electron por CDP, tipear en VS Code o una terminal, portar a Windows, o grabar una app web real con grabar_web.py (cursor dibujado, diálogos nativos, CodeMirror)references/grabacion.md
Escribir o editar el guion, usar editar.py imagen/voz/zonas, slots, velocidad de voz, zoom, o elegir el encoder de videoreferences/guion-y-edicion.md
Armar o tocar una escena animada (presentacion, diagrama, datos, imagen, codigo, contador), cues, o la plantilla HTMLreferences/escenas.md
Música de fondo, voiceover carve, perfiles de loudness, o efectos de sonido (sfx)references/audio.md
Elegir, agregar, o calibrar la velocidad de una voz TTSreferences/voces.md
Agregar o tocar una transición entre tramos (corte, fundido, barrido)references/transiciones.md
Escribir un guion de explicador (brief, estructura narrativa, gancho, qué escena usar), escribirlo como lo haría quien edita de profesión, o entender qué mide editar.py revisar (D1-D8)references/director.md
Correr la puerta de escenas (verificar.py), editar.py revisar, censurar con OCR, o verificar la voz con Whisperreferences/verificacion.md
Publicar en YouTube o en una carpeta de Drivereferences/publicacion.md
Armar una clase vertical con personaje (1080×1920): un personaje frente a una pizarra, boca con la voz, poses, cámara, diagrama de flujo, código real y terminal, con Remotion y una biblioteca de personajes/vestuarios/fondos que genera lo que falta (clase.py)references/clase.md
Revisar (sin renderizar) un episodio de un canal de Shorts verticales que NO usa esta skill para armar el video (revisar_short.py: D1/D2/D8 adaptados, formato vertical, escena.forma)references/shorts.md

Resources

Skills associés