Communitygithub.com

Tela Viva: Reel tutorial animado

Estilo Tela Viva. Crea Reels animados 9:16 con estilo "tutorial en pantalla" (ventanas genéricas en uso, pasos numerados, leyenda palabra por palabra) con el color y el @ de la persona. Úsalo cuando pidan "Tela Viva" o un Reel/video corto tutorial que muestre pantallas y apps en uso.

¿Qué es Tela Viva: Reel tutorial animado?

Tela Viva es una habilidad técnica instalada en asistentes de IA que genera Reels verticales animados (1080×1920, 30 fps, MP4) con un estilo de "tutorial en pantalla". Está diseñada para Cursor, Claude Code y otras plataformas que permitan ejecutar scripts de Python y ffmpeg. La habilidad convierte un tema proporcionado por el usuario en un video de 30 a 60 segundos compuesto por escenas numeradas, ventanas genéricas animadas (asistente de IA, planilla, lista de tareas, chat), narración palabra por palabra con color de marca, y un cartel final "Sígueme". El proceso es totalmente programático: no utiliza generadores de video por IA, solo código Python y ffmpeg, lo que permite generar un reel de 40 segundos en menos de un minuto. Incluye generación automática de audio de tipeo y música de fondo libre de derechos, así como soporte para sincronización precisa con voz grabada. Es especialmente útil para creadores de contenido que necesitan Reels educativos o tutoriales rápidos y consistentes, manteniendo la identidad visual de la marca.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adnytamires/skills-reels-video/tree/HEAD/reel-tela-viva

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Tela Viva: Reel tutorial animado?

Kit de 3 estilos: si la persona pide un Reel sin decir el estilo y también tiene las habilidades Modo 8-Bit (pixel art) y Hora Dourada (monigotes planos para historias y tutoriales), pregunta primero cuál de los tres estilos quiere.

Esta habilidad transforma un tema en un Reel vertical (1080×1920, 30 fps, MP4) con el estilo tutorial en pantalla:

  • en la parte superior, una barra de progreso y el número del paso junto a un título corto;
  • en el centro, ventanas genéricas y sin marca que "funcionan" (texto siendo escrito, respuesta que aparece, resaltador, franja sobre datos confidenciales);
  • abajo, una leyenda palabra por palabra: la palabra hablada aparece en el color de la marca;
  • al final, una tarjeta "Sígueme".

El video se monta mediante código (Python + ffmpeg). No utiliza generador de video por IA. Un Reel de 40 s se genera en menos de 1 minuto.

Responde siempre en el idioma de la persona (normalmente portugués).

Paso 1. Entender la solicitud (una sola pregunta, con todo lo que falte)

