Communitygithub.com

Aseel1600/Edit01 — Site Web vers HyperFrames

Capture un site web général et transforme-le en vidéo HyperFrames (visite guidée, démonstration, ou clip social à partir des visuels du site). Utilise des captures d'écran Chrome headless + les assets de la marque.

Qu'est-ce que Edit01 — Site Web vers HyperFrames ?

Cette compétence permet de transformer n'importe quel site web général (portfolio, blog, landing page) en une vidéo professionnelle via la plateforme HyperFrames. Elle fonctionne en 7 étapes séquentielles : capture du site et analyse de la marque, définition de l'identité visuelle (DESIGN.md), alignement stratégique avec l'utilisateur, création du storyboard et du script, génération de la voix-off et des sous-titres, construction des compositions animées, et enfin validation et livraison. Chaque étape produit un artefact qui conditionne le passage à la suivante, avec des portes de validation collaboratives. La compétence prend en charge les modes autonome (décisions de préférence automatiques) et manuel (validation utilisateur à chaque étape critique). Elle est particulièrement utile pour les créateurs de contenu, marketeurs et développeurs souhaitant produire rapidement des vidéos de qualité à partir de sites existants, sans compétences en montage vidéo.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aseel1600/Edit01/tree/HEAD/.agents/skills/website-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

media-use : Avant de sourcer des fichiers audio/images, appelez /media-use pour résoudre les BGM/SFX/images à partir du catalogue HeyGen. Exécutez --adopt d'abord pour enregistrer les assets existants. Voir la compétence /media-use.

Site Web vers HyperFrames

Capturez un site web, puis produisez une vidéo professionnelle à partir de celui-ci.

Confirmez la route avant l'Étape 0. Cette compétence crée une vidéo d' / à partir d'un site général. Si l'utilisateur fait vraiment du marketing / lancement / promotion d'un produit (même à partir de cette URL, même "promo pour notre site") → /product-launch-video. Un explicateur de sujet sans site → /faceless-explainer ; une PR GitHub → /pr-to-video ; re-découpage / re-coloration / réorganisation d'un fichier vidéo existant → hors périmètre. Routé ici sur un vague "fais une vidéo", ou incertain entre lancement et site général ? Lisez /hyperframes d'abord (table de routage complète + § Ce que HyperFrames ne peut pas faire).

Les utilisateurs disent des choses comme :

  • « Transforme ce site en clip social de 15 secondes pour Instagram »
  • « Fais une visite guidée / démonstration de 30 secondes à partir de https://... »
  • « Capture notre page d'accueil et construis une vidéo à partir de ses propres visuels »

Le flux de travail comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les portes marquées 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome (« décide pour moi », « surprends-moi »), les portes de préférence utilisateur 💬 sont ignorées ; voir step-2-brief.md pour la propagation.

Le mode autonome NE signifie PAS « ignorer toutes les portes. » Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accent de couleur, nombre de temps, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les portes de vérification de qualité. Les éléments suivants restent non ignorables en mode automatique :

  • Audit des assets (Étape 3) — visualiser les planches contact et justifier UTILISER/IGNORER pour chaque asset
  • Lecture HTML par temps (Étape 5) — bloc de preuves structuré par temps
  • Checklist DoD (Étape 6) — y compris la carte d'animation, la vérification WCAG par avertissement, la lecture audio/mouvement
  • Section de divulgation honnête (Étape 6) — « Ce que je n'ai PAS vérifié » doit apparaître dans votre résumé final

Si vous vous surprenez à raisonner « le mode automatique dit de favoriser l'action, donc je vais sauter X » — et X est une porte de vérification, pas une question de préférence — ce raisonnement est faux. Favoriser l'action s'applique à décider quoi construire, pas à décider s'il faut vérifier.


Étape 0 : Capture et Compréhension de la Marque

Lisez : references/step-0-capture.md

