Communitygithub.com

samyakiasonline-ctrl/hyperframe

Un court-métrage graphique design, où le mouvement est le message — typographie cinétique, compteur de statistiques, graphique/dataviz, logo sting / habillage de marque, tiers-inférieur / callout / superposition sociale, carte animée (mettre en évidence des régions, connecter des lieux, zoomer sur un endroit), tweet / article de presse / titre animé, animation de page web/UI (défilement, curseur, callouts), ou fusionner la géométrie d'une image réelle dans un graphique. Généralement moins de 10s (jusqu'à ~30s), sans narration ni sujet en prises de vues réelles ; rendu en MP4 ou superposition transparente. Plus long / narré / multi-scène → /general-video. Incertain → /hyperframes.

Qu'est-ce que hyperframe ?

Ce skill, `samyakiasonline-ctrl/hyperframe`, est un moteur de production autonome pour créer des motion graphics courts, design-driven et sans narration. Il est conçu pour des contenus comme la typographie cinétique, les compteurs de statistiques, les graphiques de données, les logos stings, les tiers-inférieurs, les cartes animées, les animations de tweets ou d'articles de presse, et les animations d'interfaces web. Le skill suit un workflow structuré en étapes : initialisation, planification (décidant si une recherche de contenu est nécessaire), recherche de contenu (si nécessaire), conception autour des assets obtenus, construction en réutilisant des composants existants, vérification, approbation et rendu final. L'utilisateur peut choisir de lancer le rendu après avoir prévisualisé le résultat. Le skill s'appuie sur l'outil `hyperframes` pour l'initialisation, la gestion des assets et le rendu, et il est autonome, ne posant qu'une seule question de clarification au maximum.

Compatible avec~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/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 de plugins : Avant les commandes d'installation ou de mise à jour, suivez les règles d'exécution des plugins lorsque ce skill fait partie d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.

Tout d'abord, gardez ce skill à jour — confirmez avec l'utilisateur avant d'exécuter : npx hyperframes skills update motion-graphics. Une opération rapide sans effet si tout est à jour ; sinon, cela rafraîchit ce skill ainsi que les skills de base dont il dépend avant de les utiliser.

source figma : Si le logo/asset/l'animation à construire provient d'une URL figma.com, exécutez /figma en premier — exportation d'assets, jetons de marque, et traduction Motion→GSAP si le graphique est une importation Figma Motion — puis construisez à partir de sa sortie. Ne pilotez pas Figma directement via les outils MCP bruts : cela contourne l'assainissement SVG, la provenance .media/manifest.jsonl et la liaison var() des jetons de marque, donc 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 crée un motion graphic court, design-driven et non narré (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'acheminement.

Ce workflow est autonome par conception — au plus une question de clarification (agents/director.md), puis construisez jusqu'à la vérification sans révision intermédiaire. La couche d'intention (/hyperframes → references/intent-interview.md) achemine directement ici sans questions sur la forme de l'exécution ; un storyboard et une session compagnon ajoutent peu à un morceau aussi court. Le rendu est toujours soumis à l'approbation de l'utilisateur : après la réussite des contrôles et des captures d'écran de vérification, 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 réalisateur.

Un motion graphic court et design-driven. Priorité aux assets : décidez de la stratégie d'assets et procurez-vous 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 ? + classifier + stratégie d'assetsshot-plan.json (brouillon : catégorie, requêtes asset_needs, brief)agents/director.md (Partie 1)
sourcer ◇Bash — résolution des assets media-use (sauter si asset_needs est vide)assets/ + assets/index.mdphases/source/guide.md
designsous-agent — conception du plan autour des assets 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, captures de vérification ; réparation en cas d'échecsnapshots/contact-sheet.jpgÉtape 5
approveOuvrez l'aperçu ; demandez le rendu ou les modifications ; attendez la réponseapprobation explicite du renduÉtape 6
renderBash — hyperframes render (MP4, ou --format webm/mov pour la superposition)renders/video.mp4 ou superposition transparenteÉtape 6

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

Catégories — réparties 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 renvoyé 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 directeurs hyperframes-animation + blocs du registre).

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

