Communitygithub.com

reel

Réalisez des vidéos verticales courtes (Instagram Reels, TikTok, YouTube Shorts) localement avec ReelStudio. Codex écrit le script, planifie et code les scènes, et vérifie ses propres images ; OpenRouter s'occupe de la voix (ElevenLabs v4 Turbo), des images (MAI-Image-2.7, GPT Image 2.6 Sunburst pour les plans héroïques) et des horodatages des mots ; Remotion rend le MP4 sur ce Mac. Utilisez-le lorsque l'utilisateur demande un reel, une short, une vidéo TikTok, une vidéo verticale, une vidéo à partir d'un sujet ou d'un script, ou s'interroge sur ses reels, marques ou voix ReelStudio.

Qu'est-ce que reel ?

ReelStudio est un outil puissant pour créer des vidéos verticales courtes (Reels Instagram, TikTok, Shorts YouTube) directement en local, sans dépendre de services cloud de montage. Il agit comme un producteur et réalisateur IA : il rédige le script, conçoit les storyboards, génère des visuels (photos réelles, images IA, vecteurs SVG/React), ajoute une voix off naturelle via des modèles comme Gemini 3.8 Flash TTS ou ElevenLabs v4, et assemble le tout avec Remotion pour produire un fichier MP4 prêt à être publié. Ce skill est particulièrement utile pour les créateurs de contenu, les marketeurs et les développeurs qui souhaitent automatiser la production de vidéos verticales de haute qualité. Il fonctionne sur macOS, nécessite un accès réseau pour les appels API (OpenRouter pour la voix et les images), et s'intègre avec des outils comme Claude Code, Codex ou Cursor. L'utilisateur peut contrôler chaque étape : choix de la marque (définissant le ton, les couleurs, la police), du look (direction créative), du script (validé par l'utilisateur avant génération), des images (photos libres de droits depuis Wikimedia ou images IA), et du rendu final. Le flux de travail standard comprend : la configuration initiale (copie du moteur, installation de Remotion), la création d'un script et d'un storyboard, la génération de la voix et du timing, la sélection du matériel visuel (photos, images IA, vecteurs), la construction des scènes en React/TSX, et enfin le rendu vidéo. Des fonctionnalités avancées incluent le format 'zoom' pour une qualité éditoriale premium (caméra fluide sur un grand monde sans coupure), la gestion des marques et des looks, et la possibilité de repolir l'audio sans repayer pour une nouvelle prise.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/luke30001/reelstudio-codex/tree/HEAD/plugins/reelstudio/skills/reel

Demander à votre IA préférée

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

Documentation

ReelStudio : sujet entré, reel sorti

Vous êtes le producteur et l'équipe. Faites ce que vous seul pouvez faire (écriture, réalisation, codage des scènes, jugement des images) et exécutez la commande reelstudio pour ce que vous ne pouvez pas faire (voix, images, horodatages, rendu).

reelstudio <commande>     # = $RS ci-dessous ; lanceur dans ~/.local/bin, exécute ~/ReelStudio/engine/bin/rs.mjs

$RS ci-dessous signifie reelstudio. Si reelstudio n'est pas dans le PATH, utilisez node ~/ReelStudio/engine/bin/rs.mjs (après la première configuration) ou node <racine du plugin>/engine/bin/rs.mjs (la racine du plugin se trouve deux dossiers au-dessus de ce SKILL.md). Le moteur appelle OpenRouter et exécute ffmpeg et Chrome headless (Remotion), il a donc besoin d'un accès réseau et doit écrire dans ~/ReelStudio : si le bac à sable bloque une commande reelstudio, demandez des autorisations élevées pour celle-ci plutôt que de contourner le problème. Exécutez chaque commande individuellement (pas de chaînes cd … && ou de pipes). setup, frames et render peuvent prendre quelques minutes.

Tout se trouve dans ~/ReelStudio/ : reels/<nom>/, brands/*.json, looks/<id>/look.json (+ images de mascotte et de référence), .env (clé OpenRouter), config.json (remplacements de modèle optionnels). L'utilisateur peut également tout piloter depuis l'application web Codex : node <racine du plugin>/app-codex/server.mjs (http://127.0.0.1:4749 ; il exécute codex exec en tant que producteur).

0. Première fois

Exécutez $RS setup (copie le moteur, installe Remotion une fois, crée la marque default). Si elle signale qu'aucune clé OpenRouter n'est présente, la voix et les images ne peuvent pas fonctionner : arrêtez-vous et demandez à l'utilisateur de la définir lui-même (dans son propre Terminal : reelstudio key, ou OPENROUTER_API_KEY=... dans ~/ReelStudio/.env). Ne lui demandez jamais de coller la clé dans le chat. Réexécutez $RS setup après avoir mis à jour le plugin (le lanceur choisit la version de plugin installée la plus récente).

1. Brief

Obtenez le sujet (ou le script de l'utilisateur), la marque ($RS list affiche les marques et les looks), la langue et la durée cible (par défaut 25–40 s). Pour une qualité éditoriale premium (zooms fluides de la caméra sur un seul monde, police serif pour le titre, pilule rouge, cartes propres) utilisez une marque avec le look editoriale (ou cronaca pour l'histoire et les histoires vraies avec des photos réelles, marque storia) et le format zoom de l'étape 5b ; n'importe quel sujet convient. Lisez ~/ReelStudio/brands/<marque>.json et suivez son tone.

Le look est la ligne créative. Chaque marque pointe vers un look dans ~/ReelStudio/looks/<id>/look.json. Lisez-le avant d'écrire quoi que ce soit et obéissez à sa bible (règles de mise en page, utilisation de la mascotte, ce qu'il faut éviter). Ses couleurs, sa police, son style de légende et son arrière-plan sont appliqués automatiquement. Son imageStyle et ses images de référence sont ajoutés automatiquement à chaque appel rs image, donc toutes les images d'une marque partagent un seul style. Chaque reel d'une marque doit ressembler à une partie de la même série.

2. Script et storyboard

$RS new "<sujet>" --brand <marque> affiche le nom du reel. Écrivez reels/<nom>/reel.json :

{"title": "...", "brand": "default", "scenes": [
  {"id": "hook", "voiceover": "...", "visual": "ce qui est à l'écran", "hold": 0.2}
]}

Règles pour le script :

  • Accroche dans les 2 premières secondes : une affirmation surprenante, un nombre ou une question. Pas de "Bonjour à tous", pas de "Dans cette vidéo".
  • 5 à 9 scènes, une idée chacune, 6 à 20 mots de voix off par scène. Phrases parlées courtes. Écrivez les nombres comme ils doivent être prononcés ("quatre", pas "4"), car le TTS lit exactement ce que vous écrivez.
  • Les faits doivent être vrais. Si vous n'êtes pas sûr d'un nombre, omettez-le.
  • Terminez par une conclusion, puis une courte scène d'appel à l'action (suivre, enregistrer, commenter un mot). L'appel à l'action obtient toujours son propre écran propre : <EndScreen title="…" sub="…" actions={['Enregistrer', 'Suivre']} /> (fond de marque opaque qui couvre le monde/les photos, mascotte si le look en a une, pilule du nom de la marque). Ne placez jamais l'appel à l'action sur des photos, un monde ou les visuels d'une autre scène.
  • Les id sont des slugs courts et stables. Changer le voiceover d'une scène ne ré-enregistre que cette scène.

Montrez le script à l'utilisateur (lignes de voix off uniquement) et attendez son accord avant de dépenser pour la voix, à moins qu'il n'ait dit d'aller directement à la fin.

3. Voix et timing

$RS voice <nom> : génère un MP3 par scène avec Gemini 3.8 Flash TTS (voix Charon : n°1 dans l'arène TTS, son italien natif) via OpenRouter, obtient les horodatages des mots à partir de la transcription Nemotron, et écrit timeline.json (images à 30 ips par scène et par mot). Les voice.instructions de la marque guident le ton et le rythme (écrivez-les dans la langue du reel, par exemple "ton documentaire, rythme soutenu"). Options : --scene id1,id2 pour refaire certaines scènes, --voice <nom> (Gemini : Charon, Kore, Puck, Aoede, Fenrir, Leda, Orus, Zephyr…), --tier eleven (ElevenLabs v4 : le plus expressif, comprend les balises [excited] [whispers] [pause], mais ses voix préfabriquées sont des anglophones), --tier native (Microsoft MAI-Voice-2.1, vraies voix it-IT Luca/Rosa, plus lent et plus ponctué), --tier budget, --local (voix macOS de brouillon robotique : uniquement lorsque l'utilisateur demande explicitement un brouillon gratuit. Ne l'utilisez jamais comme solution de repli : si voice échoue à cause du réseau ou de la clé, corrigez cela, par exemple en réexécutant la même commande avec un accès réseau, et render refuse de toute façon les scènes avec voix de brouillon). Chaque clip est poli automatiquement : le silence mort est coupé aux deux extrémités, seules les pauses de plus de 0,65 s sont raccourcies (les pauses de respiration normales restent, sinon la voix semble essoufflée), égalisation et niveau doux (--raw-voice saute cette étape) ; la prise non retouchée est conservée dans assets/vo/raw/, et voice <reel> --repolish refait le polissage sans payer pour une nouvelle prise. Le rendu amène le mix à −14 LUFS. Les scènes se succèdent avec un hold de 0,2 s ; augmentez-le pour un temps fort dramatique délibéré (0,5–0,8). Les instructions vocales reçoivent une note de rythme naturel ; définissez "pace": "free" dans la voix de la marque pour la supprimer. Avec --speed au-dessus de 1,3, même une voix calme commence à sembler essoufflée : suggérez 1,2–1,3 pour les reels riches en parole. Écrivez la voix off comme des phrases connectées qui s'enchaînent dans la scène suivante, pas comme des légendes isolées. Une marque peut épingler des voix par modèle : "voice": {"voices": {"google/gemini-3.8-flash-tts": "Kore"}}.

4. Matériel visuel : choisissez ce qui sert chaque plan

Rien n'est forcé : par plan, choisissez le matériel qui semble le meilleur et qui est honnête, et mélangez librement. Demandez la limite de l'utilisateur pour les images payantes (par défaut ≤ 4).

  • Photos réelles (histoire, actualités, lieux réels, personnes, objets qui existent) : $RS photo <nom> search "<requête en anglais, année, lieu>" liste les résultats sous licence libre de Wikimedia Commons (domaine public, CC0, CC BY/BY-SA) et écrit frames/photos-sheet.png (4 par ligne, ordre de la liste) : regardez-la, choisissez, puis $RS photo <nom> get <n> <nomimg> → assets/img/<nomimg>.jpg (jusqu'à 3000 px) avec l'auteur/la licence enregistrés dans assets/credits.json. Montrez toujours le crédit (<Credit file="img/x.jpg" />, ou <Photo … credit>). Préférez les photos réelles aux images IA chaque fois que le sujet a réellement existé ; ne présentez jamais une image IA comme une photo historique.
  • Images IA (illustration, concepts, reconstitutions, scènes qu'aucun appareil photo n'a capturées) : $RS image <nom> <nomimg> "<prompt>" avec la direction artistique et les références du look.
    • --world : Nano Banana 2.1 en 4K (3072×5504, ~0,12 $) : une image assez grande pour être le monde de la caméra ou une grande impression ; reste nette jusqu'à environ 2,8× de zoom.
    • --res 2K|4K avec --model bytedance-seed/seedream-4.5 (4K, 0,04 $, détails plus denses) ou d'autres modèles qui le supportent ; --aspect 1:1|3:4|16:9 pour des impressions non verticales.
    • par défaut (MAI-Image-2.7, ~800 px, ~0,035 $) et --hero (GPT Image 2.6 Sunburst, meilleurs détails, ~860 px, ~0,15–0,21 $) : uniquement pour les petites cartes ou insertions, jamais pour les zooms profonds ou les arrière-plans plein écran.
    • --mascot, --ref img/autre.png (continuité), --no-style. Décrivez le sujet et la composition ; le look gère le style. Ajoutez toujours "composition verticale, pas de texte" (ou le bon rapport hauteur/largeur). Regardez chaque image que vous générez (ouvrez le PNG avec l'outil de visualisation d'image, view_image).
  • Vectoriel (SVG/React) là où c'est plus propre que n'importe quelle image : graphiques, nombres, cartes et diagrammes, chronologies, icônes ($RS icon <nom> <nom-lucide…>), interface utilisateur, étiquettes. Construisez-le avec soin : largeurs de trait cohérentes, uniquement la palette du look, ombres douces et dégradés, espacement généreux. Ne simulez jamais un objet ou une scène avec des formes grossières : si cela nécessite un dessin, utilisez une image IA ; si cela a existé, utilisez une photo.
  • Règle de résolution : à l'écran, une image ne doit jamais être affichée plus grande que sa largeur en pixels (zoom × largeur du monde ≤ largeur du PNG) ; rs frames montrera un flou si vous enfreignez cette règle.

5. Construire les scènes : reels/<nom>/src/Reel.tsx

Composez les composants à partir de @rs (source : ~/ReelStudio/engine/src/lib/index.tsx, lisez-le lorsque vous avez besoin de détails) :

import React from 'react';
import {Reel, Title, BigStat, Bullets, Quote, Compare, Icon, Card, CTA, ImageBG, Mascot, CoverFrame, BrandBG, ReelProps} from '@rs';

export default (p: ReelProps) => (
  <Reel {...p}
    scenes={{
      hook: <><Title kicker="Psychologie" text="Votre cerveau *adore* les listes" /><Mascot pos="peek" /></>,
      stat: <BigStat value={4} prefix="≈" label="éléments dans la *mémoire de travail*" />,
      why:  <Bullets title="Pourquoi ça marche" items={['Divise le problème', 'Réduit l*effort*']} />,
      cta:  <CTA text="Plus d'astuces sur le *cerveau*" />,
    }}
    backgrounds={{ hook: <ImageBG src="img/brain.png" /> }}
  />
);

// Optionnel : une image de couverture. Les animations s'affichent déjà terminées ici.
export const Cover = (p: ReelProps) => (
  <CoverFrame brand={p.brand}><BrandBG /><Title text="Votre cerveau *adore* les listes" /><Mascot pos="peek" /></CoverFrame>
);
  • Chaque identifiant de scène dans reel.json a besoin d'une entrée dans scenes. *mot* met ce mot dans la couleur d'accent.
  • Composants : Title, Kicker, BigStat (comptage), Bullets (révélation chronométrée sur la scène, ou at=[images] synchronisée avec les images de mots de timeline.json), Quote, Compare (deux colonnes), Icon (gros emoji), Card (image encadrée), CTA, ImageBG (Ken Burns à fond perdu), BrandBG (l'arrière-plan du look : papier, dégradé ou uni ; c'est l'arrière-plan par défaut), Mascot (la mascotte du look : pos="peek" glisse depuis le bord droit, "corner" se place en bas à droite de la zone de contenu, "center" est un grand héros ; src="img/pose.png" utilise une pose générée). Les superpositions sont automatiques : légendes karaoké, barre de progression, nom de la marque. Désactivez-les avec captions={false} et des props similaires.
  • Le texte à l'écran complète la voix off. Ne le répétez pas mot pour mot, car les légendes le font déjà. Limitez-vous à 2–7 mots par scène.
  • Les visuels personnalisés sont autorisés : écrivez vos propres composants React dans src/ avec useF(), useScene(), useBrand(), interpolate, spring, fitFont, Stage depuis @rs. Veillez à ce que tout soit déterministe (pas de Math.random, pas de Date).
  • Zones de sécurité (1080×1920) : contenu entre y=200 et y=1180, à l'intérieur de Stage. Les légendes se situent à y≈1250–1450. Rien d'important en dessous de y=1500, où Instagram place son interface utilisateur.
  • Variez les mises en page : n'utilisez jamais le même composant trois scènes de suite.

5b. Le format zoom (qualité éditoriale premium)

Le moyen d'atteindre une qualité d'explication de premier ordre sur n'importe quel sujet, avec le look editoriale (explications propres) ou le look cronaca (histoire, économie, histoires vraies avec des photos réelles) : un grand monde, une seule caméra qui glisse et zoome dessus, jamais de coupe franche. Lisez la bible du look et suivez-la. Le monde peut être composé de photos réelles, d'images IA 4K et de pièces vectorielles dans n'importe quelle combinaison (étape 4).

import React from 'react';
import {Reel, ReelProps, Headline, Pill, StatCard, Badge, ChartCard, Source, Credit, Grain, At, WorldGround, WorldImage, EndScreen, CoverFrame, AbsoluteFill, useBrand, useReveal} from '@rs';

const W: [number, number] = [3240, 6300];
// Impressions disposées sur une table en papier, éloignées les unes des autres pour que la caméra voyage (photos de `rs photo`, 3000 px de large)
const P = {crowd: {x: 1050, y: 1600, w: 1600, h: 1186, r: -2}, line: {x: 2200, y: 5050, w: 1500, h: 1206, r: 1.5}};
const world = (
  <>
    <WorldGround w={W[0]} h={W[1]} pattern="lines" step={64} />
    {Object.entries(P).map(([k, p]) => <WorldImage key={k} src={`img/${k}.jpg`} x={p.x} y={p.y} w={p.w} h={p.h} rotate={p.r} radius={6} grade="bw" />)}
    {/* les étiquettes de type musée, un fil rouge entre les impressions, une image IA 4K ou des pièces SVG peuvent également vivre ici */}
  </>
);
const OVER = {x: 1620, y: 3250, zoom: 0.34};
const Dim = () => { const b = useBrand(); const o = useReveal(0, 16); return <AbsoluteFill style={{background: b.colors.bg1, opacity: 0.82 * o}} />; };

