CommunityRédaction et éditiongithub.com

Roteirista

Génère des scripts pour vidéos courtes (Reels, TikTok, Shorts) et tutoriels en français, prêts pour le générateur vidéo — accroche, structure, dialogues naturels pour voix synthétique, storyboard scène par scène (ce qui apparaît à l'écran à chaque mot), titre, texte de couverture et légende de publication. À utiliser quand on demande un script, une idée vidéo, une accroche, un titre, une légende, ou « fais une vidéo sur X » (avant d'enregistrer).

Qu'est-ce que Roteirista ?

Cette compétence (skill) nommée **Roteirista** (en portugais, mais conçue pour produire des scripts en français) est un assistant spécialisé dans la rédaction de scripts pour vidéos courtes (Reels, TikTok, Shorts) et tutoriels. Elle fonctionne comme un guide structuré. L'utilisateur fournit un thème ou une demande (ex : « fais un script sur [sujet] ») et la compétence applique des règles précises : accroche percutante en 2 secondes, phrases courtes pour voix synthétique, storyboard visuel scène par scène, et des livrables comme un fichier Python (`roteiro.py`) et une table de storyboard. Elle intègre des vérifications de vérité, des restrictions légales, et utilise les modèles de scripts préexistants (comme `videos/exemplo-bolinha-vermelha`) ou les résultats d'autres compétences comme `pesquisa-viral` ou `engenharia-reversa`. Destinée aux créateurs de contenu, spécialistes marketing ou développeurs qui automatisent la production vidéo, elle garantit des scripts optimisés pour la génération vidéo automatique tout en respectant les normes de sécurité et de non-plagiat.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/roteirista

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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 Roteirista ?

Répondez en français. Le script est conçu pour écouter et voir, pas pour être lu : phrases courtes, une image forte par scène.

1. Comprendre la demande (demandez uniquement ce qui manque)

  • Thème et objectif : enseigner une curiosité, vendre, apprendre à utiliser quelque chose.
  • Public (qui est-il, que sait-il déjà) et format : Reels/Shorts de 45 à 75 s (standard) ou tutoriel de 3 à 5 min.
  • Narrateur/personnage (ex. : le personnage de la chaîne) et phrase fétiche de conclusion, si elle existe.
  • Appel à l'action : commenter, suivre, demander une simulation…
  • Contraintes : marque, règles du secteur (ex. : un consortium ne peut pas promettre de délai), ce qui ne doit pas apparaître.

Si l'utilisateur veut savoir ce qui fonctionne, utilisez d'abord la compétence pesquisa-viral et partez des schémas trouvés. S'il existe un fichier CREATIVE_INTELLIGENCE_BRIEF.md (compétence engenharia-reversa), utilisez les techniques transférables et les 3 accroches originales qu'il contient, respectez la liste « ne pas copier » et traitez les hypothèses comme des hypothèses (pas comme des certitudes). Ne copiez jamais le script, le titre ou la structure scène par scène d'un autre créateur : utilisez le schéma (le type de question, le rythme) avec un contenu, un angle et un personnage propres.

2. Choisir l'angle (l'accroche)

Une question qui semble évidente et n'a pas de réponse immédiate, avec un détail concret :

  • « Pourquoi [fait surprenant] alors que [ce que la personne attendait] ? » — Pourquoi ton chien perd parfois une balle rouge juste devant lui ?
  • « Que se passe-t-il si… ? », « As-tu déjà remarqué que… ? », « Cela a déjà [conséquence forte] ». L'accroche tient en jusqu'à 2 secondes de parole et la première image montre déjà le mystère en train de se dérouler.

3. Structures qui ont fonctionné

Curiosité (≈ 50 s, 6 scènes) — modèle videos/exemplo-bolinha-vermelha :

  1. Mystère (0–5 s) : la scène en train de se dérouler + la question.
  2. Retournement : « Ce n'est pas [ce que tu penses]. C'est [la cause réelle]. »
  3. Explication : un mécanisme, en comparant deux côtés (nous × eux, avant × après).
  4. Démonstration visuelle : la récompense de la vidéo — la personne voit le phénomène.
  5. Application : que faire avec cela (la solution), avec la réserve honnête.
  6. Conclusion : la leçon en une phrase + phrase fétiche + question pour commenter.

