Communitygithub.com

1345AbhishekKumar/starter-supabase

Workflow de repli pour créer des compositions vidéo HyperFrames personnalisées de toute longueur ou format — pièces longues ou multi-scènes, bandes-annonces de marque / sizzle reels, montages, cartes-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, une explication de sujet, une PR GitHub, des images existantes, un court motion graphic ou un portage Remotion — privilégiez-le (voir /hyperframes) ; utilisez celui-ci uniquement comme repli général lorsque aucun ne correspond.

Qu'est-ce que starter-supabase ?

Ce skill est le workflow de repli général pour la création de compositions vidéo personnalisées avec HyperFrames. Il prend en charge des pièces de toute longueur et de tout format, y compris des vidéos longues, des montages multi-scènes et des compositions libres. Il est conçu pour être utilisé lorsque des workflows spécialisés (comme /product-launch-video ou /website-to-video) ne conviennent pas. Le skill guide l'utilisateur à travers une approche structurée : découverte pour les demandes vagues, établissement d'un système de design via `hyperframes-creative`, expansion de prompt pour les compositions multi-scènes, planification complète, et construction en séparant la mise en page de l'animation. Il insiste sur la nécessité de lire les fichiers de référence critiques (`house-style.md` et `video-composition.md`) pour garantir des résultats de qualité professionnelle. Le skill s'intègre également au moteur audio partagé `hyperframes-media` pour la synthèse vocale, la musique de fond et les effets sonores, et fournit une liste de vérification pour le rendu final.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/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 l'audio/les images, appelez /media-use pour résoudre la BGM/SFX/les images à partir du catalogue HeyGen. Exécutez --adopt d'abord pour enregistrer les actifs existants. 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 web général → /website-to-video ; explication de sujet → /faceless-explainer ; PR GitHub → /pr-to-video ; images existantes → /embedded-captions · /talking-head-recut ; court motion graphic sans narration → /motion-graphics ; portage Remotion → /remotion-to-hyperframes. Hors de portée : données en direct/au moment du rendu, montage de type NLE d'une vidéo terminée, ou production d'images 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 vraiment la pièce, proposez-les ; ne les ajoutez pas silencieusement. 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 ("faites quelque chose pour notre marque", "une intro cool") — comprenez l'intention avant de choisir les couleurs :

  • Audience — qui regarde ? développeurs / dirigeants / consommateurs généraux ?
  • Plateforme — où est-ce diffusé ? social (15s) / page d'accueil de 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 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'approche "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étail au premier plan (barres de données, marques d'enregistrement, métadonnées en police monospace, "8-10 éléments, deux que l'utilisateur n'a pas demandés") qui séparent le "produit" du "généré." Lire 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 tout seul et ne sautez pas ces fichiers ; passer dans hyperframes-creative est obligatoire ici, pas une option. De là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, selon le besoin. 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 / gorges de serrure ; une application 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 d'invite (É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 d'invite → hyperframes-creative

À exécuter pour toute composition multi-scènes (sauter 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 le 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 portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la décision fichier monolithique unique vs sous-comp modulaire, voir hyperframes-core/references/composition-patterns.md § Deux architectures (règle empirique : ≥3 coupures de scène nettes, ou toute scène réutilisée → modulariser ; une courte pièce à scène unique reste en un seul fichier).
  3. Rythme — nommez le pattern avant d'implémenter (par exemple fast-fast-SLOW-SHADER-hold) ; voir hyperframes-creative/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-animation.

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 sortie. É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 les animez jusqu'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 résolvez les problèmes de mise en page avant d'ajouter du mouvement.

  1. Identifiez le cadre 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 ce cadre. Le conteneur de contenu doit remplir la scène avec un remplissage, pas des décalages absolus :
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px; /* le remplissage 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 grand 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 toute enveloppe entre elle et .scene-content doivent être dimensionnées (position: relative; width: 1920px; height: 1080px sur la racine — voir hyperframes-core → "La racine doit être dimensionnée"). Si vous sautez cela, 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 toujours 0 problèmes. Et gardez toujours le padding (≥80px) sur .scene-content : c'est la marge de sécurité du 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é 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 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 cadres héroïques respectifs — l'ordre chronologique les empêche de coexister, et l'étape de mise en page détecte les chevauchements accidentels. Les lueurs/ombres 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 débordant du cadre).

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

Ceci cartographie 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'une ou l'autre.

Construction…À lire en premier (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 conditionné à l'Étape 1 / HARD-GATE ; les détails de premier plan "produits, pas générés")
Typographie cinétique / axée sur le textehyperframes-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 de produit / application / UIhyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md
Réactif à l'audio / piloté par la musiquehyperframes-creative/references/audio-reactive.md (pré-extraire les bandes ; mapper au mouvement)
Narration / 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 actifs 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 l'aperçu — la recette GSAP est dans le catalogue)
Modulaire / sous-compositionshyperframes-core/references/composition-patterns.md + references/sub-compositions.md

Audio : un 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 une carte-titre). Ne bricolez pas de TTS ni ne faites appel à un fournisseur avec une copie : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement sur un interrupteur — informations d'identification HeyGen présentes → TTS HeyGen + récupération de musique/SFX ; absentes → TTS ElevenLabs/Kokoro, génération de BGM Lyria/MusicGen, et la bibliothèque SFX groupée. Liste complète des drapeaux + schéma 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 (lie audio_meta en retour)
{
  "lines": [
    { "id": "s1", "text": "Votre ligne d'ouverture.", "sfx": ["whoosh"] },
    { "id": "s2", "text": "Le prochain temps fort." },
  ],
  "bgm": { "query": "calme cinématographique soutien" }, // 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 (sibling 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[]) en tant que pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + création de sous-titres). Si la BGM a suivi le chemin de 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

…

[La suite a été tronquée pour la traduction]

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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-supabase

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