¿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:
- Tema: ¿qué aprenderá o probará quien lo vea? Si ya trajo el texto de la narración, usa su texto.
- Marca: color principal en hex (ej.:
#7C3AED) y el @ del perfil. Sin respuesta, usa morado#7C3AEDy@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):
- Gancho (sello
!): una situación que la persona reconoce, en hasta 10 palabras en la narración. - Pasos numerados (sellos
1,2,3...): una acción por escena, con la ventana mostrando la acción. - Cuidado (puede ser uno de los pasos): verificar el resultado y no pegar datos confidenciales.
- Llamada (sello
✓): por ejemplo, "Prompt en la leyenda" con un post-it (nota). - 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": trueen 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}}
]
}
duracaoes 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) ypilula(etiqueta flotante) son opcionales. El valor deemes 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).
tipo | Para qué | Campos |
|---|---|---|
lista | bandeja de entrada, lista de tareas, archivos | titulo, itens ([remitente, asunto, vista previa]), nao_lidas (índices), destaque (índice), tremer, destaque_em |
texto | conversación, notas, documento | titulo, resumo ({titulo, linhas}), resumo_animado, mensagens ([{autor, texto}]), marcar_em, tarjar_em, etiquetas (píldoras con ✓), etiquetas_em |
chat | asistente de IA (ventana oscura) | titulo, prompt (escrito), resposta (lista de líneas; opcional), caracteres_por_segundo |
escrever | responder correo o mensaje | titulo, texto (escrito), botao |
planilha | tabla simple | titulo, colunas, linhas, coluna_destaque, formula (opcional: solo fórmulas verificadas), revelar_ultima |
cartao | novedad, regla o resumen destacado | selo, titulo (acepta *destaque*), texto, fonte (de dónde viene la información) |
final | tarjeta "Sígueme" | bio, botao, clique_em |
Problemas comunes
- "no encontré el ffmpeg": el script intenta instalar
imageio-ffmpegmediante pip automáticamente. Si no funciona, ejecutapip 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
duracaode la escena o recorta palabras de la narración. - Fuentes: Inter y JetBrains Mono (licencia SIL Open Font, archivos en
assets/fonts).