Communitygithub.com

DigitalRavagers/Experiment

Utilisez cette compétence comme solution de repli pour la création personnalisée de compositions vidéo HTML avec HyperFrames, lorsque aucun workflow spécialisé ne correspond. Elle couvre les pièces longues ou multi-scènes, les bandes-annonces de marque, les montages, les cartes-titres, les affiches animées, les boucles statiques et les compositions libres de toute durée ou format.

Qu'est-ce que Experiment ?

Cette compétence sert de solution de repli (fallback) pour la création de compositions vidéo HTML personnalisées dans HyperFrames. Elle est conçue pour les cas où aucun workflow spécialisé existant (comme les vidéos de lancement de produit, les explications de sujet, les vidéos de PR GitHub, etc.) ne correspond précisément à la demande. L'utilisateur est invité à confirmer la route appropriée avant de construire, en lisant le fichier /hyperframes pour s'orienter. La compétence guide l'utilisateur à travers un processus en plusieurs étapes : découverte du brief, établissement d'un système de design (via les références hyperframes-creative), expansion du prompt pour les compositions multi-scènes, planification de l'expérience narrative, structure, rythme et timing, puis construction avec une approche 'Layout Before Animation' (disposition avant animation). Elle met l'accent sur une vérification rigoureuse avant de coder (HARD-GATE) pour s'assurer que l'identité visuelle, le concept, le choix de typographie et le plan de densité sont corrects. La compétence délègue ensuite les aspects spécifiques (animation, media, sous-compositions) à des compétences spécialisées via HyperFrames. Enfin, elle fournit une checklist de validation via l'outil CLI hyperframes et rappelle les cas où ce workflow de repli n'est pas approprié.

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

Demander à votre IA préférée

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

Documentation

general-video — création de composition générale

Confirmez la route avant de construire. Il s'agit du repli (fallback) pour la création de composition personnalisée. Si l'entrée correspond clairement à un workflow spécialisé, préférez-le : produit commercialisé → /product-launch-video ; site général → /website-to-video ; explicateur de sujet → /faceless-explainer ; PR GitHub → /pr-to-video ; séquence existante → /embedded-captions · /graphic-overlays ; motion design court non narré → /motion-graphics ; port Remotion → /remotion-to-hyperframes. Hors périmètre : données en direct / au rendu, montage de type NLE d'une vidéo terminée, ou production de séquences qu'HyperFrames ne peut pas capturer. Incertain ? Lisez /hyperframes d'abord.

Construisez exactement ce qui a été demandé. Une carte-titre est une carte-titre — pas une carte-titre + trois scènes d'appoint + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires améliorent véritablement la pièce, proposez-les ; ne les ajoutez pas en silence. Pour les petites modifications (corriger une couleur, ajuster une durée, ajouter un élément), sautez les étapes de planification et passez directement à la construction.

Approche

Découverte — uniquement pour les demandes ouvertes

Pour les demandes vagues et exploratoires ("créez quelque chose pour notre marque", "une intro cool") — comprenez l'intention avant de choisir les couleurs :

  • Audience — qui regarde ? développeurs / cadres / consommateurs généraux ?
  • Plateforme — où est-ce diffusé ? réseaux sociaux (15s) / hero d'un site web / démo produit / interne ?
  • Priorité — quel est le plus important ? qualité du mouvement / exactitude du contenu / fidélité à la marque / rapidité ?
  • Variations — une seule meilleure version, ou 2-3 options significativement différentes (rythme, énergie ou structure différents — pas seulement des changements de couleur) ?

Pour les demandes spécifiques ("ajoutez une carte-titre", "corrigez le timing de la scène 3"), sautez la découverte.

Étape 1 — Système de design → hyperframes-creative

Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges design, lisez-le (priorité frame.md → design.md → DESIGN.md ; traitez-le comme la vérité de la marque — couleurs, polices, contraintes exactes).