Capturez le site, puis lisez les données extraites pour comprendre la marque et le produit — ce qu'il fait, à qui il s'adresse, dans quelle voix il parle, dans quelle ambiance il vit. Les assets capturés constituent une boîte à outils de marque pour plus tard, pas les éléments de base à partir desquels la vidéo est fabriquée.

Affichez l'état de connexion avant le brief — exécutez npx hyperframes auth status et relayez sa sortie textuellement (ne paraphrasez ni ne réécrivez pas). Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, quand il n'est pas connecté, comment se connecter. Si non connecté, ARRÊTEZ et attendez que l'utilisateur choisisse — se connecter, ou dire « go »/« offline » pour continuer avec les moteurs locaux — avant de demander le brief ou quoi que ce soit d'autre. Traitez-le comme un véritable point de décision, pas une note passagère ; ne fusionnez pas le choix dans la question du brief, et n'écrivez pas de clés dans un .env par dépôt. (En mode autonome, notez l'état et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les instructions canoniques.

Porte : Résumé du site imprimé — d'abord la stratégie (ce que fait le produit, à qui il s'adresse, voix de la marque) avant l'inventaire des assets / couleurs / polices ; l'état de connexion a été affiché (connecté, ou continuation hors ligne).


Étape 1 : Identité de Marque

Lisez : references/step-1-design.md

Écrivez DESIGN.md — une fiche de référence de marque couvrant l'identité visuelle : couleurs, typographie, styles de composants, principes de mise en page. Utilisez design-styles.json pour les valeurs calculées exactes.