Pregunta de una sola vez lo que la persona aún no haya dicho:

  1. Tema: ¿qué aprenderá o probará quien lo vea? Si ya trajo el texto de la narración, usa su texto.
  2. Marca: color principal en hex (ej.: #7C3AED) y el @ del perfil. Sin respuesta, usa morado #7C3AED y @seuperfil, y avisa.

Si la persona dice "hazlo a tu manera", no preguntes: sigue con los valores por defecto y di cuáles usaste.

Paso 2. Escribir el guion

Crea un archivo roteiro.json (formato abajo; modelo listo en exemplos/roteiro-exemplo.json).

Estructura que funciona (de 5 a 8 escenas, de 30 a 60 s):

  1. Gancho (sello !): una situación que la persona reconoce, en hasta 10 palabras en la narración.
  2. Pasos numerados (sellos 1, 2, 3...): una acción por escena, con la ventana mostrando la acción.
  3. Cuidado (puede ser uno de los pasos): verificar el resultado y no pegar datos confidenciales.
  4. Llamada (sello ✓): por ejemplo, "Prompt en la leyenda" con un post-it (nota).
  5. Final ("tipo": "final"): "Sígueme para más…".

Reglas de contenido:

  • Títulos de hasta 6 palabras. Destaca 1 o 2 palabras con *asteriscos*.
  • Narración: aproximadamente 2,3 palabras por segundo. La duración de cada escena se obtiene de la narración.
  • Usa datos, nombres y empresas ficticios ("Persona A", "Proveedor") y marca "exemplo": true en las escenas con datos.
  • No pongas nombres, logotipos ni pantallas de herramientas reales. Las ventanas son genéricas ("asistente de IA", "planilla", "bandeja de entrada").
  • No inventes funcionalidades, fórmulas, números ni resultados. Si el guion cita una característica de una herramienta, verifica en una fuente oficial (busca en la web, si puedes) y dile a la persona qué verificaste. Si no puedes verificarlo, avisa.
  • Sin promesas exageradas ("ahorra 10 horas", "nunca más").

Paso 3. Cuadros de prueba antes del video

Ejecuta la vista previa con un tiempo del medio de cada escena (los tiempos aparecen al inicio de la salida):

python3 <carpeta-de-la-habilidad>/scripts/reel.py roteiro.json --out saida --preview 3,10,18,25,32

Abre saida/previa_grade.jpg y verifica:

  • ningún texto sale de la ventana;
  • ningún título tiene más de 2 líneas;
  • resaltados y franjas están en los lugares correctos.

Ajusta el JSON y repite si es necesario. Luego muéstrale a la persona la cuadrícula y el guion en una tabla (escena, lo que aparece, narración, tiempo) y pregúntale si puede generar el video.

Paso 4. Generar el video

python3 <carpeta-de-la-habilidad>/scripts/reel.py roteiro.json --out saida --nome mi-reel

El comando genera:

  • saida/meu-reel-sem-voz.mp4, con una pista tranquila y sonidos de tipeo creados por el propio script (sin música de terceros);
  • saida/guia-narracao.txt, solo con el texto hablado, un párrafo por escena;
  • saida/tempos.txt, con el inicio y el final de cada escena.

Usa --sem-musica para generar el video sin la pista.

Entrega a la persona:

  • el video;
  • la guía de narración y los tiempos;
  • un pie de foto para la publicación (gancho, paso a paso, prompt completo si lo hay, "Ejemplo ilustrativo." y de 3 a 5 hashtags).

Antes de enviar, revisa 4 o 5 cuadros del MP4 final (extráelos con ffmpeg).

Paso 5. La voz (cuando la persona envíe el audio)

La persona graba la narración siguiendo la guía (en el celular mismo, o con una voz de IA, si prefiere). Cuando ella envíe el archivo:

python3 <carpeta-de-la-habilidad>/scripts/reel.py roteiro.json --out saida --nome mi-reel --audio /ruta/voz.m4a
  • Sin marcas de tiempo, el script distribuye las escenas a lo largo del audio, según la proporción de palabras de cada escena.
  • Para sincronizar con precisión, coloca en el JSON "marcas_audio": [0, 7.8, 15.2, ...], con el segundo en que comienza cada escena en la grabación. La persona puede decir esos tiempos, o puedes escuchar el archivo si tienes una herramienta de transcripción con tiempo por palabra.
  • El resultado es saida/meu-reel-com-voz.mp4, con la pista más baja debajo de la voz.

Otra opción: la persona coloca la voz por su cuenta en un editor de video (CapCut, InShot, el editor de Instagram) usando el video sin voz.

Recordatorio al entregar: si hay voz, imagen o video generados por IA, la persona debe marcar la etiqueta de IA al publicar.

Formato del roteiro.json

{
  "marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "frase corta del perfil"},
  "palavras_por_segundo": 2.3,
  "cenas": [
    {"selo": "!", "titulo": "Bandeja de entrada *llena?*", "narracao": "...", "exemplo": false,
     "duracao": 6.5,
     "janela": {"tipo": "lista", "...": "..."},
     "nota": {"texto": "Prompt en la leyenda ↓", "sub": "Guarda", "em": 0.4},
     "pilula": {"texto": "se puede desactivar", "em": 0.3, "y": 0.4}}
  ]
}
  • duracao es opcional: sin ella, la duración se obtiene de la narración.
  • La tarjeta final muestra la inicial del @. No pongas mascota, a menos que la persona lo pida.
  • nota (post-it) y pilula (etiqueta flotante) son opcionales. El valor de em es la fracción de la escena en la que aparecen (0 a 1).
  • El color se oscurece automáticamente si el texto queda difícil de leer sobre blanco.

Marcaciones en los textos de las ventanas: [[trecho]] se convierte en resaltado que aparece durante la escena; {{trecho}} se convierte en una franja negra que cubre el texto (dato confidencial).

tipoPara quéCampos
listabandeja de entrada, lista de tareas, archivostitulo, itens ([remitente, asunto, vista previa]), nao_lidas (índices), destaque (índice), tremer, destaque_em
textoconversación, notas, documentotitulo, resumo ({titulo, linhas}), resumo_animado, mensagens ([{autor, texto}]), marcar_em, tarjar_em, etiquetas (píldoras con ✓), etiquetas_em
chatasistente de IA (ventana oscura)titulo, prompt (escrito), resposta (lista de líneas; opcional), caracteres_por_segundo
escreverresponder correo o mensajetitulo, texto (escrito), botao
planilhatabla simpletitulo, colunas, linhas, coluna_destaque, formula (opcional: solo fórmulas verificadas), revelar_ultima
cartaonovedad, regla o resumen destacadoselo, titulo (acepta *destaque*), texto, fonte (de dónde viene la información)
finaltarjeta "Sígueme"bio, botao, clique_em

Problemas comunes

  • "no encontré el ffmpeg": el script intenta instalar imageio-ffmpeg mediante pip automáticamente. Si no funciona, ejecuta pip install imageio-ffmpeg (con --break-system-packages, si es necesario).
  • Texto cortado o fuera de la ventana: acorta el texto, divídelo en dos mensajes o usa menos elementos en la lista (caben aproximadamente 5 líneas).
  • Leyenda muy rápida: aumenta duracao de la escena o recorta palabras de la narración.
  • Fuentes: Inter y JetBrains Mono (licencia SIL Open Font, archivos en assets/fonts).

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados