Communitygithub.com

motion-graphics — point d'entrée dispatch

Utilisez cette compétence pour créer des motion graphics courts, design-led et sans narration : typographie cinétique, compteurs, graphiques, logos, génériques, incrustations, animations de tweets ou de pages web. Durée typique sous 10 secondes jusqu'à ~30 secondes, rendu en MP4 ou overlay transparent.

Qu'est-ce que motion-graphics — point d'entrée dispatch ?

Cette compétence est conçue pour produire des motion graphics courts, hautement designés, où le mouvement est le message principal, sans narration ni acteur en direct. Elle couvre des formats comme la typographie cinétique, les animations de statistiques/chiffres, les graphiques animés, les apparitions de logos, les incrustations sociales et les animations de pages web ou de tweets. La durée est généralement inférieure à 10 secondes et ne dépasse pas 30 secondes. Le workflow est structuré en phases : initialisation, planification (avec ou sans recherche d'actifs), conception autour des actifs résolus, construction par réutilisation de blocs catalogue, rendu (MP4, WebM ou MOV) et vérification. Elle s'appuie sur l'outil CLI `hyperframes` pour l'initialisation, le rendu et la vérification. Les catégories sont divisées en deux groupes : celles sans recherche (formulaires comme le type cinétique, les stats) et celles pilotées par recherche (pages web, actualités, tweets, fusion d'actifs). En cas de doute sur la nature du projet (court vs long/narré), la compétence renvoie vers d'autres compétences comme `/general-video` ou `/hyperframes`.

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

Que fait motion-graphics — point d'entrée dispatch ?

Confirmez la route avant l'étape 0. Cette compétence crée un motion graphic court, design-led, sans narration (le mouvement est le message ; ~moins de 10s, pas de voix-off). Un traitement plus long, multi-scène ou narré → /general-video ; une vidéo narrée d'un site web → /website-to-video ; un expliqueur de sujet → /faceless-explainer ; une promotion produit → /product-launch-video ; des sous-titres sur des images existantes → /embedded-captions. Hors champ : données en direct / au moment du rendu, ou images qu'il ne peut pas capturer. Pas sûr entre motion-first et narré ? Lisez /hyperframes d'abord.

Un motion graphic court design-led. Actif d'abord : décidez la stratégie d'actifs et sourcez du 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 recherche ? + classifier + stratégie d'actifsshot-plan.json (brouillon : catégorie, requêtes asset_needs, brief)agents/director.md (Partie 1)
source ◇Bash — résolution média-use (sauter 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) + mise en page + 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 overlay)renders/video.mp4Étape 5
verifyBash — lint / inspect -> sous-agent de réparation en cas d'échec(corrections sur place)agents/finalize.md

◇ source s'exécute uniquement lorsque la catégorie choisie déclare des actifs. Les catégories de code/texte pur (par ex. 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 sépare les catégories en deux groupes ; ensuite la catégorie spécifique est choisie — pour les catégories pilotées par recherche, selon le type de contenu retourné par la recherche. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé réside 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 percutante / citation / titre, texte animéblocs caption-* + règles d'animation
statnombre unique / compteur + anneauapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsbarres / lignes / camembert / course / % depuis les donnéesbloc data-chart
logo-revealapparition de logo / bloc de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres de nom / titre, incrustations, overlays sociauxcaption-* + blocs overlay du registre

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

Contenu retournéCatégorieAnimation
page web / lienwebpageanimation de page web / UI (défilement, révélation, curseur, incrustations)
article de pressenewsrévélation de titre + carte source + incrustations 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) — uniquement nécessaires pour les catégories qui sourcent/génèrent des actifs via media-use :

CléUtilisée pourFallback
GEMINI_API_KEY / GOOGLE_API_KEYgénération d'image (résolution media-use)sauter génération / recherche uniquement
(fournisseurs de recherche asset_scout)recherche d'actifs réels pour webpage/news/tweet + asset-fusionla catégorie dégrade en sans actif

Flux

Étape 0 — Initialisation

cwd 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 dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni 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/ dans 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)

Lancez un sous-agent. prompt = agents/director.md complet + ## Contexte de dispatch (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 → choisir une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ; asset_needs: [].
    • Oui → émettre un plan de recherche dans asset_needs[] (news / web / tweet / image ; requêtes à deux pôles). La catégorie pilotée par recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu retourné à l'étape 2, et finalisée à l'étape 3.
  2. Écrire un brouillon shot-plan.json (enveloppe + catégorie de formulaire choisie ou intention de recherche + asset_needs + un paragraphe de brief de plan). Schéma : references/shot-plan-ir.md.

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

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

Si shot-plan.json.asset_needs n'est pas vide, résoudre les actifs (recherche / génération / récupération → chemins gelés locaux au projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories pilotées par recherche utilisent la recherche news/web/tweet/image). Si asset_needs est vide, passer à 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égradation gracieuse : si un fournisseur de recherche est indisponible, la catégorie revient à sans actif (notez-le dans context.log).

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

Lancez un sous-agent (prompt = agents/director.md Partie 2 + contexte de dispatch incluant 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 : choisir le(s) bloc(s) catalogue + les règles/plans hyperframes-animation, la mise en page, le mouvement, les temps, et (pour asset-fusion) les element_positions + la palette de pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).

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

Lancez un sous-agent. prompt = agents/builder.md complet + contexte de dispatch (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Réutilisation d'abord : npx hyperframes add <block> + personnaliser sur place ; n'écrire à la main que 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" + ids 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 overlay transparent : --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 lint/inspect, lancer le sous-agent de réparation (agents/finalize.md : snapshot QA + une passe de correction sur place + re-rendu). Ne jamais modifier une durée fixe lors de la réparation.

Rapport + aperçu optionnel

Rapportez la sortie finale (renders/video.mp4, ou la variante overlay .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 afin qu'il serve le fichier final :

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

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

Table de reprise

ÉtatContinuer depuis
pas de shot-plan.jsonÉtape 1 (planification)
shot-plan.json a asset_needs, pas de assets/Étape 2 (source)
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)

  • Justification actif d'abord : la source est chargée en amont et informe la conception du plan (le flux RWA : analyser → rechercher → réviser → composer). Les catégories pilotées par recherche (webpage/news/tweet) et asset-fusion s'appuient toutes sur la recherche media-use (news/web/tweet/image), qui est la lignée RWA documentée de media-use.
  • Réutilisation d'abord : l'analogue dans l'écosystème des modèles générés par LLM est "composer des blocs catalogue + règles hyperframes-animation". La timeline GSAP en pause de HF équivaut au 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 classifieur dans agents/director.md + sa ligne dans catalog-map.md ; le pipeline de phases est inchangé.
  • Structure du répertoire :
    videos/<nom-du-projet>/
      hyperframes.json  context.log
      shot-plan.json            # IR (sortie du Directeur)
      assets/  assets/index.md  # sortie media-use (si sourcé)
      compositions/index.html   # sortie du Constructeur
      renders/video.mp4
    
  • Enregistrement : dans le routeur hyperframes — ajouter l'intention "motion graphic court design-led" + description du Workflow ; retirer les déclencheurs de motion-graphics de /general-video ; ajouter les arêtes inverses Do-NOT-use. 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-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 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