Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Utiliser lorsqu'une composition HyperFrames nécessite un punch-in, punch-out, zoom, recadrage, effet Ken Burns, mouvement de caméra, transition par correspondance visuelle/whip, ou d'autres keyframes 2D/3D seek-safe ; également pour GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, chemins, masques, morphing/dessin SVG, traînées de texte, profondeur 3D, ou diagnostics `hyperframes keyframes`. Ne pas utiliser pour la stratégie globale de scène, le design de marque, le sourçage de médias, les sous-titres, ou la planification vidéo générale.

Qu'est-ce que hyperframes-instruct ?

Ce skill est dédié à l'animation visuelle précise et seek-safe dans HyperFrames. Il permet de créer des keyframes pour des effets de caméra (punch-in, punch-out, zoom, Ken Burns, whip pan), des transitions (match cut, iris reveal), des animations de texte et SVG, et des manipulations 3D. Il prend en charge GSAP, CSS keyframes, Anime.js, WAAPI et FLIP. L'utilisateur décrit le sujet animé, les poses clés et la durée ; le skill génère les keyframes appropriées et les vérifie avec `hyperframes check`, `hyperframes keyframes` et des snapshots. Il ne gère pas le montage brut (coupures, fondus) qui appartient à `/hyperframes-core`, ni les transitions audio qui relèvent de `/hyperframes-audio`.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/tree/HEAD/.agents/skills/hyperframes-keyframes

Demander à votre IA préférée

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

Documentation

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

HyperFrames Keyframes

Les keyframes sont un contrat de pose : états visibles, identité continue du sujet, runtime seek-safe, pixels vérifiés.

Utilisez hyperframes-animation pour les recettes de scène larges. Utilisez hyperframes-cli pour la documentation complète des commandes. Utilisez references/keyframe-patterns.md uniquement lors du choix des mécanismes d'implémentation, pas du style visuel.

Limite d'édition du créateur

Les keyframes gèrent le mouvement visuel, pas l'assemblage de clips. Les coupes franches par plage source, le rognage, l'épissage et le réordonnancement appartiennent à /hyperframes-core : créez un élément média par plage conservée, placez-le avec data-start et data-duration, et sélectionnez son décalage source avec data-media-start. Les plages adjacentes forment une coupe franche. Un fondu enchaîné utilise des clips qui se chevauchent sur différentes pistes plus des keyframes d'opacité visuelle ; les fondus sonores utilisent /hyperframes-audio.

Demande du créateurMécanisme véridique
Punch-in / punch-outKeyframe scale avec translation x/y ou en pourcentage sur un wrapper visuel/recadrage non temporel à l'intérieur du clip. Utilisez un tween court et net pour un punch dur et un tween pour un mouvement fluide.
Zoom fluide multi-état ou recadrageGardez un wrapper sujet vivant et créez plusieurs états de zoom/recadrage sous forme d'échelle de poses avec un easing par segment.
Pan, recadrage ou mouvement de caméra Ken BurnsAnimez la translation du wrapper plus l'échelle. La géométrie est créée ; ce n'est pas du suivi de visage ou du recadrage sémantique automatique.
Mouvements de caméra enchaînésEnchaînez les battements de transformation étiquetés sur une timeline seek-safe enregistrée.
Match cut ou whip pan/hyperframes-animation possède la transition visuelle ; /hyperframes-registry fournit les primitives ; les keyframes préservent la géométrie, la direction et la vitesse créées. Il n'y a pas de découverte automatique de cadre correspondant.
Recadrage et masqueInterpolez clip-path ou un masque sur un wrapper visuel interne pour recadrer/recentrer sans changer le temps source. Les keyframes polygonales peuvent former une transition polygone/masque.
Wipe directionnel ou iris/révélationAnimez une limite de masque/clip sur des clips visuels qui se chevauchent ; /hyperframes-animation possède la chorégraphie de transition.
Transition split-screenGardez les deux clips visuels placés par le core, puis créez des keyframes sur leurs wrappers de recadrage/masque internes et la géométrie du séparateur.
Ralenti/accéléré constant de la source/hyperframes-core possède le data-playback-rate normalisé (0.1..10) pour une image et un son préservant la hauteur, sûrs pour le rendu. Il est constant pour tout l'élément média.
Rampes de vitesse sourceUne piste rate dans data-automation sur <video>/<audio> (t en secondes de clip, v 0.1..10, interpolation logarithmique) ; elle l'emporte sur le taux constant.
Gel / arrêt sur imageUne pose visuelle, une image source finale ou une sous-composition terminée peut être maintenue. Le gel arbitraire au milieu de la source n'est pas supporté ; prétraitez un segment fixe/dérivé, placez-le comme son propre clip, puis reprenez avec une autre plage source.

