Communitygithub.com

Sma1lboy/rove

Le workflow de repli pour la création de compositions vidéo HyperFrames personnalisées, de toute durée ou format — pièces longues ou multi-scènes, bandes-annonces de marque / sizzle reels, montages, cartons-titres, boucles statiques et compositions libres. Indifférent à l'entrée et à la durée. Si un workflow spécialisé correspond clairement à l'entrée — un produit commercialisé, un site web, une explication d'un sujet, une PR GitHub, des images existantes, un court motion design ou un port Remotion — privilégiez-le (voir /hyperframes) ; utilisez celui-ci uniquement comme solution de repli général quand aucun ne correspond.

Qu'est-ce que rove ?

Ce skill agit comme le workflow par défaut pour la création de compositions vidéo personnalisées dans l'écosystème HyperFrames. Il est conçu pour les cas où aucun workflow spécialisé (explication de sujet, PR GitHub, images existantes, motion design court) ne correspond précisément à l'entrée. Le skill impose une approche rigoureuse : il commence par une phase de découverte pour les requêtes vagues, puis établit un système de design en lisant obligatoirement les références `house-style.md` et `video-composition.md` pour éviter les palettes de couleurs génériques et les compositions plates et centrées. Un 'HARD-GATE' vérifie que l'identité visuelle, un angle conceptuel, un choix de police justifié et un plan de densité avant-plan sont en place avant toute écriture HTML. L'approche 'Layout Before Animation' force la construction de l'état final (le moment le plus visible) en CSS statique avant d'ajouter le mouvement avec GSAP, garantissant ainsi que les chevauchements et les débordements sont détectés et corrigés tôt. Le skill s'appuie sur des références modulaires (design, motion, core) pour déléguer les aspects spécifiques comme la typographie cinétique, les transitions multi-scènes ou les démonstrations de produits, et se termine par une checklist de validation via la CLI `/hyperframes/cli`. Il fonctionne sur la plateforme HyperFrames et est particulièrement utile pour les projets vidéo qui nécessitent une flexibilité maximale sans être un cas d'usage spécialisé.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Sma1lboy/rove/tree/HEAD/.claude/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 — workflow vidéo général

Confirmez la voie avant de construire. Ceci est le repli pour la création de compositions personnalisées. Si l'entrée correspond clairement à un workflow spécialisé, privilégiez-le : explication de sujet → /faceless-explainer ; PR GitHub → /pr-to-video ; images existantes → /embedded-captions · /talking-head-recut ; court motion design non narré → /motion-graphics. Hors périmètre : données en direct / au moment du rendu, montage de type NLE d'une vidéo terminée, ou production d'images que HyperFrames ne peut pas capturer. En cas de doute ? Lisez /hyperframes d'abord.