Option rapide : Pour les vidéos au rythme rapide (panneau d'affichage par temps), DESIGN.md peut être un résumé de 50 lignes des couleurs + polices + à faire / à ne pas faire — pas un document de 300 lignes. L'invite du sous-agent à l'Étape 5 colle directement les valeurs de la marque, donc la profondeur de DESIGN.md n'a d'importance que pour les compositions complexes.

Porte : DESIGN.md existe (n'importe quelle longueur) avec au minimum : palette de couleurs, choix de polices, et à faire / à ne pas faire.


Étape 2 : Stratégie et Message

Lisez : references/step-2-brief.md, references/capabilities.md (parcourez la Table des Matières — sections approfondies seulement si nécessaire)

Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler des visuels ou des assets. Analysez l'invite de l'utilisateur — il vous a probablement déjà donné le type et le style de vidéo. Ne demandez que ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif, et le public.

Porte : Le type de vidéo, la durée, le format, et — de manière cruciale — le message et l'arc narratif sont verrouillés. Sans eux, l'Étape 3 ne peut pas écrire un storyboard conceptuel.


Étape 3 : Storyboard + Script 💬

Lisez : references/step-3-storyboard.md

Écrivez le storyboard conceptuel en premier : message → arc narratif → temps qui servent l'arc → techniques par temps → accents de marque à la fin. Écrivez ensuite le script de narration pour correspondre. Présentez les deux à l'utilisateur avec un résumé temps par temps. Itérez jusqu'à ce qu'il approuve.

Porte : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.


Étape 4 : VO, Timing et Sous-titres 💬

Lisez : references/step-4-vo.md

Si l'Étape 2 a dit pas de narration — demandez pour la musique de fond, puis passez à l'Étape 5. Sinon : demandez à l'utilisateur quel fournisseur TTS (HeyGen TTS, ElevenLabs ou Kokoro), générez l'audio, transcrivez, mappez les timestamps aux temps. Demandez ensuite pour les sous-titres.

Porte : Soit (a) aucune narration n'a été demandée et le storyboard a des timings de temps manuels, soit (b) narration.wav + transcript.json existent et les timings des temps sont mis à jour avec les durées réelles.


Étape 5 : Construire les Compositions

Lisez : La compétence hyperframes (chargez-la — chaque règle compte) Lisez : references/step-5-build.md

Construisez index.html et les compositions en suivant l'architecture et le rythme choisis dans le storyboard (Étape 3). Les sous-agents exécutent hyperframes lint et hyperframes snapshot sur chaque temps avant de faire rapport.

Porte : Chaque compositions/beat-N.html a été lu de haut en bas par l'agent principal par rapport à DESIGN.md et STORYBOARD.md. La checklist par temps se trouve dans step-5-build.md.


Étape 6 : Valider et Livrer

Lisez : references/step-6-validate.md

Lintez, validez, prenez des captures d'écran dimensionnées à la durée de la vidéo (formule : max(temps × 3, ceil(durée_secondes / 2))), et examinez chacune. Corrigez les problèmes avant de livrer. Livrez l'URL du projet Studio localhost — ne rendez en MP4 que sur demande explicite de l'utilisateur. Affichez cette URL Studio uniquement au moment de la remise — c'est l'aperçu final et stable ; les captures d'écran de la phase de construction sont headless, donc ne faites pas apparaître un aperçu en cours de construction.

Livrez quelque chose dont vous êtes fier. Avant de remettre, demandez-vous : est-ce que je publierais ceci sur les réseaux sociaux avec mon nom ? Si non, corrigez ce qui ne va pas.

Porte : npx hyperframes lint et npx hyperframes validate passent avec zéro erreur, et la réponse finale inclut l'URL du projet Studio actif.


Référence Rapide

Types de Vidéo

Contraintes typiques par type de vidéo — utilisez comme point de départ, pas comme formule. Le nombre de temps doit découler du contenu et de la narration, pas d'une plage cible.

TypeDurée typiqueMoteur de duréeNarration
Publicité sociale (IG/TikTok)10–15sLimite de la plateformeOptionnelle
Démonstration produit30–60sLongueur du scriptNarration complète
Annonce de fonctionnalité15–30sComplexité de la fonctionnalitéNarration complète
Bande-annonce de marque20–45sPiste musicaleOptionnelle, focus musique
Teaser de lancement10–20sÉnergie d'accrocheMinimale

Le nombre de temps n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de « publicité sociale = 3-4 temps. » Une publicité sociale pour un produit complexe pourrait avoir besoin de 5 temps bien chronométrés. Une bande-annonce de marque avec une thèse visuelle forte pourrait avoir besoin de 3 temps.

Format

  • Paysage : 1920x1080 (par défaut)
  • Portrait : 1080x1920 (Instagram Stories, TikTok)
  • Carré : 1080x1080 (fil Instagram)

Fichiers de Référence

FichierQuand le lire
step-0-capture.mdÉtape 0 — capturer, comprendre la marque et le produit, écrire un résumé du site d'abord stratégique
step-1-design.mdÉtape 1 — écrire la fiche de référence de marque DESIGN.md (5 sections, 250-350 lignes ; chemin rapide de 50 lignes pour les publicités sociales de type panneau d'affichage)
step-2-brief.mdÉtape 2 — s'aligner sur le message, l'arc narratif, le public avec l'utilisateur
capabilities.mdÉtapes 2 et 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourez la TOC pendant le brief, plongez dans les sections spécifiques pendant la construction
step-3-storyboard.mdÉtape 3 — storyboard + script (combinés) avec porte de révision utilisateur
step-4-vo.mdÉtape 4 — choix du fournisseur TTS, génération, timing
step-5-build.mdÉtape 5 — construire index.html + compositions
step-6-validate.mdÉtape 6 — linter, valider, captures d'écran (dimensionnées à la durée de la vidéo), aperçu
techniques.mdÉtapes 3 et 5 — 13 techniques d'animation primitives avec patrons de code (adaptez, ne copiez-collez pas)
html-in-canvas-patterns.mdÉtape 5 — patrons de code complets pour les effets HTML dans Canvas (vit dans la compétence hyperframes)

Individual skills in this repo

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

Aseel1600/Edit01

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Aseel1600/Edit01

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Aseel1600/Edit01

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Aseel1600/Edit01

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Aseel1600/Edit01

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Aseel1600/Edit01

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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 (website-to-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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Aseel1600/Edit01

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.

Skills associés