S'il n'existe pas de cahier des charges, vous DEVEZ lire À LA FOIS hyperframes-creative/references/house-style.md ET hyperframes-creative/references/video-composition.md avant de choisir une couleur ou une police. house-style.md donne l'ouverture "interpréter l'invite / générer du contenu réel", la liste des valeurs par défaut paresseuses et la recette des couches ; video-composition.md donne les règles de densité / échelle / détail du premier plan (barres de données, repères d'enregistrement, métadonnées monospace, "8-10 éléments, dont deux que l'utilisateur n'a pas demandés") qui séparent "produit" de "généré". Ne lire qu'un seul des deux est l'erreur la plus courante — video-composition.md est celui que les agents sautent, et c'est exactement celui qui empêche les rendus plats, centrés et ressemblant à des pages web. Ne vous inventez pas une palette et ne sautez pas ces fichiers ; passer par hyperframes-creative est obligatoire ici, pas une branche optionnelle. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, si nécessaire. Le cahier des charges / style définit la marque, pas les règles de composition.

Trouvez l'angle (brief vague, pas de cahier des charges) : avant de choisir les couleurs, écrivez UNE phrase — qu'est-ce que ce nom/mot/sujet évoque, et quel monde visuel (métaphore, décor, instrument, motif) l'exprime ? Par exemple, un outil de cybersécurité → portes de coffre / lignes de balayage de périmètre / gâches de serrure ; une application de méditation → marée, souffle, lente éclosion de lumière. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'un relooking littéral. C'est le substitut économique de l'expansion d'invite (Étape 2) pour les pièces à scène unique, où l'expansion est correctement ignorée — et c'est la différence entre un concept designé et un logo générique sur un dégradé.

Étape 2 — Expansion d'invite → hyperframes-creative

Exécutez pour toute composition multi-scènes (ignorez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges de design + au style de la maison pour produire un intermédiaire cohérent que le travail en aval lira de la même manière. Voir hyperframes-creative/references/prompt-expansion.md.

Étape 3 — Planification

Avant d'écrire du HTML, pensez à un niveau élevé :

  1. Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
  2. Structure — nombre de compositions, sous-comp vs inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la question fichier monolithique unique vs modulaire, voir hyperframes-core/references/composition-patterns.md § Deux architectures (règle empirique : ≥3 coupures de scène franches, ou toute scène réutilisée → modulariser ; une courte pièce à scène unique reste un seul fichier).
  3. Rythme — nommez le motif avant de l'implémenter (par ex. rapide-rapide-LENT-SHADER-tenu) ; voir hyperframes-creative/references/beat-direction.md.
  4. Timing — quels clips déterminent la durée, où tombent les transitions, le pacing.
  5. Disposition — construisez d'abord l'état final (voir ci-dessous).
  6. Animer — puis ajoutez le mouvement via hyperframes-animation.

Disposition avant animation

Positionnez chaque élément là où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en sortie. Écrivez cela d'abord en HTML + CSS statique. Pas encore de GSAP.

Pourquoi : si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle à 0, opacité 0) et que vous créez une transition vers l'endroit où vous pensez qu'ils atterrissent, vous devinez la disposition finale — les chevauchements restent invisibles jusqu'au rendu. Construisez d'abord l'état final et vous voyez et corrigez les problèmes de disposition avant d'ajouter le mouvement.

  1. Identifiez l'image clé de chaque scène — le moment où le plus grand nombre d'éléments sont simultanément visibles. C'est la disposition que vous construisez.
  2. Écrivez le CSS statique pour cette image. Le conteneur de contenu doit remplir la scène avec du padding, pas des décalages absolus :
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* le padding positionne le contenu ; remplit n'importe quelle taille de scène */
  gap: 24px;
  box-sizing: border-box;
}

N'utilisez jamais position: absolute; top: Npx sur un conteneur de contenu — il déborde lorsque le contenu est plus grand que l'espace. Réservez le positionnement absolu pour les éléments décoratifs.

