Communitygithub.com

Firepanda415/recherche-et-vidéos-scientifiques

Planifier, scripter, animer et vérifier des vidéos explicatives narrées d'articles de recherche, de dépôts de code ou de méthodes scientifiques, avec voix off et sous-titres incrustés.

Qu'est-ce que recherche-et-vidéos-scientifiques ?

Cette compétence permet à un agent IA de produire des vidéos explicatives animées et narrées, destinées à un public scientifique mais non spécialiste du sujet traité. Elle couvre l'ensemble du processus : lecture et analyse de la source (article, dépôt de code, méthode), création d'une carte des affirmations, rédaction d'un script narré, animation synchronisée, et vérification rigoureuse avant livraison. L'agent peut ainsi générer des vidéos de type « paper explainer », des résumés animés (animated abstracts), ou des animations programmatiques (comme avec Manim). La compétence insiste sur la traçabilité de chaque donnée, la reproductibilité des calculs, et l'inspection manuelle du rendu final. Elle s'intègre dans un pipeline de production existant ou en crée un nouveau en suivant une architecture documentée. Le style visuel et audio est cohérent grâce à un guide de style maison. Enfin, elle gère les révisions en localisant précisément les défauts et en les corrigeant à la source.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Firepanda415/research-and-scientific-lib-skills/tree/HEAD/plugins/research-skills/skills/research-explainer-animation

Demander à votre IA préférée

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

Documentation

Animation d'explication de recherche

Réalisez une courte vidéo narrée qui explique un travail de recherche à un spectateur scientifiquement averti mais qui ne l'a pas lu. Traitez la vidéo comme une publication sur le travail. Chaque affirmation, nombre, équation et courbe tracée doit provenir de la source, et la vidéo rendue doit être inspectée avant livraison.

Préparer à partir de la source

  1. Lisez l'intégralité de la source. Pour un article, incluez les tableaux, les légendes des figures et les annexes qui se cachent derrière les nombres que vous citerez. Pour un dépôt sans article, lisez son README, sa documentation, ses exemples et ses tests, et n'expliquez que le comportement que le code prend en charge.
  2. Rédigez une carte des affirmations avant le script. Couvrez le problème, pourquoi il est difficile, l'idée clé, ce qui est nouveau par rapport aux travaux antérieurs cités, comment la méthode fonctionne bloc par bloc, les résultats avec leurs conditions, et les limitations énoncées. Enregistrez le tableau, la section ou le fichier derrière chaque nombre, et marquez les nombres dérivés, comme un pourcentage calculé à partir de deux entrées d'un tableau, comme dérivés.
  3. Tracez des données réelles. Recherchez les données et le code des auteurs, y compris les dépôts nommés dans l'article et les copies locales de l'utilisateur. Avant d'utiliser une quantité tracée, retracez-la jusqu'à ses données et recalculez toute valeur dérivée ou tout ajustement à partir de ces données. Comparez les valeurs retracées ou recalculées avec celles rapportées. Ne relancez une simulation ou une expérience coûteuse qu'avec l'approbation de l'utilisateur. Étiquetez les entrées schématiques comme illustratives.
  4. Trouvez le pipeline d'animation existant du projet de destination et son module de style et réutilisez-les, afin qu'une nouvelle vidéo corresponde aux précédentes. Sans pipeline existant, construisez-en un en suivant l'architecture décrite dans pipeline de production, et traitez ses noms de fonctions comme des suggestions. Prenez les chemins, l'environnement et les commandes de construction, ainsi que la manière dont les vidéos se rattachent à une page à partir des instructions du projet lorsqu'il en possède. Utilisez l'environnement déclaré par le projet. Lorsqu'il n'en déclare aucun, utilisez les outils installés qui répondent aux besoins du pipeline, enregistrez leurs chemins et versions avec les sources de la vidéo, et dites à l'utilisateur ce qui doit encore être installé, y compris tout téléchargement de poids de synthèse vocale pour une première utilisation.

