Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Un court graphisme animé centré sur le design, où le mouvement est le message — typographie cinétique, compteurs, graphiques de données, logo sting, incrustations, cartes animées, tweets animés, animations UI, ou fusion de la géométrie d'une image réelle dans un graphique. Généralement moins de 10 secondes (jusqu'à ~30s), sans narration ni sujet en prise de vue réelle ; rendu en MP4 ou en overlay transparent.

Qu'est-ce que hyperframes-instruct ?

Ce skill, `motion-graphics`, est conçu pour créer des graphismes animés courts, esthétiques et sans narration, où le mouvement lui-même transmet le message. Il est destiné à des agents autonomes comme Claude Code ou Cursor, pour des projets de moins de 10 secondes, avec rendu final en MP4 ou en overlay transparent. Le skill orchestre un workflow en étapes : initialisation, planification, sourcing d'actifs (recherche web, images, tweets, etc.), conception, construction, vérification, approbation et rendu. Il privilégie une approche 'actifs d'abord', en décidant de la stratégie et en sourçant le contenu réel avant de concevoir le plan. Il prend en charge de nombreuses catégories : typographie cinétique, statistiques, graphiques, logos, incrustations, cartes, animations UI et fusion d'actifs. Chaque catégorie dispose de règles et de blocs de construction dédiés. Le skill utilise des sous-agents pour la planification et la construction, et repose sur un vocabulaire de mouvement partagé. Il inclut des mécanismes de vérification (lint, check, snapshots) et de réparation automatique en cas d'échec, avant de demander l'approbation de l'utilisateur pour le rendu final. Le rendu est conditionné par une validation explicite.

Compatible avec~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/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

Installation des plugins : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution des plugins lorsque ce skill se trouve à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.

D'abord, gardez ce skill à jour — confirmez avec l'utilisateur avant d'exécuter : npx hyperframes skills update motion-graphics. Une exécution rapide sans effet si tout est à jour ; sinon, il actualise ce skill ainsi que les skills de domaine principaux dont il dépend avant que vous ne vous appuyiez dessus.

source figma : Si le logo/actif/l'animation à construire provient d'une URL figma.com, exécutez /figma d'abord — exportation des actifs, tokens de marque et traduction Motion→GSAP si le graphique est une importation Figma Motion — puis construisez à partir de sa sortie. N'utilisez pas les outils MCP bruts directement pour piloter Figma : cela contourne l'assainissement SVG, la provenance .media/manifest.jsonl et la liaison var() des tokens de marque, de sorte qu'un changement de marque ultérieur ne peut pas se propager sans une réimportation complète.

motion-graphics — point d'entrée de répartition

La porte d'entrée est /hyperframes. Ce skill réalise un court graphisme animé, centré sur le design et sans narration (le mouvement est le message ; ~moins de 10s, sans voix off). Tout ce qui est plus long, narré ou multi-scène — ou en cas d'incertitude → lisez /hyperframes d'abord : la couche d'intention possède chaque décision d'itinéraire.

Ce workflow est autonome par conception — au maximum une question de clarification (agents/director.md), puis construction jusqu'à la vérification sans révision intermédiaire. La couche d'intention (/hyperframes → references/intent-interview.md) achemine ici directement sans questions sur la forme ; un storyboard et une session d'accompagnement apportent peu à un morceau aussi court. Le rendu est toujours verrouillé par l'utilisateur : après la réussite des vérifications et des snapshots de preuve, ouvrez l'aperçu Studio et posez la question canonique « rendre maintenant, ou quels changements ? » de ../hyperframes/references/brief-contract.md. Lorsqu'un BRIEF.md existe, lisez-le avant la question du directeur.

Un court graphisme animé centré sur le design. Actifs d'abord : décidez de la stratégie d'actifs et sourcez 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/<project-name>/ (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 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) + disposition + mouvement + positions)agents/director.md (Partie 2)
buildsous-agent — composition priorisant la réutilisationcompositions/index.htmlagents/builder.md
verifyBash — lint, check, snapshots de preuve ; réparation en cas d'échecsnapshots/contact-sheet.jpgÉtape 5
approveOuvrir l'aperçu ; demander le rendu ou des modifications ; attendre la réponseapprobation explicite du renduÉtape 6
renderBash — hyperframes render (MP4, ou --format webm/mov pour overlay)renders/video.mp4 ou overlay transparentÉtape 6

◇ source s'exécute uniquement lorsque la catégorie choisie déclare des actifs. Les catégories purement code/texte (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 bifurcation sépare les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories basées sur la recherche, par le type de contenu que la recherche retourne. Chaque catégorie est un categories/<id>/module.md (ses règles de planification et de construction) ; le vocabulaire de mouvement partagé se trouve dans references/motion-vocabulary.md (→ règles/plans hyperframes-animation + blocs de registre).

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

