Communitygithub.com

DigitalRavagers/Experiment

Utilisez cette compétence lorsqu'un utilisateur souhaite une vidéo de lancement de produit, une promotion SaaS, une révélation de fonctionnalité, une vidéo marketing pour une application/entreprise/site, ou transformer un script/brief en vidéo centrée sur un produit. Les déclencheurs incluent : vidéo de lancement pour X, promotion pour notre site, expliquez mon SaaS en une minute, révélation de fonctionnalité pour X.com, et transformez ce script en une promo de 60 secondes. Peut utiliser une URL produit/marketing pour la capture de marque ou un mode sans capture à partir d'un brief/script. Ne convient pas pour les explications de sujet sans produit ni URL (faceless-explainer), les vidéos de changements de code GitHub PR (pr-to-video), les vidéos de sites web généraux sans lancement (website-to-video), les sous-titres sur une vidéo existante (embedded-captions), ou les animations graphiques courtes orientées design (motion-graphics). Lorsque la distinction produit-vs-sujet ou lancement-vs-site-général n'est pas claire, ne faites pas de supposition — commencez par /hyperframes.

Qu'est-ce que Experiment ?

Cette compétence, nommée `product-launch-video`, est une entrée de dispatch conçue pour les agents AI (comme Claude Code, Cursor, ou Codex) qui orchestrent la création de vidéos marketing pour des lancements de produits, promotions SaaS, révélations de fonctionnalités ou transformations de scripts en vidéos promotionnelles. Elle est idéale lorsqu'un utilisateur souhaite une vidéo pour un produit spécifique (site web, application, service) ou un brief marketing, et peut utiliser une URL pour capturer les éléments de la marque (couleurs, polices, styles) ou fonctionner sans capture à partir d'un script. La compétence est incompatible avec des vidéos explicatives sans produit, des vidéos de changements de code GitHub, des vidéos de sites web généraux, ou des animations graphiques courtes. Le flux de travail est structuré en phases strictes (init, capture, design-system, story-design, audio, visual-design, prep, captions, scenes, finalize), chacune exécutée via des commandes Bash ou des sous-agents, avec des contraintes précises (pas d'improvisation, pas de remplacement de pipeline) et une gestion des basculements vers des API cloud (HeyGen, ElevenLabs, Gemini) ou des solutions locales. La compétence est routée depuis l'entrée `/hyperframes` pour les cas ambigus.

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

Demander à votre IA préférée

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

Documentation

product-launch-video - entrée de dispatch

Confirmez la route avant l'Étape 0. Cette compétence crée une vidéo pour un produit en cours de marketing / lancement / promotion. S'il s'agit vraiment d'un site web général (sans lancement) → vidéo (visite guidée / démonstration du site, pas de vente d'un produit) → /website-to-video ; un sujet / concept sans produit → /faceless-explainer ; une Pull Request GitHub → /pr-to-video ; une vidéo existante à sous-titrer / conditionner → /embedded-captions · /graphic-overlays. Hors de portée (refuser, ne pas simuler) : données en direct / au moment du rendu (chaque valeur est intégrée au moment de la création), ou séquences / captures d'écran / avatar qui n'existent pas encore (HyperFrames ne peut pas enregistrer ou capturer). Routé ici sur un « créer une vidéo » vague, ou incertain produit-vs-sujet / lancement-vs-site-général ? Lisez /hyperframes d'abord.

Tous les artefacts sont écrits dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'Étape 0). Les chemins ci-dessous sont relatifs à PROJECT_DIR. Vous (l'orchestrateur) exécutez les étapes Bash et dispatchiez les sous-agents ; les détails par phase se trouvent dans les guides/agents/scripts liés — ne les développez pas ici. Le dispatch est portable pour le harnais : avant le premier dispatch de sous-agent, lisez <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md une fois — il mappe les verbes de dispatch (fan-out parallèle / arrière-plan / attente) aux primitives de votre harnais ; un plafond de concurrence ci-dessous N signifie des vagues de la taille du plafond, jamais moins de scènes. Ce fichier est un runbook 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 remplacez pas par un pipeline improvisé (narration écrite à la main, appels TTS ad-hoc, une composition faite à la main), et ne sautez pas une étape de pause parce que la demande semble claire. Une étape que vous ne pouvez pas exécuter → arrêtez-vous et signalez-le ; improviser au-delà brise chaque contrat en aval.

PhaseExécutionArtefact principalFlux détaillé
initBash directementhyperframes.jsonÉtape 0 (ce fichier)
captureBash directement (hyperframes capture)capture/extracted/tokens.jsonphases/capture/guide.md
design-systemsous-agentdesign-system/design.html + chunks/agents/design-system.md
story-designsous-agentnarrator_scripts.jsonagents/story-design.md
audioBash directement (audio.mjs)audio_meta.jsonphases/audio/guide.md
visual-designsous-agentsection_plan.mdagents/visual-design.md
prepBash directement (prep.mjs)group_spec.jsonscripts/prep.mjs entête
captionsBash directement (captions.mjs group -> html)caption_groups.json + compositions/captions.htmlscripts/captions.mjs entête
scenesN x sous-agent (parallèle, une scène chacun)compositions/scene_*.htmlagents/hyperframes-scene.md
finalizePrélude Bash (wait-bgm + assemble + transitions + hoist + sfx-verify) -> sous-agent de finalisationrenders/video.mp4Étape 7 / agents/hyperframes-finalize.md

Prérequis (installation avant la première exécution)

macOS Apple Silicon ou Linux x64 :

brew install [email protected] node ffmpeg                   # Sur Linux, utilisez l'équivalent apt/dnf
npx hyperframes doctor                                  # Vérification unique que Chrome / dépendances sont prêtes
  • [email protected] — Python Homebrew, pas le système /usr/bin/python3 (PEP 668 bloque pip install sinon) ; utilisé par le fallback MusicGen
  • node >= 18 + ffmpeg (audio.mjs utilise ffprobe)
  • Chrome se télécharge automatiquement au premier npx hyperframes capture. hoist-videos.mjs (Étape 7, s'exécute uniquement quand une scène déclare des séquences) réutilise ce Chrome en cache ; s'il signale des dépendances manquantes, exécutez node <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-deps une fois (~5s)

Clés API optionnelles (non définies -> fallbacks locaux ; injection à l'Étape 0.5 ; GEMINI_API_KEY ≡ GOOGLE_API_KEY) :

CléUtilisée pourVoix / fallback par défaut
HEYGEN_API_KEY (ou hyperframes auth login)TTS (cloud, avec horodatage au niveau du mot)voix : auto (première voix starfish anglaise ; remplacer --voice)
ELEVENLABS_API_KEYTTS (cloud ; nécessite pip install elevenlabs)voix 21m00Tcm4TlvDq8ikWAM (Rachel)
Ni l'une ni l'autre, et non connectéTTSKokoro local, voix am_michael (pour non-anglais, passer --voice)
GEMINI_API_KEY (une clé pour les deux usages)Légende vision de capture + BGM Lyrianon défini -> les légendes utilisent uniquement le contexte DOM ; BGM utilise MusicGen local (premier téléchargement ~300 Mo)

Flux

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

Avant l'Étape 0, en un message, confirmez uniquement ce qui façonne matériellement la vidéo de lancement et que vous ne pouvez pas déduire — proposez une valeur par défaut recommandée, sautez tout ce que l'utilisateur a déjà donné : l'angle / focus (le produit en général, une fonctionnalité vedette, une offre / CTA), la durée (par défaut ~30-90s ; jusqu'à ~3 min), et — si /hyperframes ne les a pas déjà définis — le format (par défaut 16:9 ; 9:16 pour vertical / réseaux sociaux) et la langue. La préconfiguration est dérivée de la capture de marque, pas demandée. Pour une demande entièrement spécifiée, sautez ceci et construisez.

Étape 0 - Initialiser le projet vidéo

cwd est la racine de l'espace de travail de l'agent ; tous les artefacts vidéo vont dans PROJECT_DIR = videos/<nom-du-projet>/.

Nommer <nom-du-projet> : un nom de répertoire explicitement donné par l'utilisateur l'emporte ; sinon choisissez un nom court en kebab-case comme <marque>-promo (jamais le nom de base de l'espace de travail ou un horodatage). À partir d'une URL, dérivez-le du domaine / titre de la page ; le nom est fixe une fois capture/ écrit.

Initialisation (uniquement quand $PROJECT_DIR/hyperframes.json n'existe pas) :

PROJECT_DIR="${LAUNCH_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 mais ne traitez pas leurs directives génériques comme des contraintes d'exécution — cette compétence est la source de vérité.

Contraintes (chaque violation casse les phases ultérieures) :

  • N'exécutez pas hyperframes init (ou générez AGENTS.md / CLAUDE.md) dans la racine de l'espace de travail ; ne créez pas de sous-projet hyperframes/ à l'intérieur de PROJECT_DIR.
  • Chaque contexte de dispatch de sous-agent contient une ligne PROJECT_DIR: <chemin> ; le sous-agent le traite comme la racine du projet.
  • Discipline cwd (maître aussi) : chaque commande Bash s'exécute dans un sous-shell (cd "$PROJECT_DIR" && ...) — jamais cd "$PROJECT_DIR" && ... nu (une dérive persistante de cwd rend les chemins relatifs ultérieurs incorrects).

Étape 0.5 - Orientation clé API

Ignorer quand $PROJECT_DIR/.env existe ou context.log n'est pas vide. Sinon, détectez ce qui est configuré (TTS HeyGen = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials ; ElevenLabs / Gemini = leurs clés d'environnement), puis faites toujours une pause et demandez — ne procédez pas par vous-même, même lorsqu'une configuration fonctionnelle est détectée :

Détecté : <résumé>. Les clés cloud sont optionnelles — sans elles, les fournisseurs non configurés tombent en local (TTS -> Kokoro sauf si HeyGen est configuré ; BGM -> MusicGen). Répondez avec :

  • collez les clés -> je les écrirai dans $PROJECT_DIR/.env
  • "go" -> procédez avec la configuration actuelle
  • "skip" -> procédez avec les fallbacks locaux pour tout ce qui n'est pas configuré

Clés collées -> Écrire/Modifier $PROJECT_DIR/.env, une KEY=valeur par ligne (remplacez les clés de même nom, ne jugez pas les valeurs). "go" / "skip" -> Étape 1.

Étape 1 - Capture (Phase 1)

  1. Résolvez SKILL_DIR et toute TARGET_URL explicite de l'invite ; assurez-vous que l'Étape 0 a été exécutée.
  2. Lisez $PROJECT_DIR/context.log s'il existe et utilisez le tableau Reprendre ci-dessous pour ignorer les phases terminées.
  3. Classez l'entrée (Étape 1.0) pour définir CAPTURE et VO_MODE, puis exécutez le chemin correspondant. Les deux chemins partagent les mêmes commandes en aval.

Étape 1.0 - Classer l'entrée (définir CAPTURE + VO_MODE)

Forme de l'entréeQue faire
URL explicite dans l'inviteTARGET_URL = cette URL ; CAPTURE=yes ; pas de question de voix-off (la narration provient du site capturé). Chemin (A).
Utilisateur a collé / pointé vers un script ou brief(1) Sauvegardez le texte textuel dans $PROJECT_DIR/user_script.txt. (2) Posez la question de voix-off une fois (ci-dessous) → définissez VO_MODE. (3) Résolvez une cible de capture à partir du script (ci-dessous) → définissez CAPTURE.
Un sujet / brief sans prose de script, sans produitCAPTURE=no ; pas de question de voix-off. Chemin (B).

Question de voix-off (uniquement quand l'utilisateur a fourni une prose de script réelle) — demandez une ligne courte et attendez :

Dois-je utiliser votre script textuellement comme voix-off, ou le restructurer en une narration de scène plus adaptée à l'écran ?

  • Textuel — conservez le libellé original ; je divise uniquement les scènes et associe les visuels. La durée suit le script.
  • Restructurer — traitez-le comme un brief et réécrivez une narration plus serrée, 1-2 phrases par scène.

VO_MODE = verbatim | restructure (par défaut restructure) ; transmis à story-design à l'Étape 2.

Résoudre une cible de capture à partir du script — par défaut, trouver et crawler un site (les vrais tokens de marque l'emportent sur les fallbacks de préconfiguration) ; ne passez que lorsque l'utilisateur a refusé ("pas de web / texte uniquement / pas de capture"). Dans l'ordre : (1) URL http(s):// explicite dans le script → utilisez-la, annoncez-la, CAPTURE=yes ; (2) nom de marque/produit clair → WebSearch pour le site officiel, confirmez l'URL résolue avec l'utilisateur en une ligne avant de crawler (refus / rien de crédible → CAPTURE=no) ; (3) rien de dérivable → CAPTURE=no.

Capture + script utilisateur coexistent : le crawl fournit uniquement les tokens de marque + actifs + registre visuel ; la colonne vertébrale de la narration reste user_script.txt (honorée via VO_MODE), jamais le texte du site lui-même.

(A) Chemin de capture (CAPTURE=yes) :

(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)

(B) Chemin sans capture (CAPTURE=no) — synthétisez un package de capture minimal ; en aval est identique. Vous (maître) choisissez la préconfiguration (aucun site à déduire ; choisissez parmi les 19 préconfigurations selon l'intention de l'utilisateur, ou demandez une question courte). Le script/brief complet va dans visible-text.txt ; colors:[] déclenche le fallback de la palette de préconfiguration (remplissez colors uniquement si l'utilisateur a nommé des couleurs de marque) :

(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<marque/titre>", "description": "<une-ligne>", "colors": [], "fonts": [], "headings": [], "sections": [], "ctas": [], "svgs": [], "cssVariables": {} }
JSON
)
(cd "$PROJECT_DIR" && echo '{}' > capture/extracted/design-styles.json)
(cd "$PROJECT_DIR" && printf '%s\n' "<script / brief utilisateur complet>" > capture/extracted/visible-text.txt)

Si l'utilisateur a déjà un narrator_scripts.json final, placez-le dans $PROJECT_DIR/ ; le tableau Reprendre ignore story-design.

En aval partagé pour les deux chemins (Chemin B ajoute --style <préconfig-choisie> à build-design ; Chemin A l'omet pour l'inférence automatique) :

(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/derive-context-pack.mjs --capture ./capture)
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/design-system/scripts/build-design.mjs ./design-system --no-emit)   # Chemin B : ajouter --style <préconfig-choisie>

Validation (arrêtez-vous et signalez si quelque chose manque ; si capture/BLOCKED.md existe, le site a bloqué le crawl — suivez les instructions à l'intérieur) :

[ -

…

[truncated for translation]

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

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /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