Communitygithub.com

1345AbhishekKumar/starter-supabase

Utilisez cette compétence lorsque l'utilisateur souhaite un court graphisme animé, axé sur le design, où le mouvement est le message : typographie cinétique, compteur de statistiques ou de chiffres, graphique/visualisation de données, logo sting, habillage de marque, tiers inférieur, interpellation, superposition sociale, titre/tweet/actualité animé, affiche animée ou mise en évidence rapide d'une page capturée. Généralement moins de 10 s et jusqu'à environ 30 s, sans arc narratif, voix off ou sujet en prise de vue réelle. Peut être rendu en MP4 ou en superposition transparente. Pas pour les pièces plus longues, multi-scènes, narrées ou de marque (utilisez general-video), les vidéos de sites Web narrés (website-to-video), les explications de sujets (faceless-explainer), les promotions de produits (product-launch-video), les vidéos RP (pr-to-video) ou les légendes sur des séquences existantes (embedded-captions). En cas de doute entre un court métrage axé sur le mouvement et un traitement plus long ou narré, voir /hyperframes.

Qu'est-ce que starter-supabase ?

Cette compétence est conçue pour créer des graphiques animés courts, axés sur le design, sans narration, où le mouvement est le message principal. Elle est idéale pour des productions rapides telles que la typographie cinétique, les compteurs de statistiques, les animations de données, les logos animés ou les habillages de marque, généralement d'une durée inférieure à 10 secondes et jusqu'à 30 secondes maximum. La compétence suit un flux de travail structuré : initialisation du projet, planification (y compris une décision initiale sur la nécessité d'une recherche), sourcing d'actifs (si nécessaire), conception autour des actifs disponibles, construction par réutilisation de blocs de catalogue, rendu vidéo (MP4 ou WebM/MOV pour les superpositions), et vérification avec une étape de réparation automatique. Elle prend en charge plusieurs catégories, divisées en celles qui ne nécessitent pas de recherche (le contenu est fourni par l'utilisateur) et celles qui sont pilotées par la recherche (comme les pages Web, les articles de presse, les tweets), et s'intègre à l'outil `hyperframes` sur macOS Apple Silicon ou Linux x64.

Compatible avec~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/motion-graphics

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

motion-graphics — entrée de répartition

Confirmez la route avant l'étape 0. Cette compétence réalise un graphisme animé court, axé sur le design et sans narration (le mouvement est le message ; ~moins de 10 s, pas de voix off). Un traitement plus long, multi-scènes ou narré → /general-video ; une vidéo narrée d'un site Web → /website-to-video ; une explication de sujet → /faceless-explainer ; une promotion de produit → /product-launch-video ; des légendes sur des séquences existantes → /embedded-captions. Hors de portée: données en direct / au moment du rendu, ou séquences qu'il ne peut pas capturer. Vous n'êtes pas sûr qu'il s'agisse d'un mouvement d'abord ou d'une narration ? Lisez /hyperframes en premier.

Un graphisme animé court et axé sur le design. D'abord les actifs : décidez de la stratégie d'actifs et trouvez le matériel réel avant de concevoir le plan, puis concevez le plan autour de ce que vous avez, puis composez en réutilisant les capacités du catalogue. Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'étape 0) ; tous les chemins ci-dessous sont relatifs à celui-ci.

PhaseExécutionArtefact principalFlux détaillé
initBashhyperframes.jsonÉtape 0
plansous-agent — décider de la recherche ? + classer + stratégie d'actifsshot-plan.json (brouillon : catégorie, requêtes asset_needs, brief)agents/director.md (Partie 1)
source ◇Bash — résolution media-use (ignorer si asset_needs est vide)assets/ + assets/index.mdphases/source/guide.md
designsous-agent — conception du plan autour des actifs résolusshot-plan.json (final : bloc(s) + disposition + mouvement + positions)agents/director.md (Partie 2)
buildsous-agent — composition priorisant la réutilisationcompositions/index.htmlagents/builder.md
renderBash — hyperframes render (MP4, ou --format webm/mov pour superposition)renders/video.mp4Étape 5
verifyBash — lint / inspect -> sous-agent de réparation en cas d'échec(correctifs sur place)agents/finalize.md

◇ source ne s'exécute que lorsque la catégorie choisie déclare des actifs. Les catégories de code/texte pures (par exemple kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.

Catégories — divisées par la décision de recherche

La première décision de plan est : cela nécessite-t-il une recherche ? Cette fourche divise les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories pilotées par la recherche, par le type de contenu que la recherche renvoie. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé vit dans references/motion-vocabulary.md (→ règles/plans hyperframes-animation + blocs de registre).

Catégories de formulaire — pas de recherche ; l'utilisateur fournit le contenu :

CatégorieIntentionS'appuie sur
kinetic-typeligne / citation / titre percutant, texte axé sur le mouvementblocs caption-* + règles d'animation
statun seul chiffre / compteur héroïque + anneauapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsgraphique à barres / lignes / circulaire / course / % à partir de donnéesbloc data-chart
logo-reveallogo sting / habillage de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres de nom / titre, interpellations, superpositions socialescaption-* + blocs de superposition du registre

Catégories pilotées par la recherche — recherchez d'abord, puis animez par type de contenu (chemin RWA) :

Contenu renvoyéCatégorieAnimation
page Web / lienwebpageAnimation de page Web / UI (défilement, révélation, curseur, interpellations)
article de pressenewsRévélation de titre + carte source + interpellations de faits clés
tweettweetCarte tweet animée
image / entitéasset-fusionLa géométrie de l'actif devient le graphique (fusion diégétique RWA)

Ordre de construction : un à la fois, priorité à la couverture (l'ébauche est acceptable). kinetic-type porté du prototype ; les autres suivent.

Prérequis

macOS Apple Silicon ou Linux x64. Outils système : brew install node ffmpeg. npx hyperframes doctor une fois. Rendu GPU macOS : export PRODUCER_BROWSER_GPU_MODE=hardware.

Clés optionnelles (fallbacks locaux si non définies) — nécessaires uniquement pour les catégories qui sourcent/génèrent des actifs via media-use :

CléUtilisé pourFallback
GEMINI_API_KEY / GOOGLE_API_KEYgénération d'images (résolution media-use)ignorer la génération / recherche uniquement
(fournisseurs asset_scout / recherche)recherche d'actifs réels webpage/news/tweet + asset-fusionla catégorie dégrade sans actifs

Flux

Étape 0 — Initialisation

Le répertoire de travail actuel est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet>: utilisez le répertoire donné par l'utilisateur, sinon un nom court en kebab-case à partir de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ou un horodatage.

Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si certaines sont obsolètes.

Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais de cd nu.

Étape 1 — Planification (sous-agent : Directeur Partie 1)

Déléguez un sous-agent. invite = agents/director.md complet + ## Contexte de répartition (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Il doit :

  1. Décider : cela nécessite-t-il une recherche ? (la première fourche)
    • Non → choisissez une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ; asset_needs: [].
    • Oui → émettez un plan de recherche dans asset_needs[] (presse / web / tweet / image ; requêtes bipolaires). La catégorie pilotée par la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu renvoyé à l'étape 2, et finalisée à l'étape 3.
  2. Écrivez un brouillon shot-plan.json (enveloppe + catégorie de formulaire choisie ou intention de recherche + asset_needs + un bref paragraphe de description du plan). Schéma : references/shot-plan-ir.md.

Validation : [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.

Étape 2 — Sourceage ◇ (Bash : media-use, conditionnel)

Si shot-plan.json.asset_needs n'est pas vide, résolvez les actifs (recherche / génération / récupération → chemins locaux figés du projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par la recherche utilisent la recherche presse/web/tweet/image). Si asset_needs est vide, passez à l'étape 3.

# illustratif — voir phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Dégradez avec élégance : si une recherche/un fournisseur est indisponible, la catégorie revient sans actifs (notez-le dans context.log).

Étape 3 — Conception (sous-agent : Directeur Partie 2)

Déléguez un sous-agent (invite = agents/director.md Partie 2 + contexte de répartition incluant le assets/index.md résolu si l'étape 2 a été exécutée + catalog-map.md). Il conçoit le plan autour des actifs disponibles : choisissez le(s) bloc(s) de catalogue + les règles/plans hyperframes-animation, la disposition, le mouvement, les battements, et (pour asset-fusion) les element_positions + la palette de la pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).

Étape 4 — Construction (sous-agent : Builder, priorité à la réutilisation)

Déléguez un sous-agent. invite = agents/builder.md complet + contexte de répartition (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Priorité à la réutilisation : npx hyperframes add <block> + personnalisation sur place ; rédigez manuellement uniquement les lacunes + l'affordance de fusion d'actifs. Sortie compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + identifiants stables, tl.seek(0), déterministe).

Étape 5 — Rendu (Bash)

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q draft -o ./renders/video.mp4)
# variante superposition transparente : --format webm (ou mov)

Étape 6 — Vérification (Bash → sous-agent de réparation en cas d'échec)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → terminé. En cas d'erreurs de lint/inspect, déléguez le sous-agent de réparation (agents/finalize.md : QA d'instantané + un passage de correctif sur place + nouveau rendu). Ne modifiez jamais une durée fixe lors de la réparation.

Rapport + aperçu optionnel

Rapportez la sortie finale (renders/video.mp4, ou la variante de superposition .webm / .mov) + la durée. N'ouvrez pas d'aperçu pendant l'exécution. Proposez-en un uniquement sur demande, démarré après le rendu pour qu'il serve le fichier final :

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Interface Studio ; ou `npx hyperframes play` pour un lien partageable

Les indicateurs se trouvent dans la compétence hyperframes-cli (references/preview-render.md).

Tableau de reprise

ÉtatContinuer depuis
pas de shot-plan.jsonÉtape 1 (planification)
shot-plan.json a asset_needs, pas de assets/Étape 2 (sourceage)
shot-plan.json final, pas de compositions/index.htmlÉtape 3/4 (conception+construction)
compositions/index.html existe, pas de renders/video.mp4Étape 5 (rendu) + Étape 6
renders/video.mp4 existeRapport + arrêt

Notes de conception (mainteneurs — l'exécution ne lit pas ceci)

  • Raison d'être des actifs d'abord : le sourçage est effectué en amont et informe la conception du plan (le flux RWA : analyser → rechercher → examiner → composer). Les catégories pilotées par la recherche (webpage/news/tweet) et asset-fusion s'appuient toutes deux sur la recherche media-use (presse/web/tweet/image), qui est la lignée RWA documentée de media-use.
  • Priorité à la réutilisation : l'analogue dans l'écosystème des modèles générés par LLM est « composer des blocs de catalogue + règles hyperframes-animation ». La timeline GSAP en pause de HF équivaut à useCurrentFrame de Remotion.
  • Contrat du module de catégorie : un categories/<id>/module.md (planification + construction), partageant references/motion-vocabulary.md (+ évaluation optionnelle). Ajouter une catégorie = déposer le dossier + enregistrer sa ligne de classification dans agents/director.md + sa ligne dans catalog-map.md ; le pipeline de phase est intact.
  • Forme du répertoire :
    videos/<nom-du-projet>/
      hyperframes.json  context.log
      shot-plan.json            # l'IR (sortie du Directeur)
      assets/  assets/index.md  # sortie de media-use (si sourcé)
      compositions/index.html   # sortie du Builder
      renders/video.mp4
    
  • Enregistrement : dans le routeur hyperframes — ajoutez l'intention « graphisme animé court axé sur le design » + la description du workflow ; retirez les déclencheurs motion-graphics de /general-video ; ajoutez les arêtes inversées « NE PAS UTILISER ». Voir motion-graphics-genre.md §5-7.

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

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