Communitygithub.com

1345AbhishekKumar/starter-nextjs

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, montages, cartes-titres, boucles statiques et compositions libres. Sans contrainte de format ou de durée. Si un workflow spécialisé correspond clairement à l'entrée, privilégiez-le ; n'utilisez celui-ci que comme solution de repli.

Qu'est-ce que starter-nextjs ?

Ce kit de compétences (skill) sert de workflow général de repli pour la création de compositions vidéo personnalisées avec HyperFrames. Son objectif principal est de guider l'agent IA dans la construction de vidéos de toutes sortes, de la simple carte-titre à la composition multi-scènes complexe. L'utilisateur est invité à utiliser des workflows spécialisés lorsqu'ils sont plus adaptés. Le processus créatif est structuré en plusieurs étapes : découverte, établissement d'une identité visuelle via les règles de style de `hyperframes-creative`, expansion du prompt, et une phase de planification détaillée (couvrant le récit, la structure, le rythme, le timing et la mise en page). Une règle fondamentale est de construire la mise en page finale (état statique) avant d'ajouter toute animation, évitant ainsi les chevauchements involontaires. Le skill délègue ensuite des aspects spécifiques (typographie cinétique, animation, audio, transitions) à des sous-compétences spécialisées, et fournit des instructions précises pour intégrer le moteur audio (TTS, BGM, SFX) via `hyperframes-media`. Il est compatible avec Claude Code, Cursor et d'autres outils utilisant des skills.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-nextjs/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

media-use : Avant de sourcer des audios/images, appelez /media-use pour trouver de la musique de fond, des effets sonores et des images depuis le 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 workflow de 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 → /website-to-video ; explicatif d'un sujet → /faceless-explainer ; PR GitHub → /pr-to-video ; séquence existante → /embedded-captions · /talking-head-recut ; court motion graphic non narré → /motion-graphics ; portage Remotion → /remotion-to-hyperframes. Hors périmètre : données en direct / au moment du rendu, montage de type NLE d'une vidéo finie, ou production de séquences qu'HyperFrames ne peut pas capturer. Pas sûr ? 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 de soutien + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires amélioreraient réellement le résultat, 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 (« faites quelque chose pour notre marque », « une intro sympa ») — comprenez l'intention avant de choisir les couleurs :

  • Audience — qui regarde ? développeurs / dirigeants / consommateurs généraux ?
  • Plateforme — où est-ce diffusé ? réseaux sociaux (15s) / page d'accueil d'un site / démo produit / interne ?
  • Priorité — qu'est-ce qui compte le plus ? qualité du mouvement / précision 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'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étail du premier plan (barres de données, repères d'enregistrement, métadonnées en monospace, « 8-10 éléments, dont deux que l'utilisateur n'a pas demandés ») qui séparent le « produit » du « généré ». Ne lire qu'un seul 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 qui ressemble à une page web. N'inventez pas une palette tout seul en sautant ces étapes ; passer par hyperframes-creative est obligatoire ici, pas une branche optionnelle. À partir de là, récupérez é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/le 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-fort / lignes de balayage de périmètre / gâches de serrure ; une appli 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'une restylisation littérale. C'est le substitut peu coûteux à l'expansion de prompt (Étape 2) pour les pièces à scène unique, où l'expansion est correctement sauté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 chaque composition multi-scènes (sautez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges design + au style maison dans 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, 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 inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la question du fichier monolithique unique vs sous-comp modulaire, voir hyperframes-core/references/composition-patterns.md § Deux architectures (règle empirique : ≥3 coupes franches de scène, 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. rapide-rapide-LENT-SHADER-pause) ; voir hyperframes-creative/references/beat-direction.md.
  4. Timing — quels clips déterminent la durée, où se placent les transitions, le rythme.
  5. Mise en page — construisez d'abord l'état final (voir ci-dessous).
  6. Animer — puis ajoutez 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 sous forme de 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 les 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 verrez et corrigerez les problèmes de mise en page avant d'ajouter du mouvement.

  1. Identifiez l'image clé pour chaque scène — le moment où le plus grand nombre d'éléments sont simultanément visibles. C'est la mise en page que vous construisez.
  2. Écrivez du 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 toute taille de scène */
  gap: 24px;
  box-sizing: border-box;
}

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

⚠ Le width/height: 100% ci-dessus ne fonctionne 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 est rogné à x=0 — tandis que lint/inspect signalent toujours 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 JUSQU'À 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 ; l'interpolation est le voyage vers elle.
  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 scène finale 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 clés respectives — l'ordre chronologique les empêche de coexister, et l'étape de mise en page détecte les chevauchements accidentels. Les lueurs/ombres superposées et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape vise à détecter les collisions non intentionnelles (deux titres l'un sur l'autre, contenu débordant du cadre).

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

Ceci cartographie toute la surface 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.

Construction…Lire en premier (dans l'ordre)
TOUJOURS — chaque pièce non triviale, en plus de votre ligne d'intention ci-dessoushyperframes-creative/references/house-style.md + references/video-composition.md (également requis à l'Étape 1 / HARD-GATE ; le détail de 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
Carte-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) + 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 / musique / SFX / sous-titreshyperframes-media → le moteur audio partagé scripts/audio.mjs (un appel = TTS + BGM + SFX → audio_meta.json) ; production 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 après la vue d'ensemble — 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 demande (selon « construisez exactement ce qui a été demandé » — pas de musique d'ambiance sur une carte-titre). Ne créez pas de TTS artisanal ou ne passez pas par un fournisseur externe : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement sur un commutateur : présence d'informations d'identification HeyGen → récupération TTS + musique/SFX HeyGen ; absence → génération TTS ElevenLabs/Kokoro, BGM Lyria/MusicGen, et la bibliothèque SFX fournie. Liste complète des indicateurs + schéma de la demande/méta : le commentaire d'en-tête 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 phrase.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "Le prochain temps fort." },
  ],
  "bgm": { "query": "calme cinématographique sous-mesure" }, // omettez "mode" → auto (récupère si HeyGen, sinon génère) ; "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

Lisez ensuite audio_meta.json : montez chaque voices[].path + (bgm.path, sfx[]) en tant que pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + production de sous-titres). Si le BGM a emprunté la voie de la génération (bgm_pending: true), exécutez hyperframes-media/scripts/wait-bgm.mjs avant le rendu final.

Liste de vérification de sortie → hyperframes-cli

  • …

[…] tronqué pour la traduction]

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

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.

1345AbhishekKumar/starter-nextjs

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