⚠ Le width/height: 100% ci-dessus ne fonctionne que si chaque ancêtre a une hauteur définie. La racine <div data-composition-id> et tout wrapper entre elle et .scene-content doivent être dimensionnés (position: relative; width: 1920px; height: 1080px sur la racine — voir hyperframes-core → "La racine doit être dimensionnée"). Si vous ne le faites pas, le conteneur flex se réduit à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est tronqué à x=0 — tandis que lint/inspect signalent encore 0 problème. Et gardez toujours le padding (≥80px) sur .scene-content : c'est la marge de sécurité pour le titre. Ne le remplacez jamais par un simple gap.

  1. Ajoutez les entrées — animez DEPUIS hors écran/invisible VERS la position CSS avec gsap.from() (dans les sous-compositions, préférez gsap.fromTo() pour que l'état de départ soit explicite ; voir hyperframes-core/references/sub-compositions.md). La position CSS est la vérité de base ; la transition est le chemin pour y parvenir.
  2. Les sorties sont gérées par les transitions — selon les règles de transition de scène dans hyperframes-animation/transitions/, seule la dernière scène anime les éléments en sortie ; entre les scènes, la transition EST la sortie.

Espace partagé dans le temps : si l'élément A sort avant que l'élément B n'entre dans la même zone, les deux ont toujours besoin de positions CSS correctes pour leurs images clés respectives — l'ordre chronologique les empêche de coexister, et l'étape de disposition détecte les chevauchements accidentels. Les lueurs/ombres superposées et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape consiste à détecter les collisions non intentionnelles (deux titres l'un sur l'autre, contenu sortant du cadre).

Construction — déléguez aux compétences de domaine

Ceci mappe la surface complète de la compétence (voir la description) à ses références — non exhaustif ; lorsqu'une intention n'est pas listée, acheminez via hyperframes-creative (aspect/ concept), hyperframes-animation (mouvement), hyperframes-core (contrat), hyperframes-media (audio/sous-titres). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.

Vous construisez…Lisez d'abord (dans l'ordre)
TOUJOURS — toute pièce non triviale, en plus de votre ligne d'intention ci-dessoushyperframes-creative/references/house-style.md + references/video-composition.md (également exigé à l'Étape 1 / HARD-GATE ; le détail du premier plan "produit, pas généré")
Typographie cinétique / orientée textehyperframes-animation/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Carte-titre / tiers inférieur / superposition / PiP / texte derrière le sujethyperframes-creative/references/composition-patterns.md + (pour le cadre centré/dimensionné) hyperframes-core → "La racine doit être dimensionnée"
Révélation de logo / marquehyperframes-animation/rules/svg-path-draw.md (dessin) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Données / statistiques / chiffreshyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md
Démo produit / application / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Audio-réactif / piloté par la musiquehyperframes-creative/references/audio-reactive.md (pré-extraire les bandes ; mapper au mouvement)
Narré / voix off / sous-titres / légendeshyperframes-media (tts, transcribe, création de sous-titres) → placer les assets via hyperframes-core
Multi-scènes / transitionshyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après l'aperçu — la recette GSAP est dans le catalogue)
Modulaire / sous-compositionshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Liste de vérification de sortie → hyperframes-cli

  • npx hyperframes lint et npx hyperframes validate réussissent (bloquer sur les résultats)
  • conformité au design vérifiée si un cahier des charges (frame.md / design.md) existe — liste de vérification dans hyperframes-creative/references/design-adherence.md
  • npx hyperframes inspect réussit, ou tout débordement est intentionnellement marqué
  • avertissements de contraste traités ; pour le travail multi-scènes, révisez la carte d'animation (hyperframes-animation/scripts/animation-map.mjs)
  • livrez l'aperçu ; ne rendez en MP4 que sur demande explicite
  • présentez l'aperçu uniquement à la livraison (c'est l'aperçu final stable) ; n'en affichez pas un en cours de construction — les instantanés de phase de construction sont sans tête (headless)

Pas ce workflow

  • Un produit / entreprise / SaaS / site web spécifique en cours de commercialisation, lancement ou promotion → /product-launch-video
  • Un concept / sujet / article / comment-X-fonctionne expliqué, sans produit → /faceless-explainer
  • Une PR GitHub / modification de code → /pr-to-video
  • Une vidéo existante avec une personne qui parle à laquelle ajouter des sous-titres → /embedded-captions
  • Le port d'une composition Remotion existante → /remotion-to-hyperframes
  • Le montage / l'édition d'un fichier vidéo fini comme un NLE → hors périmètre (HyperFrames compose du HTML et des médias dans une timeline déterministe ; il ne monte pas de séquences)

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

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

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