Communitygithub.com

EvoFlow — Workflow vidéo général

Workflow de repli pour créer des compositions vidéo HyperFrames sur mesure, de toute durée ou format — pièces longues ou multi-scènes, bandes-annonces de marque, montages, cartons-titres, boucles statiques et compositions libres. Indépendant de l'entrée et de la durée. Si un workflow spécialisé correspond clairement à l'entrée — un produit commercialisé, un site web, un sujet explicatif, une PR GitHub, des images existantes, un court motion design ou un portage Remotion — privilégiez-le (voir /hyperframes) ; n'utilisez ceci que comme solution de repli général lorsqu'aucun ne correspond.

Qu'est-ce que EvoFlow — Workflow vidéo général ?

EvoFlow est le workflow de repli universel de l'écosystème HyperFrames pour la création de compositions vidéo personnalisées, développé par EvovexAI. Il est conçu pour prendre en charge toute entrée ou durée, et s'applique lorsque des workflows spécialisés (vidéo produit, vidéo de site, explication vidéo sans visage, PR vers vidéo, etc.) ne correspondent pas clairement à la demande. La compétence guide l'utilisateur à travers un processus en plusieurs étapes : découverte de l'intention pour les demandes vagues, établissement d'une identité visuelle via des références créatives (hyperframes-creative), expansion du prompt pour les compositions multi-scènes, puis planification de la structure, du rythme, du timing et de la mise en page avant l'animation. Elle insiste sur une règle stricte de « mise en page avant animation » pour éviter les collisions, et délègue les aspects techniques (animation, audio, sous-titres) à des compétences spécialisées comme hyperframes-animation et hyperframes-media. Elle est utile aux développeurs et créateurs qui souhaitent produire des vidéos dynamiques et professionnelles, tout en évitant les templates génériques.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/EvovexAI/EvoFlow/tree/HEAD/skills/public/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

media-use : Avant de sourcer des audios/images, appelez /media-use pour résoudre les BGM/SFX/images du catalogue HeyGen. Exécutez --adopt d'abord pour enregistrer les ressources existantes. Voir la compétence /media-use.

general-video — workflow vidéo général

Confirmez la route 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 : produit commercialisé → /product-launch-video ; site général → /general-video ; sujet explicatif → /faceless-explainer ; PR GitHub → /pr-to-video ; images existantes → /embedded-captions · /talking-head-recut ; court motion design sans narration → /motion-graphics ; portage Remotion → /remotion-to-hyperframes. Hors scope : données en direct / au rendu, édition de type NLE d'une vidéo terminée, ou production d'images que HyperFrames ne peut pas capturer. Incertain ? 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 d'appui + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires améliorent réellement 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 allez directement à la construction.

Approche

Découverte — demandes ouvertes uniquement

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

  • Public — qui regarde ? développeurs / cadres / consommateurs généraux ?
  • 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 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 un carton-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 ; considérez-le comme la vérité de la marque — couleurs exactes, polices, contraintes).

S'il n'y a pas de cahier des charges, vous DEVEZ lire LES DEUX 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 le prompt / générer du contenu réel », la liste des valeurs par défaut paresseuses et la recette des calques ; video-composition.md donne les règles de densité / échelle / détails au premier plan (barres de données, marques d'enregistrement, métadonnées mono, « 8-10 éléments, deux que l'utilisateur n'a pas demandés ») qui différencient « produit » de « généré ». Ne lire qu'un seul fichier est l'erreur la plus courante — video-composition.md est celui que les agents sautent, et c'est exactement celui qui empêche un rendu plat, centré et ressemblant à une page web. N'inventez pas une palette vous-même et ne les sautez pas ; passer par hyperframes-creative est obligatoire ici, pas une branche optionnelle. Ensuite, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, selon les besoins. 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 périmétrique / barillets de serrure ; une appli de méditation → marée, souffle, lente floraison de lumière. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'une restylisation littérale. C'est le substitut économique à l'expansion du prompt (É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 conçu et un logo générique sur un dégradé.

Étape 2 — Expansion du prompt → 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 design + style de la maison dans un intermédiaire cohérent que les travaux en aval lisent de la même manière. Voir hyperframes-creative/references/prompt-expansion.md.

Étape 3 — Planification

Avant d'écrire du HTML, réfléchissez à un haut niveau :

  1. Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
  2. Structure — combien de compositions, sous-comp vs inline, quelles pistes transportent la vidéo / l'audio / les superpositions / les sous-titres. Pour le choix fichier-monolithique-unique vs modulaire-sous-comp, voir hyperframes-core/references/composition-patterns.md § Deux Architectures (règle empirique : ≥3 coupes de scène franches, ou toute scène réutilisée → modulariser ; une courte pièce à scène unique reste un fichier).
  3. Rythme — nommez le modèle 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ù atterrissent 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-animation.

Mise en page avant 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 de GSAP encore.

Pourquoi : si vous positionnez les éléments à leur état de départ 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 du mouvement.

  1. Identifiez le plan 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 du CSS statique pour ce plan. Le conteneur de contenu doit remplir la scène avec du marging, 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 toute taille de scène */
  gap: 24px;
  box-sizing: border-box;
}

N'utilisez jamais position: absolute; top: Npx sur un conteneur de contenu — cela déborde lorsque le contenu est plus grand que l'espace. Réservez le positionnement absolu pour les é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 → « La racine doit être dimensionnée »). Sautez cette étape et le conteneur flex s'effondre à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe se coupe à x=0 — tandis que lint/inspect signalent toujours 0 problèmes. Et gardez 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épart soit explicite ; voir hyperframes-core/references/sub-compositions.md). La position CSS est la vérité fondamentale ; l'animation est le voyage qui y mène.
  2. Les sorties sont gérées par la transition — selon les règles de transition de scène dans hyperframes-animation/transitions/, seule la dernière scène anime les éléments vers la sortie ; entre les scènes, la transition EST la sortie.

