Communitygithub.com

Jihoon950/paper-to-research-video

Produisez une vidéo de recherche soignée de 80 à 100 secondes à partir d’un article académique ou d’une prépublication, avec des affirmations sourcées, des scènes animées personnalisées, des légendes et un fichier MP4 vérifié.

Qu'est-ce que paper-to-research-video ?

Cette compétence transforme un article de recherche (PDF, DOI, URL) en une vidéo de recherche percutante de 80 à 100 secondes. Elle est conçue pour les chercheurs, les conférenciers et les communicateurs scientifiques qui souhaitent présenter clairement un problème, une solution proposée, les résultats expérimentaux et leurs limites, le tout en s’appuyant sur les preuves de l’article original. La compétence fonctionne avec Remotion et FFmpeg (ou d’autres outils adaptés) et produit un MP4 1080p, un storyboard scène par scène, un registre des affirmations avec sources précises, et des sous-titres. Elle automatise l’extraction des revendications clés, la conception de scènes animées différenciées (données réelles vs. illustrations explicatives), et la vérification de la durée et de l’intégrité scientifique via des scripts de validation (validate_film.py, verify_video.py). Elle respecte les droits d’auteur, ne modifie pas les captures réelles et marque clairement les éléments reconstruits. Cette compétence est idéale pour des démonstrations de recherche, des soumissions de conférences ou des présentations de projets, mais ne convient pas pour un simple résumé textuel ou une édition vidéo générique.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jihoon950/paper-to-research-video/tree/HEAD/skills/paper-to-research-video

Demander à votre IA préférée

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

Documentation

Du papier à la vidéo de recherche

Créez un film qui permet à un nouveau spectateur de comprendre le problème, ce qui a été construit ou proposé, ce qui a été testé et ce que les preuves montrent réellement en environ 90 secondes. Traitez l’article fourni comme la source des preuves, et non comme un jeu de diapositives à survoler.

Commencez par la source

  1. Lisez l’intégralité de l’article, y compris les légendes des figures, les méthodes, les unités, les bases de référence, les limites et le supplément lorsqu’il est fourni. Pour une URL ou un DOI, récupérez l’article référencé. Pour un PDF local, extrayez le texte et inspectez les pages réelles des figures ; effectuez une OCR sur les pages scannées si nécessaire. Ne déduisez pas les résultats du seul résumé.
  2. Établissez un registre compact des affirmations : chaque affirmation quantitative ou causale affichée à l’écran doit comporter l’emplacement exact de la source (page, figure, tableau ou élément supplémentaire), la définition de la métrique, la condition de comparaison et toute qualification. Séparez les mesures rapportées, l’interprétation des auteurs et vos propres illustrations explicatives. Si un résultat clé est ambigu, inspectez à nouveau la source et précisez l’affirmation.
  3. Inventoriez les figures, tableaux, vidéos, photos, logos, enregistrements d’écran et droits de l’article source. Privilégiez les figures/données propres à l’article ou les diagrammes générés originalement. Si une démonstration demandée d’un système réel ne dispose d’aucun enregistrement, construisez une illustration explicitement étiquetée ; ne la présentez pas comme une séquence observée. Ne téléchargez pas de matériel source privé ou non publié vers un service externe sans autorisation.

Réalisez le film

Rédigez une liste de plans scène par scène avec code temporel, un message par plan, l’action visuelle, ce qui se déplace et où, la transition, les sous-titres/narration, les identifiants de source des affirmations et la provenance des médias. Utilisez la structure narrative adaptée à l’article ; un parcours courant est enjeux → système ou idée → comparaison contrôlée → mécanisme → résultat et limites. Placez le titre de l’article, les auteurs et l’institution en ouverture lorsqu’ils sont connus. Montrez le système testé avant de montrer son échec ou son avantage lorsque ce contexte est nécessaire.

Visez 90 secondes par défaut (80 à 100 est acceptable) ; ajustez lorsque l’utilisateur spécifie une durée différente. Utilisez le temps d’écran pour la configuration expérimentale et les dénominateurs, pas seulement le plus grand nombre. Si une comparaison est conditionnelle, identifiez l’état de chaque côté et la base de référence ; ne transformez pas des mesures à condition fixe séparées en preuve d’un contrôleur en ligne mesuré. Donnez au plan de clôture une conclusion précise et une limite.

Planifiez le langage visuel à partir de la science. Animez les diagrammes, les tracés mesurés, les traces et les séquences filmées autorisées de manière différente afin que le public puisse les distinguer. Les vidéos réelles ou les sorties terminales doivent conserver leur provenance ; les rejeux, les mécanismes illustratifs et les tableaux de bord simulés doivent être clairement marqués. Pas de métrique inventée, de flux de jetons, de trace d’utilisation, de journal d’échec ou de transition non mesurée. Pour des conseils détaillés sur la narration et l’étiquetage, lisez editorial-guidance.md.

Produisez et vérifiez

Créez un dossier de production fonctionnel à côté de l’article ou à l’emplacement choisi par l’utilisateur. Enregistrez-y le registre des affirmations et la liste des plans, puis implémentez le film avec un outil de timeline natif adapté au code (Remotion et FFmpeg là où ils sont disponibles ; choisissez un autre outil s’il correspond mieux à l’environnement). Le starter Remotion fourni est une base exécutable, pas un style visuel à laisser intact : remplacez son texte d’exemple et construisez des plans et transitions spécifiques à l’article. Son manifeste de film et le script scripts/validate_film.py fournissent une vérification réutilisable des preuves et du code temporel. Ne copiez pas les affirmations synthétiques du starter dans le film de l’utilisateur.

Rendez quelques images représentatives tôt pour inspecter la hiérarchie, les étiquettes, les droits d’image et le contraste à la taille de visualisation cible. Rendez ensuite la vidéo complète, inspectez l’ouverture/le milieu/la fermeture et les transitions, et corrigez le texte tronqué, les petits tracés, les légendes illisibles ou les sauts narratifs brusques. Livrez un MP4, le projet source, le registre des affirmations à source, la liste des plans et un fichier de sous-titres (ou des sous-titres à l’écran si demandé). Par défaut, 1920×1080, 30 ips, H.264 et sans audio lorsque l’utilisateur n’a pas choisi d’audio ; ajoutez narration/musique uniquement sur demande ou si le contexte l’exige clairement. Respectez la langue de l’utilisateur.

Exécutez <skill-dir>/scripts/validate_film.py path/to/film.json --release lorsque vous utilisez le manifeste du starter, et <skill-dir>/scripts/export_srt.py path/to/film.json path/to/captions.srt pour les sous-titres par scène. Exécutez ensuite <skill-dir>/scripts/verify_video.py path/to/final.mp4 --target-seconds 90 lorsque ffprobe et ffmpeg sont disponibles. Ces vérifications ne remplacent pas la révision visuelle et scientifique. Indiquez ce qui a été mesuré, ce qui a été reconstruit ou illustré, et quelles séquences étaient indisponibles. Ne considérez pas un rendu comme terminé si sa durée, son décodage, ses sous-titres ou ses affirmations scientifiques principales n’ont pas été vérifiés.

Skills associés