Communitygithub.com

1345AbhishekKumar/starter-nextjs

Capturez un site web / une URL générale et transformez-la en vidéo HyperFrames (visite guidée, présentation ou clip social à partir des propres visuels du site). Utilise des captures d'écran headless Chrome + des éléments de marque. À utiliser lorsque l'intention est générale — portfolio/blog/landing page ou clip social. PAS pour : lancement de produit/SaaS ou promotion (→ /product-launch-video, même depuis une URL) ; vidéo explicative sans site (→ /faceless-explainer) ; PR GitHub (→ /pr-to-video) ; ajout de sous-titres à une vidéo existante (→ /embedded-captions) ; court motion graphic sans narration (→ /motion-graphics). En cas de doute entre lancement et site général ? Posez une question ou commencez par /hyperframes.

Qu'est-ce que starter-nextjs ?

Cette compétence pour agent IA convertit une URL de site web général en une vidéo professionnelle de type HyperFrames : visite guidée, showcase ou clip social pour les réseaux. Elle s'appuie sur une architecture en 7 étapes, de la capture du site à la livraison, avec des points de validation clés. Elle utilise des captures d'écran headless Chrome et des assets de marque extraits pour construire des compositions animées. Destinée aux développeurs et créateurs, elle fonctionne sur les plateformes Claude Code et HyperFrames. Son avantage principal est de produire automatiquement une vidéo de qualité professionnelle à partir d'un simple site web, sans compétences en montage vidéo. Le flux inclut la capture du site, l'analyse de l'identité de marque, la création d'un storyboard, la génération de voix off, et la validation finale. Le mode autonome permet de sauter les questions de préférence utilisateur mais pas les étapes de vérification qualité.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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 du catalogue HeyGen. Exécutez d'abord --adopt 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 le chemin 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 / du lancement / de la promotion d'un produit (même depuis cette URL, même "promo pour notre site") → /product-launch-video. Un sujet explicatif sans site → /faceless-explainer ; une PR GitHub → /pr-to-video ; recouper / recolorer / réordonner un fichier vidéo existant → hors du cadre. Aiguillé ici pour une demande vague "faire une vidéo", ou incertain entre lancement et site général ? Lisez d'abord /hyperframes (table de routage complète + § Ce que HyperFrames ne peut pas faire).

Les utilisateurs disent des choses comme :

  • "Transforme ce site web en clip social de 15 secondes pour Instagram"
  • "Fais une visite guidée / présentation de site de 30 secondes depuis 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 jalons marqués 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les jalons 💬 de préférence utilisateur sont ignorés ; voir step-2-brief.md pour savoir comment cela se propage.

Le mode autonome n'est PAS "ignorer tous les jalons". Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accentuation des couleurs, nombre de temps, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les jalons de vérification qualité. Les points suivants restent non sautables en mode auto :

  • Audit des assets (Étape 3) — visualiser les planches contact et justifier UTILISER/IGNORER pour chaque asset
  • Lecture HTML par temps (Étape 5) — bloc de preuve structuré par temps
  • Checklist DoD (Étape 6) — y compris la map 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 auto dit de favoriser l'action, donc je vais sauter X" — et X est un jalon de vérification, pas une question de préférence — ce raisonnement est erroné. 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 sont une boîte à outils de marque pour plus tard, pas les blocs de construction de la vidéo.

Affichez le statut de connexion avant le brief — exécutez npx hyperframes auth status et retransmettez sa sortie textuellement (ne paraphrasez pas et ne réécrivez pas). Il indique si la voix/BGM utilisera les moteurs HeyGen ou locaux et, lorsque non 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 ; n'intégrez 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 le statut et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les instructions canoniques.

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


Étape 1 : Identité de Marque

Lisez : references/step-1-design.md

Écrivez DESIGN.md — une antisèche 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 de rapidité : Pour les vidéos au rythme rapide (panneau par temps), DESIGN.md peut être un résumé de 50 lignes sur les couleurs + polices + à faire/à ne pas faire — pas un document de 300 lignes. Le prompt de sous-agent à l'Étape 5 colle directement les valeurs de marque, donc la profondeur de DESIGN.md n'importe que pour les compositions complexes.

Jalon : 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 de visuels ou d'assets. Analysez le prompt de l'utilisateur — il vous a probablement déjà donné le type et le style de vidéo. Demandez seulement ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif, et le public.

Jalon : Le type de vidéo, la durée, le format, et — de manière critique — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard axé sur le concept.


Étape 3 : Storyboard et Script 💬

Lisez : references/step-3-storyboard.md

Écrivez le storyboard en priorisant le concept : message → arc narratif → temps qui servent l'arc → techniques par temps → passage des accents de marque à la fin. Ensuite, écrivez le script de narration correspondant. Présentez les deux à l'utilisateur avec un résumé temps par temps. Itérez jusqu'à approbation.

Jalon : 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 indique 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 horodatages aux temps. Demandez ensuite pour les sous-titres.

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


Étape 5 : Construction des 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 leur rapport.

Jalon : 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 : Validation et Livraison

Lisez : references/step-6-validate.md

Lintez, validez, prenez des instantanés à l'échelle de la durée de la vidéo (formule : max(temps × 3, ceil(durée_secondes / 2))), et examinez chacun d'eux. 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. Présentez cette URL Studio uniquement à la remise — c'est l'aperçu final et stable ; les instantanés de la phase de construction sont headless, donc ne faites pas apparaître d'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.

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


Référence Rapide

Types de Vidéos

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

TypeDurée typiqueFacteur de duréeNarration
Publicité sociale (IG/TikTok)10–15sLimite de la plateformeOptionnelle
Démo produit30–60sLongueur du scriptNarration complète
Annonce de fonctionnalité15–30sComplexité de la fonctionnalitéNarration complète
Vidéo de marque20–45sPiste musicaleOptionnelle, focus musique
Teaser de lancement10–20sÉnergie de l'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 nécessiter 5 temps bien rythmés. Une vidéo de marque avec une seule thèse visuelle forte pourrait n'en nécessiter que 3.

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 DESIGN.md (5 sections, 250-350 lignes ; 50 lignes en mode rapide pour les publicités sociales de type panneau)
step-2-brief.mdÉtape 2 — s'aligner sur le message, l'arc narratif, le public avec l'utilisateur
capabilities.mdÉtapes 2 & 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourez la TdM pendant le brief, plongez dans les sections spécifiques pendant la construction
step-3-storyboard.mdÉtape 3 — storyboard + script (combinés) avec jalon 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, instantanés (à l'échelle de la durée vidéo), aperçu
techniques.mdÉtapes 3 & 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 13 individual skills — each has its own dedicated page.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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.

1345AbhishekKumar/starter-nextjs

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

1345AbhishekKumar/starter-nextjs

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