Communitygithub.com

Tela Viva : Reel tuto animé

Style Tela Viva. Crée des Reels animés 9:16 dans le style "tutoriel à l'écran" (fenêtres génériques utilisées, étapes numérotées, légende mot par mot) avec la couleur et le @ de la personne. À utiliser lorsqu'on demande "Tela Viva" ou un Reel/vidéo courte de tutoriel montrant des écrans et des applications en cours d'utilisation.

Qu'est-ce que Tela Viva : Reel tuto animé ?

La compétence **Tela Viva** transforme un thème ou un script de narration en un Reel vertical animé (1080×1920, 30 fps, MP4) dans le style « tutoriel à l'écran ». Elle est conçue pour les créateurs de contenu, les formateurs et les utilisateurs d'assistants IA qui souhaitent produire rapidement des vidéos explicatives montrant des interfaces génériques (liste de tâches, chat avec un assistant, feuille de calcul) sans utiliser de marques réelles. Le processus est entièrement automatisé par un script Python + ffmpeg, sans générateur vidéo IA. L'utilisateur fournit le thème ou la narration, et la compétence génère le storyboard, les animations de fenêtres, les légendes mot par mot (avec le mot prononcé dans la couleur de la marque) et le carton final « Me segue ». La compétence supporte les systèmes Unix/macOS/Linux et nécessite Python 3 avec ffmpeg. Le résultat est un fichier MP4 prêt à être posté, accompagné d'un guide de narration et des timings. L'utilisateur peut également fournir un fichier audio pour synchroniser la voix réelle avec les animations.

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

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 Tela Viva : Reel tuto animé ?

Kit de 3 styles : si la personne demande un Reel sans préciser le style et que vous avez aussi les compétences Modo 8-Bit (pixel art) et Hora Dourada (petits personnages plats pour histoires et tutoriels), demandez d'abord lequel des trois styles elle souhaite.

Cette compétence transforme un thème en un Reel vertical (1080×1920, 30 fps, MP4) dans le style tutoriel à l'écran :

  • en haut, une barre de progression et le numéro de l'étape à côté d'un titre court ;
  • au centre, des fenêtres génériques et sans marque qui « fonctionnent » (texte tapé, réponse qui apparaît, surlignage, bandeau sur une donnée sensible) ;
  • en bas, une légende mot par mot : le mot prononcé est dans la couleur de la marque ;
  • à la fin, une carte « Me segue ».

La vidéo est montée par code (Python + ffmpeg). N'utilise pas de générateur vidéo IA. Un Reel de 40 s est prêt en moins d'une minute.

Répondez toujours dans la langue de la personne (généralement portugais).

Étape 1. Comprendre la demande (une seule question, avec tout ce qui manque)