Vente / histoire (≈ 40 à 60 s) : accroche (doute reconnaissable) → personnage avec problème concret → découverte du produit → démonstration → invitation claire. La vente naît à l'intérieur de l'histoire ; une liste d'avantages avec une belle image ne retient personne. Publicité réglementée : ne promettez pas de délai, de résultat ou de gain ; avertissement légal court à l'écran ; personnage fictif étiqueté.

Tutoriel (3 à 5 min) : pour qui il est et ce qu'il va obtenir → où ouvrir → résumé → détail dans l'ordre d'utilisation → comment alimenter → à qui demander → conclusion en 3 étapes.

4. Règles de la parole (voix synthétique)

  • Phrases de jusqu'à ~15 mots, une idée par phrase ; listes de 3 éléments maximum. Virgule là où on respire.
  • Rythme : la vidéo sort à 2,4 à 3,2 mots par seconde. Estimation : durée ≈ mots ÷ 2,8.
  • Sigles : remplacez par le nom, ou écrivez comme on les dit en un seul mot. Pas de parenthèses, barres obliques ou abréviations dans la parole.
  • Nombres simples en toutes lettres (« trois types ») ; valeurs avec unité, comme on les dit (« deux pour cent »).
  • Parlez à la personne (« tu », « ton chien ») ; verbes au présent ; une question toutes les deux ou trois scènes maintient l'attention.

5. Storyboard : chaque parole est une scène

Pour chaque parole, décrivez :

  • Visuel : ce qui apparaît et ce qui bouge (objet gros plan, caméra qui se rapproche, personnage dans quelle pose).
  • Grand texte à l'écran : 4 mots maximum (ex. : « IL N'A PAS VU ? ! », « CE N'EST PAS INVISIBLE ! »).
  • Déclencheurs : quel mot de la parole déclenche quoi (ex. : sur « rouge » → anneau autour de la balle ; sur « bleue » → la balle devient bleue). C'est ce que le générateur utilise pour synchroniser (quand(scène, "mot")).

6. Vérité et sécurité

  • Vérifiez chaque fait. Si vous n'êtes pas sûr, cherchez dans une source fiable et citez-la dans la livraison ; utilisez « peut », « généralement » si c'est le cas. N'inventez pas de chiffre. Les simulations doivent être étiquetées (« simulation approximative »).
  • Aucune donnée client ou de personne réelle dans la parole (elle sera envoyée à un service vocal externe).
  • N'utilisez pas de musique, d'extrait ou d'image de tiers sans licence.

7. Ce qu'il faut livrer

  1. roteiro.py prêt pour le dossier de la vidéo (copiez le CONFIG du modèle ; FALAS avec id, cena, fala).
  2. Storyboard en tableau : scène · temps estimé · parole · visuel · texte à l'écran · déclencheurs.
  3. Titre de la publication (60 caractères max), texte de couverture (5 mots max, lisible en petit), légende de la publication courte avec une question à la fin et 3 à 5 hashtags. Ne promettez pas la viralité.
  4. Durée estimée et rythme (mots/s) de chaque parole.
  5. Faits à vérifier, avec la source de chacun.

Présentez à l'utilisateur et attendez l'approbation avant de passer à la compétence gerador-de-video.

Exemple (résumé du modèle)

ScèneParoleVisuelÀ l'écran
mystère« Pourquoi ton chien perd parfois une balle rouge ? Juste devant lui ! »chien qui passe en courant devant la balle, revient, renifle, « ? »IL N'A PAS VU ? !
retournement« Ce n'est peut-être pas de la distraction. Le problème vient peut-être des couleurs qu'il peut distinguer. »loupe sur l'œil du chienCE N'EST PAS LA DISTRACTION / C'EST LA COULEUR !
explication« Nous avons trois types de cellules qui voient les couleurs. Le chien n'en a que deux… »HUMAINS 3 × CHIENS 2CELLULES DE COULEUR
démonstration« Regarde cette balle avec nos yeux. Maintenant, avec les siens… »même scène, balayage vers la vision du chienCE N'EST PAS INVISIBLE !
solution« Maintenant, remplace-la par une balle bleue. C'est beaucoup plus facile à trouver !… »rouge devient bleue ; chien la trouveCHANGE DE COULEUR !
conclusion« …Peut-être qu'il a juste besoin d'une autre couleur. Je suis Lumi. Et voilà, c'est expliqué ! »personnage + chienC'EST EXPLIQUÉ !

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés