Communitygithub.com

sansayan01/finance_app_zo

À utiliser lorsqu'une composition HyperFrames nécessite des images clés 2D/3D seek-safe, des timelines GSAP, des animations CSS, Anime.js, WAAPI, FLIP, des chemins, des masques, du morphing/dessin SVG, des traînées de texte, de la profondeur 3D, ou des diagnostics `hyperframes keyframes`. Ne pas utiliser pour la stratégie générale de scène, le design de marque, la recherche de médias, les sous-titres ou la planification vidéo générale.

Qu'est-ce que finance_app_zo ?

Ce skill HyperFrames Keyframes est conçu pour les développeurs et les agents IA qui travaillent avec le système HyperFrames. Il fournit un contrat strict pour la création d'images clés seek-safe (sécurisées pour la recherche temporelle) dans les animations 2D/3D, en se concentrant sur des états visibles, une identité de sujet continue et des pixels vérifiés. L'outil prend en charge plusieurs moteurs d'animation comme GSAP, CSS, Anime.js, WAAPI et FLIP, et offre des diagnostics CLI via `hyperframes keyframes` pour valider que les animations sont correctement configurées et peuvent être parcourues sans erreur. Le skill est particulièrement utile pour les scènes où la précision des images clés est critique, comme les morphing de formes SVG, les animations de chemins, les transitions de texte et les compositions 3D complexes. Il impose des règles strictes pour éviter les erreurs courantes, comme l'utilisation de timers non déterministes ou de boucles infinies, et fournit des squelettes de code spécifiques pour chaque moteur d'animation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/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

HyperFrames Keyframes

Les images clés sont un contrat de pose : états visibles, identité continue du sujet, exécution sécurisée pour la recherche, pixels vérifiés.

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

Procédure

  1. Identifiez le sujet animé, les états visibles, l'état final et la durée d'exécution.
  2. Choisissez le mécanisme le plus petit qui prouve l'intention. Lisez references/keyframe-patterns.md uniquement si le mécanisme n'est pas clair.
  3. Créez des images clés seek-safe dans l'exécution déclarée. Construisez de manière synchrone et enregistrez l'instance d'exécution.
  4. Vérifiez avec lint, validate, hyperframes keyframes, un --shot ciblé et des instantanés aux moments de preuve.
  5. Si la preuve échoue, corrigez les images clés source et réexécutez le plus petit diagnostic en échec 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.
  • Animez les canaux visibles, pas les états d'aide cachés.
  • Préservez l'identité de l'objet lorsque la continuité est importante.
  • Utilisez le fondu enchaîné uniquement lorsque le mouvement prévu est un remplacement ou une dissolution.
  • Maintenez les états lisibles ou sémantiques suffisamment longtemps pour être vus.
  • La dernière image fait partie de l'animation, pas un nettoyage.
  • Ne revenez pas à l'état de repos sauf demande explicite.
  • Ne terminez pas sur du noir sauf demande explicite.
  • Si vous modifiez une scène de départ, conservez la mise en page, le texte, les actifs, les couleurs et l'état final, sauf si une refonte est demandée.

Règles d'exécution

GSAP :

  • construisez de manière synchrone au chargement de la page
  • utilisez gsap.timeline({ paused: true })
  • enregistrez comme window.__timelines[compositionId]
  • la clé d'enregistrement doit correspondre à data-composition-id
  • n'appelez pas tl.play() pour le mouvement critique du rendu
  • gardez les répétitions finies

Animations CSS :

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

Anime.js :

  • créez de manière synchrone
  • autoplay: false
  • durée et boucles finies
  • poussez chaque instance vers 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 les instantanés

N'utilisez jamais pour le mouvement critique du rendu :

  • Date.now()
  • performance.now()
  • Math.random() non initialisé
  • déclencheurs de survol/défilement
  • minuteurs
  • timelines créées de manière 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 étiquettes pour les états sémantiques. Utilisez des paramètres de position au lieu de délais enchaînés. Utilisez immediateRender: false pour les from()/fromTo() ultérieurs touchant la même propriété.

Formes d'images clés

  • Images clés tableau : échelle de poses avec durée/temps par étape.
  • Images clés pourcentage : timing exact à l'intérieur d'une seule interpolation.
  • Tableaux de propriétés : changements multi-étapes compacts.
  • ease: "none" sur le parent lorsque chaque étape a 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 une seule interpolation de transformation continue ou FLIP. Divisez x/y/scale en plusieurs images clés avec easing uniquement lorsque le spectateur doit ressentir des temps distincts ; chaque segment change de vélocité et peut être perçu comme un à-coup.