Construisez exactement ce qui a été demandé. Un carton-titre est un carton-titre — pas un carton-titre + trois scènes secondaires + légendes. Si des scènes ou éléments supplémentaires amélioreraient vraiment 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 — requêtes ouvertes uniquement

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

  • Public — qui regarde ? développeurs / cadres / consommateurs grand public ?
  • Plateforme — où est-ce diffusé ? réseaux sociaux (15s) / site web hero / démo produit / interne ?
  • Priorité — qu'est-ce qui compte le plus ? 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 (« ajoute un carton-titre », « corrige le timing de la scène 3 »), sautez la découverte.

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

Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges de 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-design/references/house-style.md ET hyperframes-design/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étails de premier plan (barres de données, marques d'enregistrement, métadonnées monospace, « 8 à 10 éléments, dont deux que l'utilisateur n'a pas demandés ») qui séparent le « produit » du « généré ». Lire 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 une sortie plate, centrée et ressemblant à une page web. N'inventez pas vous-même une palette et ne sautez pas ces lectures ; passer par hyperframes-design est obligatoire ici, pas une branche facultative. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.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-t-il ? Par exemple, un outil de cybersécurité → portes de coffre / lignes de balayage périmétrique / garnitures de serrure ; une application de méditation → marée, souffle, douce éclosion de lumière. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'une retouche littérale. C'est le substitut économique à l'expansion de l'invite (Étape 2) pour les pièces à une seule scène, où l'expansion est correctement ignorée — et c'est la différence entre un concept conçu et un logo générique sur un dégradé.

Étape 2 — Expansion de l'invite → hyperframes-design

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

Étape 3 — Planifier

Avant d'écrire le HTML, réfléchissez à un niveau élevé :

  1. Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
  2. Structure — combien de compositions, sous-comp vs en ligne, quelles pistes portent la vidéo / les incrustations / les légendes. Pour l'appel entre fichier monolithique unique vs modulaire, voir /hyperframes/core/references/composition-patterns.md § Two Architectures (règle empirique : ≥3 cuts de scène durs, ou toute scène réutilisée → modulariser ; une pièce courte à scène unique reste un seul fichier).
  3. Rythme — nommez le motif avant de l'implémenter (par ex. fast-fast-SLOW-SHADER-hold) ; voir hyperframes-design/references/beat-direction.md.
  4. Timing — quels clips déterminent la durée, où se situent les transitions, le rythme.
  5. Mise en page — construisez d'abord l'état final (voir ci-dessous).
  6. Animer — ajoutez ensuite le mouvement via hyperframes-motion.

Mise en page avant l'animation

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

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

  1. Identifiez l'image héroïque pour chaque scène — le moment où le plus d'éléments sont simultanément visibles. C'est la mise en page 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 haut que l'espace. Réservez le positionnement absolu aux éléments décoratifs.

⚠ Les width/height: 100% ci-dessus ne fonctionnent que si chaque ancêtre a une hauteur résolue. 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 → « Root must be sized »). Ignorez cela et le conteneur flex s'effondre à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est coupé à x=0 — tandis que lint/inspect signalent encore 0 problème. Et conservez toujours le padding (≥80px) sur .scene-content : c'est la marge de sécurité du carton-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ébut soit explicite ; voir /hyperframes/core/references/sub-compositions.md). La position CSS est la vérité de référence ; l'interpolation est le voyage vers elle.
  2. Les sorties sont gérées par les transitions — conformément aux règles de transition de scène dans hyperframes-motion/transitions/, seule la dernière scène anime les éléments vers l'extérieur ; 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 héroïques respectives — l'ordre chronologique les empêche de coexister, et l'étape de mise en page détecte le chevauchement accidentel. Les lueurs/superpositions en couches et la profondeur en z-stack sont un chevauchement intentionnel ; l'étape vise à 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 cartographie la surface complète du skill (voir la description) vers ses références — non exhaustive ; lorsqu'une intention n'est pas listée, acheminez via hyperframes-design (aspect/concept), hyperframes-motion (mouvement), /hyperframes/core (contrat). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.

Construction…Lisez d'abord (dans l'ordre)
TOUJOURS — chaque pièce non triviale, en plus de votre ligne d'intention ci-dessoushyperframes-design/references/house-style.md + references/video-composition.md (également conditionné à l'Étape 1 / HARD-GATE ; les détails de premier plan « produit, pas généré »)
Typographie cinétique / textuelhyperframes-motion/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Carton-titre / tiers inférieur / incrustation / PiP / texte derrière le sujethyperframes-design/references/composition-patterns.md + (pour le cadre centré/dimensionné) /hyperframes/core → « Root must be sized »
Révélation de logo / identité de marquehyperframes-motion/rules/svg-path-draw.md (dessin) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md
Données / statistiques / chiffreshyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md
Démo produit / application / UIhyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Multi-scènes / transitionshyperframes-motion/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après la vue d'ensemble — la recette GSAP est dans le catalogue)
Modulaire / sous-compositions/hyperframes/core/references/composition-patterns.md + references/sub-compositions.md

Liste de contrôle 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 contrôle dans hyperframes-design/references/design-adherence.md
  • npx hyperframes inspect réussit, ou chaque débordement est intentionnellement marqué
  • avertissements de contraste traités ; pour un travail multi-scènes, examinez la carte d'animation (hyperframes-motion/scripts/animation-map.mjs)
  • livrez l'aperçu ; rendez au format MP4 uniquement sur demande explicite
  • montrez l'aperçu uniquement à la remise (c'est l'aperçu final stable) ; n'en affichez pas un en cours de construction — les instantanés de la phase de construction sont sans tête

Individual skills in this repo

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

Sma1lboy/rove

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, 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`).

Sma1lboy/rove

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class=\"clip\"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Sma1lboy/rove

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

Sma1lboy/rove

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.

Sma1lboy/rove

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).

Sma1lboy/rove

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames topic guides, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

Sma1lboy/rove

Best practices for Remotion - Video creation in React

Skills associés