Scripter la narration

  • Visez la vidéo la plus courte qui porte le problème, l'idée, la méthode, les preuves et la portée. Un exposé complet d'article nécessite généralement trois à quatre minutes et demie, soit environ 450 à 600 mots parlés en anglais. Un résumé animé ou la limite de longueur d'une manifestation fixe un objectif plus court.
  • Suivez la carte des affirmations : problème, obstacle, idée, mécanisme, preuves, comparaison et compromis, puis un point clé à retenir. Créditez les travaux antérieurs sur lesquels la méthode s'appuie, et énoncez la contribution dans les termes mêmes de l'article. Reprenez les réserves et conditions de l'article dans la narration.
  • La narration et le texte à l'écran sont une prose durable. Appliquez research-writing-style, y compris sa révision obligatoire, avant la synthèse.
  • Divisez le script en segments d'une à quatre phrases. Chaque phrase comporte un texte de sous-titre et, si nécessaire, un texte parlé séparé qui épelle les acronymes, lit les symboles à voix haute ou remplace une prononciation.
  • Utilisez la voix que l'utilisateur a choisie pour les vidéos précédentes. Sans choix enregistré, synthétisez un court passage avec quelques voix candidates, écrivez les échantillons dans des fichiers audio, donnez leurs chemins à l'utilisateur et laissez-le choisir. Enregistrez le choix avec la configuration de la narration ou dans les notes du projet, afin que les vidéos ultérieures le réutilisent.

Lisez pipeline de production pour l'architecture de synthèse, de chronométrage, de rendu, de sous-titrage et d'encodage ainsi que ses modes de défaillance connus. Lisez guide de style pour le style visuel et audio par défaut.

Animer

  • Donnez à chaque phrase une idée visuelle, et commencez son animation au début de cette phrase, en utilisant les durées mesurées à partir de l'audio synthétisé.
  • Gardez les rôles de couleurs, la typographie, les étiquettes de section, la carte de titre, la carte de fin et la bande de sous-titres cohérents d'une vidéo à l'autre.
  • Composer les équations avec un composeur mathématique et tracez les graphiques à partir des données. Affichez les unités, l'incertitude avec sa statistique et les vrais signes moins.
  • Construisez une image fixe d'affiche séparée avec de grands éléments qui reste lisible à la largeur d'une vignette.

Vérifier avant livraison

Ces vérifications sont obligatoires. Une vidéo narrée peut échouer silencieusement d'une manière qu'un rendu réussi ne révèle pas.

  • Inspectez l'intégralité du rendu sous forme de planches-contact, par exemple une image toutes les quatre ou cinq secondes, et inspectez les images denses en taille réelle. Recherchez le texte rogné ou qui se chevauche, les étiquettes dessinées sur les axes, les formules incomplètes telles que les barres de fraction manquantes, et les objets qui se séparent des données qu'ils représentent pendant le mouvement.
  • Confirmez que chaque ligne de sous-titre a une narration en dessous et que les débuts des sous-titres correspondent aux débuts de la parole.
  • Comparez chaque nombre à l'écran et dans la narration avec la carte des affirmations.
  • Lorsque la vidéo est intégrée dans un site, construisez le site, exécutez ses tests et vérifiez la page et le lecteur aux largeurs de bureau et de téléphone avec les outils de navigation fournis par l'hôte, par exemple des captures d'écran sans tête aux deux largeurs. Sans ces outils, demandez à l'utilisateur de vérifier ces largeurs.
  • À moins que l'hôte ne permette à l'agent d'écouter l'audio, demandez à l'utilisateur d'écouter la prononciation et le rythme, et nommez les mots les plus à risque.

Livrer et réviser

Livrez la vidéo finie avec son chemin et sa durée, résumez son contenu et ses sources de données, et listez ce que l'utilisateur doit encore vérifier à l'oreille ou à l'œil. Pour un commentaire horodaté, localisez l'image, corrigez la cause plutôt que l'image unique, et recherchez le même défaut dans le reste de la vidéo et dans d'autres vidéos construites avec le même pipeline.

Skills associés