Lors de l'édition de l'image et du son ensemble, chargez /hyperframes-core, ce skill pour le mouvement visuel, et /hyperframes-audio pour les fondus, fondus enchaînés, automation de volume, ducking/carve, ou effets sur les pistes placées.

Une transition visuelle ou un traitement de recadrage n'est pas un rognage temporel de la source ou un épissage. /hyperframes-core possède la timeline, le timing des clips et les plages source ; les keyframes animent uniquement la transition ou le recadrage visible sur les wrappers à l'intérieur de ces clips. Pour des recettes combinées image/son copiables, utilisez /hyperframes-core → references/creator-editing-recipes.md.

Procédure

  1. Identifiez le sujet animé, les états visibles, l'état final et la durée.
  2. Choisissez le plus petit mécanisme qui prouve la demande. Lisez references/keyframe-patterns.md uniquement si le mécanisme n'est pas clair.
  3. Créez des keyframes seek-safe dans la durée déclarée. Enregistrez l'instance runtime uniquement après la fin de la construction ; il est acceptable de construire à l'intérieur de document.fonts.ready.
  4. Vérifiez avec hyperframes check (il exécute lint), hyperframes keyframes, un --shot ciblé, et des snapshots aux moments de preuve.
  5. Si la preuve échoue, corrigez les keyframes source et relancez le plus petit diagnostic échoué avant de rendre.

Contrat

  • Nommez le sujet en mouvement.
  • Nommez les poses nécessaires pour prouver le mouvement prévu, y compris l'état final.
  • Keyframe les canaux visibles, pas l'état caché des helpers.
  • Préservez l'identité de l'objet lorsque la continuité est importante.
  • Faites un fondu enchaîné uniquement lorsque le mouvement prévu est un remplacement ou une dissolution.
  • Maintenez les états lisibles ou sémantiques assez longtemps pour être vus.
  • La dernière image fait partie de l'animation, pas du nettoyage.
  • Ne réinitialisez pas au repos sauf si demandé.
  • Ne terminez pas sur du noir sauf si demandé.
  • Si vous éditez une scène de démarrage, préservez la disposition, la copie, les assets, les couleurs et l'état final, sauf si une refonte est demandée.

Règles Runtime

GSAP :

  • construire au chargement de la page ou à l'intérieur de document.fonts.ready, et enregistrer uniquement après la fin de la construction
  • utiliser gsap.timeline({ paused: true })
  • enregistrer comme window.__timelines[compositionId]
  • la clé du registre doit correspondre à data-composition-id
  • ne pas appeler tl.play() pour un mouvement critique pour le rendu
  • garder les répétitions finies

CSS keyframes :

  • durée finie et nombre d'itérations
  • délai déterministe
  • animation-fill-mode: both
  • utiliser data-start lorsque le timing appartient à un clip

Anime.js :

  • créer de manière synchrone
  • autoplay: false
  • durée et boucles finies
  • pousser chaque instance dans window.__hfAnime

WAAPI :

  • duration finie
  • fill: "both"
  • construction déterministe
  • la surface de texte ne liste pas WAAPI ; vérifiez avec --shot (il cherche WAAPI) et des snapshots

Ne jamais utiliser pour un mouvement critique pour le rendu :

  • Date.now()
  • performance.now()
  • Math.random() non ensemencé
  • déclencheurs hover/scroll
  • timers
  • une timeline enregistrée avant la fin de sa construction asynchrone
  • requestAnimationFrame non enregistré
  • boucles infinies

Squelette GSAP

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

Utilisez des labels pour les états sémantiques. Utilisez des paramètres de position au lieu de délais enchaînés. Utilisez immediateRender: false pour les tweens from()/fromTo() ultérieurs touchant la même propriété.

Formes de Keyframes

  • Keyframes en tableau : échelle de poses avec durée/easing par étape.
  • Keyframes en pourcentage : timing exact à l'intérieur d'un seul tween.
  • Tableaux de propriétés : changements multi-étapes compacts.
  • ease: "none" sur le parent lorsque chaque étape porte son propre easing.
  • easeEach lorsque chaque segment doit partager la même sensation.

Ne copiez pas les distances numériques ou les timings des exemples. Dérivez-les de la géométrie et de la durée réelles de la composition.

Pour un sujet se déplaçant entre deux boîtes, préférez un seul tween de transformation continu ou FLIP. Divisez x/y/scale en plusieurs keyframes avec easing uniquement lorsque le spectateur doit ressentir des battements distincts ; chaque segment change de vitesse et peut être perçu comme un à-coup.

Canaux

Préférez les canaux compositeur/visuels : x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, masques, variables CSS, valeurs de chemin/dash SVG, transformations de caméra, uniforms de shader.

Évitez les canaux de disposition/cycle de vie : top/left/right/bottom, width/height, margin/padding, display, visibility, création DOM tardive, overlays helpers faisant le mouvement du sujet.

Pour les changements de visibilité, utilisez autoAlpha sur la timeline GSAP seekable enregistrée, ou un tl.set() de durée nulle à une limite explicite. Ciblez uniquement un élément non-clip ou un wrapper à l'intérieur du clip ; ne ciblez jamais .clip lui-même. Ne faites jamais de tween de durée sur la visibility brute, et ne faites jamais de tween sur display.

Choix du Mécanisme

Choisissez le plus petit mécanisme qui prouve la demande :

BesoinMécanisme
Le même sujet change de boîte ou de hiérarchieélément partagé / FLIP
Le sujet parcourt une route visiblepath travel
Un trait pousse ou tracestroke draw
Une forme devient une autre formeshape interpolation
La limite de révélation est visibleclip, mask, ou shader uniform
Plusieurs éléments bougent avec ordrestagger / indexed delay
Le texte lui-même bougeline, word, character, ou band subdivision
La surface se plie, s'étire ou recadreparent/child counter-transform
L'interface a des étatsmachine d'état explicite
La scène a de la profondeurDOM 3D, Three.js, ou WebGL camera/object keyframes

Les mécanismes peuvent se combiner, mais chacun doit clarifier l'idée. La décoration n'est pas une preuve.

Timing

  • Anticipation uniquement lorsqu'elle clarifie la cause ou la direction.
  • L'accélération quitte le repos.
  • La preuve maximale montre le mécanisme de manière indubitable.
  • Le suivi (follow-through) vend l'énergie et la direction.
  • Le dépassement (overshoot) uniquement lorsque le sujet doit sembler élastique ou tactile.
  • Un déplacement à vitesse constante sur un chemin nécessite généralement ease: "none".
  • Les états d'interface discrets nécessitent généralement un ease-out prononcé.
  • Les éléments répétés ont besoin de décalages ordonnés, pas d'un timing identique.
  • Les verrouillages finaux nécessitent des maintiens plus longs que les poses de transition.
  • La fluidité signifie une vitesse continue sur le même sujet.
  • Ne chevauchez pas les tweens qui écrivent la même propriété de transformation, sauf si le chevauchement est intentionnel et vérifié.
  • Évitez d'animer de grands changements de clip-path/masque pendant que la même surface héroïque se met également à l'échelle ou se déplace ; utilisez des révélations imbriquées après que le mouvement principal s'est stabilisé.

Texte

Préservez les boîtes de ligne, l'espacement des mots, la lisibilité et l'ajustement final. Si le texte se déplace en interne, déplacez les glyphes ou les bandes masquées, pas seulement les décorations autour du texte. Prenez des snapshots d'images lisibles.

SVG

Pour la croissance du trait, préférez DrawSVGPlugin, puis stroke-dasharray/stroke-dashoffset. Pour l'interpolation de forme, préférez MorphSVGPlugin ; convertissez les primitives en chemins si nécessaire et divisez les silhouettes complexes en parties plus simples.

3D

L'échelle seule est une fausse profondeur. Utilisez la perspective sur un parent stable, transform-style: preserve-3d, le déplacement en z, la rotation, le mouvement de la caméra/du monde, l'occlusion et l'ordre des couches lorsque les objets se croisent.

Utilisez un ou deux angles de diagnostic qui exposent la relation de profondeur. Si la preuve en angle ne montre pas de croisement de profondeur, améliorez z/caméra/occlusion.

Canvas / WebGL

Keyframe la position de la caméra, la cible de la caméra, la transformation de l'objet, l'opacité du matériau, les uniforms du shader et l'intensité du post-traitement via un état déterministe. Rendez à partir du temps HyperFrames. Utilisez --ghost car les boîtes de marqueur ne peuvent pas voir le mouvement interne du canvas.

Preuve CLI

npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

Choisissez <selector> pour le vrai sujet animé. Choisissez <times> pour la première image, les poses de preuve, la finale moins le maintien, et la finale exacte. Choisissez <angle> uniquement lorsque la profondeur doit être prouvée.

OutilProuve
keyframescibles, arrêts explicites, chemins, traces, mouvement composé parent/enfant, arrêts CSS, enregistrement Anime
--shotfantômes, forme de la route, espacement temporel, projection DOM 3D, preuve de sélecteur ciblé
--layout stripmouvement sur place, chevauchements, contact, échelle/opacité subtile, vagues de texte
--ghostcanvas, WebGL, mouvement de shader, 3D rendu
snapshot --atmasques

…

[tronqué pour la traduction]

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

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.

sandeshrajbhandari/hyperframes-instruct

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Skills associés