Espace partagé dans le temps : si un élément A sort avant que l'élément B n'entre dans la même zone, les deux ont besoin de positions CSS correctes pour leurs plans héroïques respectifs — l'ordre dans la timeline les empêche de coexister, et l'étape de mise en page détecte les chevauchements accidentels. Les lueurs/shadows en couches et la profondeur en pile-z 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'un ou l'autre.

Construction…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 ; les détails du premier plan « produit, pas généré »)
Typographie cinétique / text-forwardhyperframes-animation/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md
Carton-titre / tiers inférieur / superposition / PiP / texte-derrière-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 progressif) + 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
Produit / appli / démo 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 / musique / SFX / sous-titreshyperframes-media → le moteur audio partagé scripts/audio.mjs (un appel = TTS + BGM + SFX → audio_meta.json) ; création de sous-titres + placement des ressources via hyperframes-core. Voir Audio ci-dessous.
Multi-scènes / transitionshyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini avec l'aperçu — la recette GSAP est dans le catalogue)
Modulaire / sous-compositionshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio : un seul moteur (TTS · BGM · SFX)

Uniquement lorsque la pièce le nécessite (selon « construisez exactement ce qui a été demandé » — pas de musique d'ambiance sur un carton-titre). Ne bidouillez pas de TTS maison ou ne copiez pas de fournisseur : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement sur un interrupteur — crédentiel HeyGen présent → HeyGen TTS + récupération musique/SFX ; absent → génération TTS ElevenLabs/Kokoro, génération BGM Lyria/MusicGen, et la bibliothèque SFX intégrée. Liste complète des indicateurs + schéma requête/méta : l'en-tête de commentaire de hyperframes-media/scripts/audio.mjs.

// audio_request.json — une ligne par segment narré ; `id` est le vôtre (relie audio_meta)
{
  "lines": [
    { "id": "s1", "text": "Votre première ligne.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "Le prochain battement." },
  ],
  "bgm": { "query": "calm cinematic underscore" }, // omettre "mode" → auto (récupérer si HeyGen, sinon générer) ; "none" pour désactiver
}
# <MEDIA_DIR> = le répertoire de la compétence hyperframes-media installée (voisin de cette compétence)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json

Ensuite, lisez audio_meta.json : montez chaque voices[].path + (bgm.path, sfx[]) comme pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + création de sous-titres). Si BGM a pris le chemin de génération (bgm_pending: true), exécutez hyperframes-media/scripts/wait-bgm.mjs avant le rendu final.

Liste de contrôle de sortie → hyperframes-cli

  • …

[truncated for translation]

Individual skills in this repo

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

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

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 domain skills, 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.

EvovexAI/EvoFlow

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (general-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

EvovexAI/EvoFlow

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

EvovexAI/EvoFlow

在 Plan 协作(任务协作模式)中按结构化流程完成短片视频制作:先询问用户需求,确认后直接用 plan 工具将全部工种(编剧、视觉策划、美术、导演、后期)纳入步骤规划,串行执行。

EvovexAI/EvoFlow

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

EvovexAI/EvoFlow

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /general-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

本地文字转语音,使用sherpa-onnx(离线,无需云端)。当需要离线语音合成时使用。

Skills associés