CatégorieIntentionS'appuie sur
kinetic-typephrase/chiffre/citation percutant, texte axé sur le mouvementblocs caption-* + règles d'animation
statnombre héros unique / compteur + anneauapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsbarre / ligne / camembert / course / % à partir de donnéesbloc data-chart
logo-reveallogo sting / verrouillage de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres de nom / titre, légendes, superpositions socialescaption-* + blocs d'overlay du registre
mapsmouvement géographique — mettre en évidence des régions, connecter des lieux, zoomer sur un emplacement (couche vectorielle ou fond de carte cuit)famille us-map / world-map + bake-basemap.mjs

Catégories basées sur la recherche — rechercher d'abord, puis animer par type de contenu (le chemin RWA) :

Contenu retournéCatégorieAnimation
page web / lienwebpageanimation page web / UI (défilement, révélation, curseur, légendes)
article de pressenewsrévélation de titre + carte source + légendes 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'approximation est acceptable). kinetic-type porté du prototype ; le reste suit.

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 (repli local si non définies) — nécessaires uniquement pour les catégories qui sourcent/génèrent des actifs via media-use :

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

Flux

Étape 0 — Initialisation

Le répertoire de travail courant est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<project-name>/. <project-name> : utilisez le répertoire donné par l'utilisateur, sinon un nom court en kebab-case dérivé de l'intention (<subject>-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/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

init vérifie les skills installés par rapport aux dernières versions sur GitHub et met à jour l'ensemble global si certains 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 cd nu.

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

Lancez 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 bifurcation)
    • Non → choisir une catégorie de forme (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps) ; le contenu est fourni par l'utilisateur ; asset_needs: [].
    • Oui → émettre un plan de recherche dans asset_needs[] (news / web / tweet / image ; requêtes bipolaires). La catégorie basée sur la 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 de shot-plan.json (enveloppe + catégorie de forme choisie ou intention de recherche + asset_needs + un brief de plan d'un paragraphe). 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 locaux figés du projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories basées sur la recherche utilisent la recherche news/web/tweet/image). Si asset_needs est vide, passer à l'étape 3.

Dégrader gracieusement : si une recherche/un fournisseur n'est pas disponible, la catégorie revient à sans actif (le noter dans context.log).

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

Lancez 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 : choisir le(s) bloc(s) du catalogue + les règles/plans hyperframes-animation, la disposition, le mouvement, les temps forts, 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 : Constructeur, priorité à la réutilisation)

Incluez les principes de mouvement partagés dans le contexte de distribution du Constructeur. Pour charts et stat, incluez également les données en mouvement. Le Constructeur lit ces guides avant d'écrire la timeline.

Lancez un sous-agent. invite = agents/builder.md complet + contexte de distribution (shot-plan.json, catalog-map.md, 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 ; n'écrire à la main que les lacunes + l'affordance de fusion d'actifs. Produire 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 — Vérification (Bash → sous-agent de réparation en cas d'échec)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

Choisissez des temps de preuve qui montrent l'état d'ouverture, le mouvement signature et la tenue finale. Inspectez la feuille de contact ou de snapshot générée avant de continuer. En cas d'échec de lint, check ou snapshot, lancez le sous-agent de réparation (agents/finalize.md) pour un passage de correction sur place, puis réexécutez la porte défaillante. Ne jamais modifier une durée fixe simplement pour masquer un défaut.

Étape 6 — Approbation et rendu (Bash)

Ouvrez Studio, puis posez une question : « rendre maintenant, ou quels changements ? » Après les révisions, revenez à la même porte :

(cd "$PROJECT_DIR" && npx hyperframes preview --background)

Ne rendre qu'après une réponse explicite de rendu :

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

Vérifiez que la sortie existe, n'est pas vide et a la durée prévue. La remise finale nomme l'artefact, la durée réelle, l'identifiant de composition ou de frame, les temps de preuve et la feuille de contact ou de snapshot inspectée. Les indicateurs se trouvent dans /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 (source)
shot-plan.json final, pas de compositions/index.htmlÉtape 3/4 (conception+construction)
compositions/index.html existe, snapshots de preuve absentsÉtape 5 (vérification)
vérifications et snapshots de preuve réussis, pas de rendu approuvéÉtape 6 (approbation)
rendu approuvé existevérifier la sortie, puis rapporter

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

sandeshrajbhandari/hyperframes-instruct

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

sandeshrajbhandari/hyperframes-instruct

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

Skills associés