Communitygithub.com

MrRoam/explainer-video-skill

Créez des vidéos explicatives en chinois, des vidéos de vulgarisation scientifique, des animations de principes ou des vidéos de style 3b1b. Utilisez Codex pour rédiger le script et le storyboard, et réutilisez les outils locaux Manim, Kokoro (doublage) et FFmpeg pour exporter au format MP4 et sous-titres.

Qu'est-ce que explainer-video-skill ?

Cette compétence permet de produire des vidéos explicatives animées et personnalisées en chinois, en s'appuyant sur Codex pour la génération du contenu et du code d'animation, et sur des outils locaux (Manim, Kokoro, FFmpeg) pour le doublage, le rendu et le montage. Elle s'inspire du style de 3Blue1Brown (fond sombre, couleurs d'accentuation, transformations géométriques continues) pour établir l'intuition avant d'introduire les formules. La configuration locale est gérée via un fichier JSON ou des variables d'environnement, et un script PowerShell facilite l'installation initiale sur Windows. L'utilisateur peut contrôler le projet en modifiant un fichier `lesson.json` et le script `scene.py`, et la pipeline guide la création du script, du storyboard, du doublage et du rendu final, avec des vérifications de qualité et une livraison complète (MP4, SRT, sources).

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add MrRoam/explainer-video-skill

Demander à votre IA préférée

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

Documentation

Vidéo explicative en chinois

Livrez une vidéo personnalisée et prête à être lue. Codex se charge du contenu et du code d'animation, les outils locaux assurent le doublage, le rendu et le montage. Par défaut : chinois, pour débutants, environ une minute, 720p, 30 ips ; les demandes de l'utilisateur pour cette session prévalent.

Par défaut, la méthode de raisonnement graphique de 3Blue1Brown est utilisée : fond sombre, quelques couleurs d'accentuation avec une signification fixe, des transformations géométriques continues, un zoom local, et une transformation correspondante entre les formules et les graphiques. Établissez d'abord l'intuition, puis introduisez la formule. Rédigez un script et un storyboard originaux pour le sujet actuel.

Outils réutilisés

La configuration locale se trouve dans runtime.local.json à la racine du skill, ou peut être spécifiée via EXPLAINER_RUNTIME ou --runtime. Vérifiez d'abord Python, FFmpeg, le modèle de doublage et les polices chinoises disponibles dans la configuration. En cas de configuration manquante, configurez l'environnement existant ou installez les dépendances manquantes selon README.md. Ne mettez pas en place de service permanent ou ne réinstallez pas un environnement réutilisable pour un simple test.

Pour une première installation sur Windows, exécutez scripts/setup.ps1 pour installer automatiquement les dépendances CPU nécessaires, télécharger le modèle chinois et enregistrer la configuration locale. Si une configuration valide existe déjà, seule la vérification des chemins est effectuée ; le script n'installe pas Python, TeX ou CUDA. Si des outils existent déjà dans d'autres répertoires, transmettez les chemins de l'environnement et du modèle correspondants pour les réutiliser.

python "SKILL_DIR\scripts\init_project.py" --workspace "WORKSPACE" --name concept-video

SKILL_DIR est le répertoire actuel du skill, WORKSPACE est le chemin absolu de l'espace de travail pour cette session. Le script ne copie qu'un petit modèle, ne télécharge pas de dépendances. Les sources se trouvent dans outputs/concept-video-project, le cache dans work/explainer/concept-video. Utilisez différents noms pour plusieurs vidéos ; reconfigurez les chemins après avoir déplacé les outils.

Rédaction et production

Modifiez simultanément lesson.json et scene.py dans le projet. Le modèle est un exemple de dérivée ; changer uniquement le titre ne fera pas un nouveau sujet. La synchronisation des champs, du storyboard et des commandes d'exécution est décrite dans references/pipeline.md.

Choisissez un problème concret et allez de l'exemple au principe. Chaque segment de narration correspond à un changement observable, par exemple le déplacement d'un point, la modification d'une courbe, la mise à jour d'une variable ou l'apparition progressive d'une relation. Les conclusions mathématiques doivent clairement indiquer les conditions de validité ; les sous-titres, formules et chiffres doivent correspondre au script. Les polices proviennent de la configuration locale ; MathTex dans le modèle nécessite TeX ; si TeX est manquant, utilisez Text et des objets géométriques à la place.

Par défaut, la version chinoise locale de Kokoro, le CPU et les voix téléchargées sont utilisés, sans besoin de grand modèle ou d'API vocale supplémentaire. Les symboles mathématiques, LaTeX et termes anglais dans la narration doivent être reformulés en chinois parlé. Faites d'abord un court essai d'écoute, puis générez la vidéo complète ; ne téléchargez pas automatiquement toutes les voix et ne changez pas le backend de doublage sans indication. D'autres fichiers audio peuvent être intégrés selon references/pipeline.md.

Vérification et livraison

Générez d'abord un aperçu en basse résolution, vérifiez le chinois, les formules, les obstructions et les bords, puis exportez la vidéo finale. Vérifiez que la narration n'est pas silencieuse, que chaque segment est complet et que la fin n'est pas coupée. Le script de rendu vérifie la taille et la synchronisation temporelle, mais la vérification visuelle et auditive reste nécessaire.

Livrez au format MP4, SRT, le script chinois et les sources reproductibles. Placez les fichiers de livraison dans le répertoire outputs de l'espace de travail, les fichiers intermédiaires dans work. Indiquez le backend de doublage réel et les limitations non résolues ; ne décrivez pas le succès du script comme si l'utilisateur était déjà satisfait de la qualité audio.

Skills associés