CatégorieIntentionS'appuie sur
kinetic-typeligne / citation / titre percutant, texte prioritaire au mouvementblocs caption-* + règles d'animation
statnuméro 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 / habillage de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres de nom / titre, callouts, superpositions socialescaption-* + blocs de superposition du registre
mapsmouvement géographique — mettre en évidence des régions, connecter des lieux, zoomer sur un endroit (couche vectorielle, ou couche de fond de carte intégrée)famille us-map / world-map + bake-basemap.mjs

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

Contenu retournéCatégorieAnimation
page web / lienwebpageanimation de page web / UI (défilement, révélation, curseur, callouts)
article de pressenewsrévélation de titre + carte source + callouts de faits clés
tweettweetcarte tweet animée
image / entitéasset-fusionla géométrie de l'asset devient le graphique (fusion diégétique RWA)

Ordre de construction : un à la fois, priorité à la couverture (l'ébauche est acceptable). kinetic-type porté depuis le 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 (alternatives locales si non définies) — uniquement nécessaires pour les catégories qui génèrent/procurent des assets via media-use :

CléUtilisée pourAlternative
GEMINI_API_KEY / GOOGLE_API_KEYgénération d'images (résolution media-use)sauter la génération / recherche uniquement
(fournisseurs de recherche d'assets)recherche d'assets réels pour webpage/news/tweet + asset-fusionla catégorie se dégrade en version sans asset

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 (<sujet>-motion). Pas le nom de base de l'espace de travail ni un horodatage.

Seulement 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 exécuter hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre dossier 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 : Réalisateur Partie 1)

Lancez un sous-agent. invite = contenu complet de agents/director.md + ## 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[] (actualité / 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 manquant.

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

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

Dégradez-vous gracieusement : si un moteur de recherche/fournisseur est indisponible, la catégorie revient à une version sans asset (notez-le dans context.log).

Étape 3 — Conception (sous-agent : Réalisateur 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 assets disponibles : choisir le(s) bloc(s) du catalogue + les règles/plans directeurs de hyperframes-animation, la disposition, le mouvement, les temps forts, et (pour asset-fusion) les element_positions + la palette de l'outil 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 répartition 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 = contenu complet de agents/builder.md + 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 ; n'écrivez manuellement que les lacunes + l'élément de fusion d'asset. 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 — 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 <temps_de_preuve>)

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 capture générée avant de continuer. En cas d'échec de lint, check ou de capture, 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 modifiez jamais 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)

Rendez uniquement après une réponse explicite de rendu :

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# variante superposition transparente : --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 la composition ou de l'image, les temps de preuve, et la feuille de contact ou de capture inspectée. Les drapeaux se trouvent dans /hyperframes-cli → references/preview-render.md.

Tableau de reprise

ÉtatContinuer à partir de
pas de shot-plan.jsonÉtape 1 (planification)
shot-plan.json a asset_needs, pas de assets/Étape 2 (approvisionnement)
shot-plan.json final, pas de compositions/index.htmlÉtape 3/4 (conception+construction)
compositions/index.html existe, captures de vérification absentesÉtape 5 (vérification)
contrôles et captures de vérification réussis, pas de rendu approuvéÉtape 6 (approbation)
rendu approuvé existevérifier la sortie, puis signaler

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

  • Rationnement prioritaire des assets

Individual skills in this repo

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

samyakiasonline-ctrl/hyperframe

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

samyakiasonline-ctrl/hyperframe

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

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

samyakiasonline-ctrl/hyperframe

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.

samyakiasonline-ctrl/hyperframe

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

samyakiasonline-ctrl/hyperframe

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Skills associés