Canaux

Préférez les canaux de composition/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 mise en page/cycle de vie : top/left/right/bottom, width/height, margin/padding, display, visibility, création DOM tardive, superpositions d'aide effectuant le mouvement du sujet.

Choix du mécanisme

Choisissez le mécanisme le plus petit qui prouve l'intention :

BesoinMécanisme
Le même sujet change de boîte ou de hiérarchieélément partagé / FLIP
Le sujet parcourt un itinéraire visiblechemin de déplacement
Le trait grandit ou tracedessin de trait
Une forme devient une autre formeinterpolation de forme
La limite de révélation est visibleclip, masque ou uniforme de shader
Plusieurs éléments se déplacent en ordredécalage / délai indexé
Le texte lui-même se déplacesubdivision de ligne, mot, caractère ou bande
La surface se plie, s'étire ou recadrecontre-transformation parent/enfant
L'interface utilisateur a des étatsmachine à états explicite
La scène a de la profondeurDOM 3D, Three.js, ou images clés de caméra/objet WebGL

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 vend l'énergie et la direction.
  • Le dépassement uniquement lorsque le sujet doit sembler élastique ou tactile.
  • Le déplacement à vitesse constante sur un chemin nécessite généralement ease: "none".
  • Les états d'interface utilisateur discrets nécessitent généralement un ease-out brusque.
  • Les éléments répétés ont besoin de décalages ordonnés, pas de timings identiques.
  • Les verrouillages finaux nécessitent des maintiens plus longs que les poses de transition.
  • La fluidité signifie une vélocité continue sur le même sujet.
  • Ne superposez pas les interpolations qui écrivent la même propriété de transformation, sauf si la superposition est intentionnelle et vérifiée.
  • Évitez d'animer de grandes modifications 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 à l'intérieur, déplacez les glyphes ou les bandes masquées, pas seulement les décorations autour du texte. Prenez des instantanés des 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/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 angulaire ne montre aucun croisement de profondeur, améliorez le z/caméra/occlusion.

Canvas / WebGL

Animez 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 lint
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 véritable sujet animé. Choisissez <times> pour la première image, les poses de preuve, final-moins-maintien, et la toute dernière image. 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 l'itinéraire, espacement temporel, projection DOM 3D, preuve de sélecteur ciblée
--layout stripmouvement sur place, chevauchements, contact, échelle/opacité subtiles, vagues de texte
--ghostcanvas, WebGL, mouvement de shader, 3D rendu
snapshot --atmasques, lisibilité du texte, état complet, verrouillage final, queues noires/de réinitialisation

Si la preuve de sélecteur semble erronée :

  1. réexécutez --json
  2. trouvez la cible animée réelle
  3. ciblez cette cible
  4. prenez des instantanés des images complètes
  5. faites confiance aux pixels peints plutôt qu'aux journaux

Lecture du diagnostic

flat signifie qu'il n'y a pas de poses intermédiaires explicites. keyframes signifie que des arrêts explicites existent. motionPath signifie qu'un itinéraire existe. trace signifie un dessin multi-traits. composed with signifie que le mouvement de l'enfant hérite du mouvement du parent.

Un espacement uniforme des fantômes signifie une vitesse constante. Des fantômes groupés signifient un ralentissement ou un palier. De grands écarts signifient un déplacement rapide.

Un plan avec un sélecteur d'aide n'est pas une preuve. Un plan en oignon sur une image complète cassée n'est pas une preuve.

Gestion des erreurs

ÉchecCorrection
point final uniquementajoutez des poses intermédiaires, maintenez la preuve maximale, réexécutez --shot
rupture d'identitégardez un élément vivant, utilisez des boîtes source/finale partagées, supprimez le fondu de substitution
fausse 3Dajoutez un déplacement z/caméra, une occlusion, une preuve angulaire
mauvais finalajoutez un maintien final, prenez un instantané final-moins-maintien et du final exact
exécution non cherchablemettez en pause la lecture automatique, enregistrez l'instance, supprimez les minuteurs, construisez de manière synchrone
texte illisiblepréservez les boîtes de ligne, réduisez le déplacement, ajoutez un maintien final, prenez des instantanés des images de texte

Terminé

Exécutez lint, validate, keyframes, un --shot ciblé et des instantanés. Confirmez la première image, les poses de preuve, final-moins-maintien, le final exact, le mouvement appartenant au sujet et l'absence de superpositions de débogage.

Individual skills in this repo

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

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 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. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

sansayan01/finance_app_zo

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

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

Skills associés