Communitygithub.com

DigitalRavagers/Experiment

Workflow pr-vers-vidéo – transforme une pull request GitHub (URL comme github.com/<propriétaire>/<dépôt>/pull/<N>, ou <propriétaire>/<dépôt>#<N>, ou « cette PR » dans un dépôt cloné) en informations extraites de la PR (titre, corps, diff, commits, fichiers, statistiques +/-) → narrator_scripts.json + audio (voix + musique de fond) + section_plan.md → vidéo explicative de différences de code / avant-après / impact. L'entrée est un CHANGEMENT DE CODE. L'URL est un lien vers une PR, PAS un site marketing à scraper ; pas un résumé textuel ni un site produit. Pour une entrée autre qu'une PR (site produit, site général, sujet textuel), voir /hyperframes.

Qu'est-ce que Experiment ?

Cette compétence (skill) vous permet de transformer n'importe quelle pull request GitHub en une vidéo explicative dynamique qui montre ce qui a changé, pourquoi et comment cela fonctionne – le tout généré automatiquement à partir du diff et des commits. Elle prend en charge les plateformes d'agents compatibles avec le système Hyperframes (comme Claude Code, Cursor ou Codex) et est conçue pour les développeurs qui souhaitent partager visuellement l'impact de leurs modifications de code. Le flux de travail ingère les données de la PR via l'interface en ligne de commande `gh` (sans navigateur ni scraping), puis orchestre plusieurs phases : un sous-agent conçoit l'histoire (story-design), la phase audio génère la voix et la musique de fond, un autre sous-agent crée le plan visuel, et les phases de préparation, sous-titres, scènes et finalisation produisent la vidéo finale. La sortie est une vidéo au format 16:9, d'une durée recommandée de 30 à 90 secondes, avec un style éditorial chaleureux et une signature graphique « claude » (fond bleu foncé pour le code). Ce skill ne gère que les entrées de type pull request – pour d'autres types de contenu (site produit, article, dépôt complet), il redirige vers d'autres compétences spécialisées.

Compatible avec✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/DigitalRavagers/Experiment/tree/HEAD/.agents/skills/pr-to-video

Demander à votre IA préférée

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

Documentation

pr-vers-vidéo – point d'entrée de répartition

L'entrée est une pull request GitHub (un changement de code), fournie sous forme d'URL de PR, d'une référence <propriétaire>/<dépôt>#<N>, ou de « cette PR » alors qu'un dépôt avec une PR ouverte est cloné. La sortie est une vidéo explicative du changement de code : ce qui a été livré, pourquoi, et comment cela fonctionne — rendue à partir du diff/commits sous forme de scènes avant-après, surlignage des différences, arborescence de fichiers et d'impact. Longueur par défaut jusqu'à environ 3 min (point idéal ~30-90 s) ; un parcours vraiment plus long ou exhaustif de chaque fichier (5 min+) est un registre différent → /video-generale. Il n'y a pas de scraping de site web ni de Chrome sans tête pour l'ingestion — l'ingestion se fait via l'interface en ligne de commande gh. Le préréglage de style livré est toujours claude (éditorial chaleureux ; fenêtre de code bleu foncé signature).

Confirmez la route avant l'Étape 0. Cette compétence explique une pull request GitHub (un changement de code lu via gh). Si l'entrée est un site marketing / produit → /video-lancement-produit ; un site web général → /site-vers-video ; un sujet / article sans PR → /explicateur-sans-visage ; une visite de dépôt complet ou une sortie multi-PR → /video-generale. Hors périmètre : données en direct / au moment du rendu — les faits de la PR sont lus une fois au moment de la création et intégrés. Si on vous donne une entrée autre qu'une PR, ou si vous n'êtes pas sûr ? Lisez /hyperframes d'abord.

Ce flux de travail ne possède que le front spécifique à la PR (ingestion + conception de l'histoire) ; chaque phase marquée partagée réutilise le moteur copié depuis l'explicateur sans visage inchangé (il se trouve sous les propres scripts/ + agents/ + phases/ de cette compétence, donc <SKILL_DIR> se résout en pr-vers-vidéo).

Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'Étape 0) ; tous les chemins ci-dessous lui sont relatifs. La répartition est portable pour le harnais : avant la première répartition de sous-agent, lisez <SKILL_DIR>/../hyperframes-core/references/repartition-sous-agent.md une fois — il mappe les verbes de répartition (déploiement parallèle / arrière-plan / attente) aux primitives de votre harnais ; un plafond de concurrence inférieur à N signifie des vagues de la taille du plafond, jamais moins de travailleurs. Ce fichier est un cahier de route contraignant, pas une lecture de fond : exécutez les étapes dans l'ordre et produisez chaque artefact de phase avec son script ou rôle d'agent désigné — ne substituez pas un pipeline libre, et ne sautez pas une étape de pause parce que la demande semble claire. Une étape que vous ne pouvez pas effectuer → arrêtez-vous et signalez-le.

PhaseExécutionArtefact principalFlux détaillé
initBashhyperframes.jsonÉtape 0
ingestion (propre)Bash (gh CLI + ingest.mjs + fetch-people-avatars.mjs, PAS d'agent, PAS de scraping)capture/pr.json + diff.patch + extracted/{tokens.json,visible-text.txt,people.json} + public/avatars/Étape 1
conception-système (partagée)Bash (pas d'agent, claude déterministe)design-system/design.html + chunks/Étape 1b
conception-histoire (propre)sous-agentnarrator_scripts.jsonagents/conception-histoire.md
audio (partagée)audio.mjs dans Bashaudio_meta.jsonphases/audio/guide.md
conception-visuelle (partagée)sous-agentsection_plan.mdagents/conception-visuelle.md
préparation (partagée)prep.mjs dans Bashgroup_spec.jsonscripts/prep.mjs
sous-titres (partagée, dét.)captions.mjs group -> captions.mjs html dans Bash (pas de sous-agent)caption_groups.json + compositions/captions.htmlscripts/captions.mjs
scènes (partagée)N x sous-agent (parallèle)compositions/scene_*.html ou compositions/group_w*.htmlagents/scenes-hyperframes.md
finalisation (partagée)Prélude Bash (attente-musique-de-fond + assemblage + injection/vérification-transitions + élévation-vidéos + vérification-effets-sonores + précontrôle) -> sous-agent de finalisation (correction des problèmes mineurs sur place + un aperçu type contact-sheet + rendu)renders/video.mp4Étape 7 / agents/hyperframes-finalisation.md

Prérequis

macOS Apple Silicon ou Linux x64. Outils système : brew install [email protected] node ffmpeg (utilisez Homebrew Python, pas /usr/bin/python3, ou pip install sera bloqué par PEP 668) ; ensuite npx hyperframes doctor une fois (télécharge Chrome — nécessaire pour l'instantané/rendu, pas pour l'ingestion). La porte de chevauchement rendue (scripts/check-overlap.mjs, exécutée dans les auto-vérifications des travailleurs et le précontrôle) réutilise ce même Chrome mis en cache — elle ne télécharge jamais de navigateur ; sa seule dépendance est le module npm puppeteer-core, assuré une fois avant le déploiement des scènes (Étape 5.5, --ensure-deps, ~5 s, pas d'installation complète de puppeteer). Interfaces en ligne de commande : gh (GitHub CLI, authentifié — gh auth status doit réussir) et hyperframes. Clés cloud optionnelles (sinon alternatives locales) — injectez à l'Étape 0.5 :

Clé / conditionUtilisée pourValeur par défaut / alternative
gh auth status OKLecture de la PR (publique ou privée)requis — échouez rapidement avec l'indice d'auth
HEYGEN_API_KEY (ou hyperframes auth login)TTS (cloud, horodatages au niveau du mot)voix : auto (première voix anglaise starfish ; remplacer --voice)
ELEVENLABS_API_KEYTTS (cloud ; nécessite pip install elevenlabs)voix 21m00Tcm4TlvDq8ikWAM (Rachel)
ni l'un ni l'autre, et non connectéTTSKokoro local, voix am_michael (non-anglais : passer --voice)
GEMINI_API_KEY / GOOGLE_API_KEY (alias)Musique de fond Lyrianon défini -> MusicGen local (première exécution télécharge ~300 Mo)

Flux

Étape 0.0 - Confirmer le brief (TOUJOURS demander un tour, puis construire)

Avant l'Étape 0, faites toujours une pause et demandez le brief en un seul message, puis attendez l'utilisateur — ne sautez jamais cette étape, même pour une demande qui semble complète. Proposez une valeur recommandée par défaut pour chaque champ et pré-remplissez tout ce que l'utilisateur a déjà donné (confirmez-le plutôt que de le redemander aveuglément) : l'angle (journal des modifications / révélation de fonctionnalité / correction / refactorisation — par défaut : déduire de la PR), l'audience (développeurs vs utilisateurs généraux — par défaut : développeurs), la longueur (par défaut ~60-90 s), et — si /hyperframes ne les a pas définis — l'aspect (par défaut 16:9) et la langue. Le style est toujours claude. Passez à l'Étape 0 seulement après que l'utilisateur a répondu ; une réponse « go » / « utilise les valeurs par défaut » est une réponse valide qui accepte toutes les valeurs par défaut.

Étape 0 - Initialiser le projet vidéo

Le répertoire de travail courant est la racine de l'espace de travail de l'agent (par ex. /tmp/pr-video-...). Écrivez tous les artefacts vidéo sous PROJECT_DIR = videos/<nom-du-projet>/.

<nom-du-projet> : utilisez le répertoire donné par l'utilisateur (par ex. Use ./videos/retry-pr), sinon un nom court en kebab-case dérivé de la PR (<dépôt>-pr-<N>, par ex. widgets-pr-1187). Pas le nom de base de l'espace de travail ou un horodatage.

Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :

PROJECT_DIR="${PR_VIDEO_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank

hyperframes init dépose un AGENTS.md / CLAUDE.md générique dans $PROJECT_DIR ; laissez-les en place — ce sont des échafaudages d'agent pour quiconque ouvre le projet terminé plus tard.

Contraintes : n'exécutez jamais hyperframes init / ne générez jamais AGENTS.md / CLAUDE.md à la racine de l'espace de travail ; n'imbriquez jamais un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais de cd nu.

Étape 0.5 - Conseil sur les clés API

Sautez si $PROJECT_DIR/.env existe ou si context.log n'est pas vide (= ce n'est pas la première exécution). Sinon, détectez d'abord ce qui est disponible (HeyGen TTS activé si $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY est défini ou si ~/.heygen/credentials existe depuis hyperframes auth login ; ElevenLabs / Gemini uniquement si leurs clés d'environnement sont définies), puis faites toujours une pause et proposez le menu — attendez l'utilisateur ; ne continuez pas par vous-même même si une configuration fonctionnelle est détectée (l'utilisateur peut vouloir ajouter une clé comme Gemini). Indiquez ce qui est détecté, puis : collez les clés (→ Écrivez $PROJECT_DIR/.env, une KEY=valeur par ligne, remplacez le même nom) / « go » (continuez avec ce qui est configuré — env, .env ou hyperframes auth login) / « skip » (continuez avec les alternatives locales pour tout ce qui n'est pas configuré). Passez ensuite à l'Étape 1.

Étape 1 - Ingestion (Bash, PAS d'agent, PAS de scraping)

Résolvez la référence de la PR et extrayez les faits structurés avec gh, puis intégrez-les dans le paquet de capture synthétique attendu par le backend partagé (reflète l'échafaudage sans scraping de l'explicateur sans visage). gh s'exécute ici, dans l'orchestrateur, donc les erreurs d'authentification / introuvable / dépôt privé apparaissent avec le stderr propre à gh ; ingest.mjs est une transformation pure hors ligne.

# Référence PR : une URL complète, "<propriétaire>/<dépôt>#<N>", ou "<N>" dans un dépôt cloné.
PR="<url | propriétaire/dépôt#N | N>"

# Échouez rapidement si gh n'est pas authentifié.
gh auth status || { echo "gh non authentifié — exécutez : gh auth login" ; exit 1 ; }

(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && gh pr view "$PR" \
  --json number,title,body,author,url,baseRefName,headRefName,commits,files,additions,deletions,changedFiles,labels,reviews,latestReviews,comments,assignees,reviewDecision,mergedBy \
  > capture/pr.json)
(cd "$PROJECT_DIR" && gh pr diff "$PR" > capture/diff.patch)

# Intégrez pr.json + diff.patch dans tokens.json (colors:[] → palette native claude) +
# visible-text.txt (le brief narratif) + people.json (auteur de la PR + auteurs de commits avec compteurs +
# relecteurs / commentateurs / assignés, filtrés des bots + dédoublonnés, chacun avec une URL d'avatar GitHub).
# (L'`author` de la PR est seulement l'ouvreur ; les auteurs de commits depuis commits[].authors[] sont également suivis.)
# ingest est HORS LIGNE.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
  --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)

# Étape réseau (la seule du front des personnes — ingest reste hors ligne) : téléchargez l'avatar GitHub
# de chaque contributeur vers public/avatars/<login>.png pour un crédit optionnel /
# un plan de fermeture "livré par". Au mieux — un avatar manquant ou une exécution hors ligne ne bloque jamais (exit 0).
# Les avatars + ce plan sont le SEUL endroit où pr-vers-vidéo assouplit la valeur par défaut sans visage.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

Validation :

[ -s "$PROJECT_DIR/capture/pr.json" ] && \
[ -s "$PROJECT_DIR/capture/diff.patch" ] && \
[ -s "$PROJECT_DIR/capture/extracted/tokens.json" ] && \
[ -s "$PROJECT_DIR/capture/extracted/visible-text.txt" ] && \
[ -s "$PROJECT_DIR/capture/extracted/people.json" ] && \
[ -d "$PROJECT_DIR/capture/assets" ] && echo ok || echo manquant
# public/avatars/ est au mieux — son absence n'est PAS un échec (aucun avatar résolu / hors ligne).

Si gh génère une erreur (authentification / introuvable / privé), signalez le stderr exact et arrêtez-vous — ne fabriquez pas le contenu de la PR. Si ingest.mjs se termine...

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

DigitalRavagers/Experiment

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Skills associés