Posez d'un coup tout ce que la personne n'a pas encore dit :

  1. Thème : ce que le spectateur va apprendre ou tester ? Si elle a déjà apporté le texte de la narration, utilisez son texte.
  2. Marque : couleur principale en hex (ex. : #7C3AED) et le @ du profil. Sans réponse, utilisez violet #7C3AED et @seuperfil, et prévenez.

Si la personne dit « fait à ta manière », ne demandez pas : suivez les paramètres par défaut et dites lesquels vous avez utilisés.

Étape 2. Écrire le script

Créez un fichier roteiro.json (format ci-dessous ; modèle prêt dans exemples/roteiro-exemple.json).

Structure qui fonctionne (de 5 à 8 scènes, de 30 à 60 s) :

  1. Accroche (badge !) : une situation que la personne reconnaît, en 10 mots maximum dans la narration.
  2. Étapes numérotées (badges 1, 2, 3...) : une action par scène, avec la fenêtre montrant l'action.
  3. Attention (peut être l'une des étapes) : vérifier le résultat et ne pas coller de données sensibles.
  4. Appel à l'action (badge ✓) : par exemple, « Prompt dans la légende » avec un post-it (nota).
  5. Finale ("tipo": "final") : « Me segue pour plus... ».

Règles de contenu :

  • Titres de 6 mots maximum. Mettez en valeur 1 à 2 mots avec des *astérisques*.
  • Narration : environ 2,3 mots par seconde. La durée de chaque scène est déduite de la narration.
  • Utilisez des données, noms et entreprises fictifs (« Personne A », « Fournisseur ») et marquez "exemplo": true dans les scènes avec données.
  • N'utilisez pas de noms, logos ou écrans d'outils réels. Les fenêtres sont génériques (« assistant IA », « feuille de calcul », « boîte de réception »).
  • N'inventez pas de fonctionnalités, formules, chiffres ou résultats. Si le script cite une fonctionnalité d'un outil, vérifiez dans une source officielle (recherchez sur le web si possible) et dites à la personne ce que vous avez vérifié. Si vous ne pouvez pas vérifier, prévenez.
  • Pas de promesses exagérées (« économisez 10 heures », « plus jamais »).

Étape 3. Aperçus avant la vidéo

Lancez l'aperçu avec un temps du milieu de chaque scène (les temps apparaissent au début de la sortie) :

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

Ouvrez saida/previa_grade.jpg et vérifiez :

  • aucun texte ne sort de la fenêtre ;
  • aucun titre de plus de 2 lignes ;
  • surlignages et bandeaux aux bons endroits.

Ajustez le JSON et répétez si nécessaire. Ensuite, montrez à la personne la grille et le script dans un tableau (scène, ce qui apparaît, narration, temps) et demandez si elle peut générer la vidéo.

Étape 4. Générer la vidéo

python3 <dossier-de-la-competence>/scripts/reel.py roteiro.json --out saida --nome mon-reel

La commande génère :

  • saida/meu-reel-sem-voz.mp4, avec une piste calme et des sons de frappe créés par le script lui-même (pas de musique tierce) ;
  • saida/guia-narracao.txt, uniquement le texte parlé, un paragraphe par scène ;
  • saida/tempos.txt, avec le début et la fin de chaque scène.

Utilisez --sem-musica pour générer la vidéo sans la piste.

Livrez à la personne :

  • la vidéo ;
  • le guide de narration et les timings ;
  • une légende pour le post (accroche, pas à pas, prompt complet s'il y en a un, « Exemple illustratif. » et 3 à 5 hashtags).

Avant d'envoyer, regardez 4 ou 5 images du MP4 final (extrayez avec ffmpeg).

Étape 5. La voix (quand la personne envoie l'audio)

La personne enregistre la narration en suivant le guide (sur son téléphone même, ou avec une voix IA si elle préfère). Quand elle envoie le fichier :

python3 <dossier-de-la-competence>/scripts/reel.py roteiro.json --out saida --nome mon-reel --audio /chemin/voix.m4a
  • Sans marques de temps, le script répartit les scènes selon la taille de l'audio, proportionnellement au nombre de mots de chaque scène.
  • Pour une synchronisation précise, mettez dans le JSON "marcas_audio": [0, 7.8, 15.2, ...], avec la seconde à laquelle chaque scène commence dans l'enregistrement. La personne peut dicter ces temps, ou vous pouvez écouter le fichier si vous avez un outil de transcription avec temps par mot.
  • Le résultat est saida/meu-reel-com-voz.mp4, avec la piste plus basse sous la voix.

Autre option : la personne monte elle-même la voix dans un éditeur vidéo (CapCut, InShot, l'éditeur d'Instagram) en utilisant la vidéo sans voix.

Rappel lors de la livraison : si la voix, l'image ou la vidéo sont générées par IA, la personne doit cocher le label IA lors de la publication.

Format du roteiro.json

{
  "marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "phrase courte du profil"},
  "palavras_por_segundo": 2.3,
  "cenas": [
    {"selo": "!", "titulo": "Boîte de réception *saturée ?*", "narracao": "...", "exemplo": false,
     "duracao": 6.5,
     "janela": {"tipo": "lista", "...": "..."},
     "nota": {"texto": "Prompt dans la légende ↓", "sub": "Enregistre", "em": 0.4},
     "pilula": {"texto": "on peut désactiver", "em": 0.3, "y": 0.4}}
  ]
}
  • duracao est optionnel : sans elle, la durée vient de la narration.
  • La carte finale montre l'initiale du @. Ne mettez pas de mascotte, sauf si la personne le demande.
  • nota (post-it) et pilula (étiquette flottante) sont optionnels. La valeur de em est la fraction de la scène où ils apparaissent (0 à 1).
  • La couleur est automatiquement assombrie si le texte devient difficile à lire sur fond blanc.

Marquages dans les textes des fenêtres : [[extrait]] devient un surlignage qui apparaît pendant la scène ; {{extrait}} devient une bande noire qui couvre l'extrait (donnée sensible).

tipoUtilitéChamps
listaboîte de réception, liste de tâches, fichierstitulo, itens ([expéditeur, objet, aperçu]), nao_lidas (indices), destaque (indice), tremer, destaque_em
textoconversation, notes, documenttitulo, resumo ({titulo, linhas}), resumo_animado, mensagens ([{autor, texto}]), marcar_em, tarjar_em, etiquetas (pilules avec ✓), etiquetas_em
chatassistant IA (fenêtre sombre)titulo, prompt (tapé), resposta (liste de lignes ; optionnel), caracteres_por_segundo
escreverrépondre à un e-mail ou messagetitulo, texto (tapé), botao
planilhatableau simpletitulo, colunas, linhas, coluna_destaque, formula (optionnel : uniquement formules vérifiées), revelar_ultima
cartaonouveauté, règle ou résumé en surbrillanceselo, titulo (accepte *surbrillance*), texto, fonte (d'où vient l'information)
finalcarte « Me segue »bio, botao, clique_em

Problèmes courants

  • « ffmpeg introuvable » : le script essaie d'installer imageio-ffmpeg via pip tout seul. Si ça ne marche pas, lancez pip install imageio-ffmpeg (avec --break-system-packages si nécessaire).
  • Texte coupé ou hors de la fenêtre : raccourcissez le texte, divisez-le en deux messages ou utilisez moins d'éléments dans la liste (environ 5 lignes maximum).
  • Légende trop rapide : augmentez duracao de la scène ou coupez des mots dans la narration.
  • Polices : Inter et JetBrains Mono (licence SIL Open Font, fichiers dans assets/fonts).

Individual skills in this repo

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

Skills associés