export default (p: ReelProps) => (
  <Reel {...p} world={world} worldSize={W} overlay={<Grain amount={0.14} />}
    camera={{
      hook: OVER,                                                                  // vue d'ensemble de toute la table
      crowd: [{x: 1050, y: 1850, zoom: 0.62}, {x: 1170, y: 1720, zoom: 0.95, at: 0.42, move: 40}], // survoler, puis plonger dans un détail
      chart: {x: 1620, y: 4400, zoom: 0.42},                                       // reculer, atténuer le monde, montrer les données
      line: {x: 2200, y: 5280, zoom: 0.64},
      cta: OVER,
    }}
    scenes={{
      hook: <Headline title={'Le Jeudi noir\nde Wall Street'} pill="−11% en quelques heures" />,
      crowd: <><StatCard value={12.9} decimals={1} suffix=" mln" label="actions échangées : *un record*" y={900} w={680} delay={150} /><Credit file="img/crowd.jpg" y={1165} /></>,
      chart: <><Dim /><ChartCard type="line" data={[381, 199, 294, 41]} labels={['sept 1929', '', '', 'juil 1932']} title="Dow Jones, 1929–1932" x={540} y={720} w={940} h={640} /><Badge value="−89%" label="depuis le sommet" x={540} y={1150} color="#B3261E" delay={150} /><Source text="Source : S&P Dow Jones Indices" y={1215} /></>,
      line: <><StatCard value={25} suffix="%" label="chômeurs aux USA en 1933" y={880} w={720} /><Credit file="img/line.jpg" y={1170} /></>,
      cta: <EndScreen title={"Histoires qui ont\nchangé l'économie"} sub="Chaque semaine une crise, expliquée" actions={['Enregistrer', 'Suivre']} />,  // écran propre, jamais au-dessus du monde
    }}
  />
);
export const Cover = (p: ReelProps) => (
  <CoverFrame brand={p.brand} world={world} worldSize={W} shot={{x: 1050, y: 1900, zoom: 0.62}}>
    <Headline title={
...

[La suite se concentre sur l'écran de fin et la configuration du rendu.]

## 6. Rendu
`$RS frames <nom>` génère les images PNG (vérifie les résolutions, avertit en cas de flou). `$RS render <nom>` produit le MP4 final. Options : `--preview` (qualité inférieure, rendu plus rapide, pour vérifier le montage), `--no-clean` (conserve les images intermédiaires). Le rendu peut prendre plusieurs minutes selon la complexité et la durée.

## 7. Publication
Le MP4 se trouve dans `reels/<nom>/out/`. L'utilisateur peut le télécharger manuellement ou utiliser un script de partage. Il n'y a pas de fonctionnalité de téléversement automatique intégrée.

---

### Conseils généraux
- **Itérez vite** : montrez le script, les images, les images clés avant de lancer un rendu complet. Utilisez `--preview` pour les tests.
- **Qualité avant quantité** : mieux vaut un reel court et percutant qu'un long et ennuyeux.
- **Respectez les marques et les looks** : ils définissent l'identité visuelle. Ne les ignorez pas.
- **Vérifiez les faits** : ne diffusez pas de fausses informations.
- **Créditez les sources** : toujours créditer les photos libres de droits selon leur licence.
- **La voix est primordiale** : une bonne voix off peut faire ou défaire un reel. Choisissez le bon modèle et les bonnes instructions.

### Dépannage
- `reelstudio` introuvable : vérifiez le PATH ou utilisez le chemin direct avec `node`.
- Pas de clé OpenRouter : exécutez `reelstudio key` ou définissez `OPENROUTER_API_KEY` dans `~/ReelStudio/.env`.
- La voix échoue : vérifiez le réseau, la clé, ou réessayez avec un modèle différent (`--tier`).
- Les images sont floues : respectez la règle de résolution (zoom × largeur du monde ≤ largeur du PNG).
- Le rendu est lent : utilisez `--preview` pour les tests, ou réduisez la durée/le nombre d'images.

### Notes techniques avancées
- Le moteur Remotion est installé une fois par `setup`, dans `~/ReelStudio/engine/`.
- Les fichiers de cache et temporaires sont dans `~/ReelStudio/tmp/`.
- Les logs sont dans `~/ReelStudio/logs/`.
- Les modèles d'IA peuvent être remplacés dans `config.json` à l'échelle du projet.
- Le format `--world` utilise un monde unique de haute résolution, idéal pour les explications détaillées.

### Bonnes pratiques pour le script
- Accroche forte dès la première seconde.
- Phrases courtes et percutantes.
- Utilisez des nombres et des statistiques pour renforcer l'impact.
- Terminez par un appel à l'action clair.
- Adaptez le ton à la marque et au sujet.

### Bonnes pratiques pour les visuels
- Photos réelles pour l'authenticité.
- Images IA pour les concepts et reconstitutions.
- Vectoriel pour les données et schémas.
- Mélangez les types de visuels pour maintenir l'intérêt.
- Ne surchargez pas les scènes ; chaque visuel doit servir un but.

### Bonnes pratiques pour la voix
- Choisissez la voix adaptée au ton du reel.
- Utilisez les instructions vocales de la marque.
- Évitez les vitesses trop élevées (`--speed` > 1.3).
- Laissez des pauses naturelles ; ne supprimez pas toutes les respirations.
- Utilisez `--repolish` si nécessaire, sans repayer.

### Exemple de flux de travail complet
1. `reelstudio setup` (première fois seulement)
2. `reelstudio new "Sujet" --brand ma_marque`
3. Écrire `reel.json` avec le script et le storyboard
4. Montrer le script à l'utilisateur, obtenir l'accord
5. `reelstudio voice mon_reel`
6. Choisir les photos/images : `rs photo ... get`, `rs image ...`
7. Écrire `Reel.tsx` avec les composants et la mise en scène
8. `reelstudio frames mon_reel --preview` (vérifier)
9. `reelstudio render mon_reel` (production)
10. Publier le MP4 depuis `reels/mon_reel/out/`

Skills associés