Communitygithub.com

laviedezidane/hyperframes-skill

Importez du contenu Figma dans une composition HyperFrames – assets rendus, tokens de marque, composants, sections de storyboard → mouvement reconstruit (les frames sont lues comme des états, pas des diapositives) (REST/CLI), mouvement assisté par connecteur si disponible, et shaders depuis un connecteur ou une exportation native. Utilisez-le lorsque l'utilisateur colle un lien figma.com ou demande d'importer un design, une frame, un logo, une marque ou une animation Figma dans une vidéo/composition.

Qu'est-ce que hyperframes-skill ?

Ce skill permet d'importer des designs Figma dans HyperFrames en découpant le processus en phases distinctes : assets statiques (Phase 1), tokens de marque (Phase 2), composants HTML (Phase 3), mouvement GSAP (Phase 4) et shaders (Phase 5). Il utilise l'API REST Figma pour les phases 1 à 3, garantissant des imports déterministes et volumineux, et peut recourir à un connecteur Figma compatible pour les phases 4 et 5, avec une option de repli vers une exportation native. L'authentification est gérée via un token personnel Figma (lecture seule) chargé depuis une variable d'environnement ou un fichier `.env`. Le skill gère les limites de débit (429) avec des tentatives automatiques, et produit des fichiers gelés localement avec provenance complète, évitant d'appeler Figma lors des rendus. Les storyboards sont traités comme des séquences de keyframes animant les éléments entre les états, et non comme des diapositives fixes. Le skill génère une sortie transparente pour l'utilisateur en décrivant chaque étape, le résultat et l'action suivante.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/figma

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 de fraîcheur, suivez les règles d'exécution du plugin lorsque ce skill se trouve dans un plugin HyperFrames. Pour les installations autonomes, gardez les instructions de mise à jour ci-dessous.

Tout d'abord, maintenez ce skill à jour — confirmez avec l'utilisateur avant d'exécuter : npx hyperframes skills update figma. Une opération rapide sans effet si tout est à jour ; sinon, cela rafraîchit ce skill ainsi que les skills de domaine principaux dont il dépend avant de vous y fier.

Figma → HyperFrames

Importez le travail Figma de l'utilisateur dans une composition. Réparti par capacité (spécification de conception §2) :

PhaseQuoiTransportSurface
1Assets statiquesRESThyperframes figma asset
2Tokens/styles de marqueRESThyperframes figma tokens
3Composants → HTMLRESThyperframes figma component
4Mouvement → GSAPconnecteur si disponibleutiliser son contexte de mouvement
5Shadersconnecteur / export manuell'utiliser ou une exportation native

REST est utilisé partout où c'est possible (utilisable en volume, sans tête). Un connecteur Figma compatible est optionnel pour les données de mouvement et de shader ; sans lui, demandez une exportation native. Chaque chemin gèle les assets localement pour que les rendus restent déterministes. Les reconstitutions de storyboard composent les exports d'assets de Phase 1 (REST) avec un assemblage de chronologie piloté par l'agent — aucun connecteur nécessaire. Les assets gelés existants, les enregistrements de manifeste et les liaisons ne sont pas affectés par les changements de routage — la répartition change uniquement les identifiants que la prochaine importation utilise.

Auth — deux identifiants, limités

Pré-vol — avant le premier appel CLI, vérifiez qu'un token existe : variable d'environnement shell ([ -n "$FIGMA_TOKEN" ]) ou le fichier .env du projet (le CLI le charge automatiquement — une entrée .env compte comme configurée). Si aucun des deux, n'exécutez PAS la commande pour récolter l'erreur — guidez d'abord l'utilisateur dans la configuration unique, puis arrêtez-vous et attendez :

  1. figma.com/settings → Security → Personal access tokens → Générer un nouveau token.
  2. Périmètres — la lecture seule est tout ce dont cette intégration a jamais besoin (elle n'écrit jamais dans Figma) : File content: Read-only + File metadata: Read-only. Ajoutez Library content: Read-only si vous exécutez tokens sur un plan non-Enterprise — le repli sur les styles publiés frappe /v1/files/:key/styles, qui retourne 403 sans cela (un périmètre que le texte d'installation plus ancien omettait). Optionnellement Variables: Read-only pour les variables de marque — réservé à Enterprise ; sans cela, tokens se dégrade automatiquement vers les styles publiés (attendu, pas une erreur — dites-le). Un 403 nomme désormais le périmètre manquant exact ; les 429 sont réessayés automatiquement (limite par minute, respecte Retry-After).
  3. Demandez à l'utilisateur de définir FIGMA_TOKEN dans son profil shell ou le fichier .env du projet ; ne lui demandez jamais de coller le token dans la conversation.

Lors de l'intégration, fixez également les attentes d'un seul souffle : chaque importation atterrit comme un fichier gelé local avec provenance enregistrée — les rendus n'appellent jamais Figma, ré-exécuter une commande réimporte uniquement ce qui a changé dans Figma, et un token fonctionne pour les assets, les tokens de marque et les composants sur tous les fichiers que leur compte Figma peut voir.

  • Phases 4–5 (mouvement/shaders) : un connecteur Figma compatible, avec une autorisation séparée du token. S'il est indisponible ou non authentifié, demandez à l'utilisateur de le connecter ou de fournir une exportation native, puis arrêtez-vous.
  • Dites exactement quel identifiant une phase défaillante nécessite — ne présentez jamais la répartition comme cassée.
  • BAD_TOKEN (401) en milieu de flux → le token est expiré/révoqué ; régénérez-le. FORBIDDEN (403) → le message nomme le périmètre manquant exact (p. ex. library_content:read pour le repli des styles) — ajoutez-le, ou le fichier n'est pas visible par le compte. REQUIRES_ENTERPRISE (403 sur les variables) → pas un échec : le repli des styles a déjà été exécuté. RATE_LIMITED (429) → le client a déjà réessayé avec backoff (cela s'applique à CHAQUE lecture — assets, tokens, styles, arbres de nœuds, versions — la tentative vit dans le chemin de requête partagé ; Retry-After est respecté, plafonné à 60s) ; s'il remonte toujours, attendez une minute ou importez moins de nœuds par appel.

Conscience des limites de débit (spécification §2.1) : les quotas du connecteur varient selon le plan Figma — regroupez les requêtes de frames parentes, sautez les captures d'écran de vérification sauf demande explicite, et mettez en cache les réponses brutes pour que la re-dérivation n'utilise jamais un second appel. REST est par minute (10+/min, compartiments par endpoint) — bien en volume, ralentissez sur 429.

Routage

Analysez le lien figma de l'utilisateur avec parseFigmaRef (URL, fileKey:nodeId, fileKey nu). Ensuite, selon l'intention :

  • "utiliser ce calque / logo / image" → Asset (CLI)
  • "récupérer ma marque / mes couleurs / mes tokens" → Tokens (CLI)
  • "construire une scène à partir de cette frame" → Component (CLI)
  • "importer cette animation / ce mouvement" → Motion (connecteur si disponible, ci-dessous)
  • une section de storyboard / filmstrip de frames de scène → Storyboard (ci-dessous)
  • remplissage/effet shader → Shaders (ci-dessous)

Racontez chaque étape à l'utilisateur — avant chaque commande, dites ce que vous allez extraire de Figma ; après, dites où l'artefact a atterri (le chemin gelé / sidecar / dossier du composant), ce qui a changé dans la composition, et l'action immédiate suivante (aperçu, ajouter des variables imprimées, réimporter pour lier les liaisons). L'utilisateur ne devrait jamais avoir à demander "ça a marché ?" ou "et maintenant ?".

Assets (Phase 1 — CLI)

hyperframes figma asset '<url-or-fileKey:nodeId>' [autre refs…] [--format svg|png|jpg|pdf] [--scale 2] [--description "..."] [--entity "..."]

Rend via REST, assainit le SVG, gèle sous .media/images/, ajoute le manifeste avec provenance, régénère .media/index.md (l'inventaire partagé des utilisations de médias), imprime un extrait <img>. Idempotent par fileKey:nodeId:format:scale:version. Préférez SVG pour les vecteurs/logos (évolutif, animable), PNG --scale 2 pour la fidélité raster. Passez toujours --description "<ce que c'est>" (cela devient la ligne d'index + l'attribut <img alt>) ; ajoutez --entity "<nom>" pour les marques nommées afin que la résolution resolve --entity du système de gestion des médias les retrouve plus tard (les correspondances d'entités fonctionnent sur toute image/icône).

Traitez plusieurs nœuds en UNE SEULE requête — passez plusieurs références (séparées par des espaces ou des virgules) du MÊME fichier : hyperframes figma asset 'KEY:1-2' 'KEY:3-4' 'KEY:5-6'. Tous sont rendus en un seul appel /v1/images, ce qui est la réponse de Figma à la limite de débit par minute — préférez-le à N commandes séparées lors de l'extraction d'un ensemble complet d'assets d'une frame. --description/--entity s'appliquent à chaque nœud du lot, donc regroupez les nœuds partageant un objectif. Les 429 sont également réessayés automatiquement avec backoff, indépendamment du format.

Tokens (Phase 2 — CLI)

hyperframes figma tokens <fileKey>

Importe les variables comme entrées de variable de marque de composition + sidecar figma-tokens.json + enregistrements d'index de liaison (.media/figma-bindings.jsonl). Les variables sont limitées à Enterprise côté amont : sur d'autres plans, la commande se dégrade vers les métadonnées de style publié (les valeurs sont résolues au moment de l'importation du composant). Ajoutez les entrées imprimées aux data-composition-variables de la composition.

Importez les tokens avant les composants lorsque les deux sont souhaités — cela permet aux couleurs des composants de se lier aux variables de marque plutôt que de créer des doublons.

Chemin des variables non-Enterprise (testé sur le terrain) : les variables REST sont limitées à Enterprise, mais un connecteur compatible peut fournir des définitions de variables. Lorsque tokens signale REQUIRES_ENTERPRISE et que le connecteur est disponible, récupérez les variables de la scène parente une fois, mettez en cache la réponse brute dans .media/figma-cache/, et utilisez-la pour construire l'index de liaison. Le boundVariables de l'arbre de nœuds REST fournit des VariableID par propriété ; joignez-les par nœud et propriété, puis écrivez des lignes .media/figma-bindings.jsonl ({kind:"binding", figmaId, sourceFileKey, compositionVariableId: "figma:<nom>", version}) plus les entrées de variable de composition. Tout ce qui suit (résolution var() du composant, rafraîchissement, variables CSS d'exécution) est le mécanisme expédié. Étiquetez-le pour l'utilisateur : "tokens via le connecteur Figma — les plans Enterprise obtiennent cela directement depuis hyperframes figma tokens."

Le runtime définit chaque variable de composition déclarée comme une propriété personnalisée CSS (racine du document + hôtes des sous-composants), donc l'importation de var(--slug, littéral) remplit la recoloration lorsque la valeur par défaut de la variable change — mettre à jour une valeur dans data-composition-variables rebrandit chaque composant importé sans réimporter quoi que ce soit. hyperframes render --variables '<json>' les écrase au moment du rendu.

Composants (Phase 3 — CLI)

hyperframes figma component '<url-or-fileKey:nodeId>'

Arbre de nœuds → HTML modifiable aux dimensions exactes de Figma, empaqueté comme élément de registre sous compositions/components/<nom>/. Les vecteurs/opérations booléennes sont automatiquement pixellisés via l'exportation Phase 1. Passe de liaison (spécification §7.1, ID exact uniquement — jamais de correspondance de valeur) :

  • Auto-vérification de la fidélité statique (obligatoire pour le contenu héros) : après l'importation, rendez le fragment et comparez-le aux propres pixels de Figma — figma asset <même node> --format png est la vérité terrain. Le texte est l'axe de dérive connu : une zone de texte Figma plus courte que sa hauteur de ligne a des limites verticalement rognées (le mapper émet text-box-trim pour celles-ci ; la dérive mesurée sans cela était d'environ 6px sur une police de 70px). Si la comparaison montre une dérive que le mapper ne couvre pas, signalez-la — ne modifiez pas le fragment manuellement en silence.
  • Remplissage lié à un token importé → var(--slug, #littéral) — la mise à jour de la marque se propage.
  • Lié à un token inconnu → littéral + indicateur data-figma-unresolved. La commande vous le dit ; proposez à l'utilisateur : exécutez tokens sur le fichier source (ou bibliothèque), puis réimportez le composant pour les lier. Demandez une fois par bibliothèque inconnue quel fichier c'est — ne devinez jamais, ne correspondez jamais par hexadécimal.

Mouvement (Phase 4 — assisté par connecteur)

Balise d'utilisation : Les phases assistées par connecteur n'ont pas de point de contact CLI, donc déclenchez la balise de skill au début et à la fin (anonyme, consentement requis, jamais d'échec) : npx hyperframes events --skill=figma-motion lorsque vous commencez, npx hyperframes events --skill=figma-motion --event=skill_completed --outcome=success|error lorsque vous terminez. Idem pour les shaders (figma-shaders) et les storyboards (figma-storyboard).

Aucun équivalent REST n'existe. Lorsqu'un connecteur compatible est disponible, utilisez-le et transmettez sa sortie aux assistants purs de @hyperframes/core/figma ; sinon, demandez une exportation native :

  1. Récupérez le contexte de mouvement pour la frame parente en une seule requête récursive, pas une requête par élément. Sauvegardez le JSON brut à côté du projet (.media/figma-cache/) afin que la retraduction soit gratuite.
  2. Normalisez en MotionDoc avec motionContextToDocs(rawResponse, { selectorFor, repeat }) de @hyperframes/core/figma — ne transcrivez jamais les numéros d'image clé à la main. L'assistant encode les règles de décodage testées sur le terrain mécaniquement : il analyse les extraits motion.dev (l'encodage fiable — les extraits CSS étirent les durées et peuvent être en désaccord ; ils sont ignorés), supprime les images clés de fin de boucle (les segments sub-millisecondes à des temps ≈0.9999→1 sont la réinitialisation instantanée de la boucle, pas un mouvement créé — la boucle est réalisée par le redémarrage repeat), et préserve les courbes bezier verbatim. selectorFor doit retourner les IDs de l'importation du composant Phase 3 — ne dérivez pas les sélecteurs des noms de nœuds. 2b. Validez par rapport à la vérité terrain avant de déclarer terminé — obligatoire : exportez la frame racine de la cohorte via le connecteur disponible et exécutez node <SKILL_DIR>/scripts/verify-motion.mjs --reference <export.mp4> --render <render.mp4> --crop LxH+X+Y — il compare les deltas d'énergie du mouvement (la fidélité d'importation statique s'annule) et échoue en dessous de 15 dB de PSNR minimal de mouvement (calibré : fidèle ≈ 20+, divergent ≈ 5). Mesurez --crop à partir des bords réels de la carte dans le rendu, ne devinez pas. ÉCHEC signifie revérifier la traduction, pas le seuil.
  3. motionToGsap(doc) → emitTimelineScript(spec) → injectez comme <script> après les balises CDN GSAP + CustomEase. En pause, fini, enregistré sur window.__timelines avec une clé littérale.
  4. Piste intraduisible (pilotée par shader, propriété non prise en charge, masques complexes) → exportez via le connecteur, gelez le MP4, puis intégrez-le comme <video class="clip">. Exception : les pistes pilotées par shader — le chemin d'exportation de Figma aplatit les shaders en couleur de base (voir Shaders ci-dessous), donc une cuisson là-bas perd silencieusement le shader ; demandez à l'utilisateur une exportation Figma native à la place. Dites toujours quel chemin vous avez utilisé et pourquoi. Les easings nommés en dehors de l'ensemble mappé tombent en linéaire — la table de mappage vit dans motionEase.ts ; signalez le repli à l'utilisateur lorsqu'il se déclenche.
  5. Exécutez npx hyperframes check avant de déclarer terminé.

Shaders (Phase 5 — principalement manuelle)

Le chemin de rendu du connecteur Figma n'exécute pas les shaders (ils sont aplatis en couleur de base), et la source du shader n'est accessible que pour les styles publiés en bibliothèque (siège complet payant). Chemin par défaut : demandez à l'utilisateur d'exporter la frame du shader nativement dans Figma (PNG ou Motion MP4), puis importez-la comme asset de Phase 1 / clip. N'essayez pas la capture pixel du connecteur d'un shader — elle produira silencieusement la mauvaise chose.

Storyboards (une SECTION de frames de scène → animation)

La règle cardinale : les frames de storyboard sont des IMAGES CLÉS, pas des diapositives. Deux frames contenant le même élément décrivent l'état de cet élément dans le temps — animez l'ÉLÉMENT entre les états ; ne jouez jamais les frames comme une séquence d'images fixes. Un logo dessiné dans quatre frames consécutives à un y décroissant est UN élément montant à travers quatre images clés. Jouer les frames de storyboard dos à dos est le mode d'échec ; reconstruire les chronologies des éléments qu'elles impliquent est le travail.

Les fichiers de storyboard suivent une grammaire que vous pouvez analyser mécaniquement — ne regardez pas à l'œil, décodez :

  1. Unités de scène : à l'intérieur de la SECTION, chaque nœud de la taille d'une frame est une scène — à la fois les FRAMEs nommées et les RECTANGLEs pleine frame lâches (les designers collent des images fixes directement dans la section). Filtrez par taille (≈ aspect de la composition, p. ex. >1400×900), pas par type de nœud ou nom.
  2. Ordre = position x (principalement par ligne si la bande s'enroule). Triez les scènes par absoluteBoundingBox.x.
  3. Différence entre adjacentes : pour chaque paire de scènes, exécutez la comparaison visuelle via le connecteur ou un pixel diff côté client (numérique : différences de bords de boîtes Englober, changements de position, apparitions/disparitions). À partir de là, déduisez quels éléments sont les mêmes entre les scènes (par nom de nœud, par chemin dans l'arbre, par forme — jamais seulement par position), puis émettez une chronologie qui anime ces éléments entre leurs états.
  4. Aucune durcissement des valeurs : ne générez pas de chronologie qui anime chaque élément séparément. Au lieu de cela, créez une chronologie maître avec des plages par scène, et au sein de chaque plage, animez uniquement les propriétés qui changent par rapport à l'état précédent. Les propriétés inchangées sont laissées comme elles sont (héritées de l'importation du composant Phase 3). Si un élément n'apparaît pas dans une scène, fondez-le/hors dans la transition.
  5. Durée : par défaut, chaque plage de scène dure 2 secondes, avec un chevauchement de 0,3 s pour la transition. Si l'utilisateur spécifie un timing différent, utilisez-le, mais ne demandez pas.

Après la construction, exportez le rendu MP4 et montrez-le à l'utilisateur ; s'il n'est pas satisfait, itérez sur les chronologies plutôt que de réimporter les données brutes.

Respondre aux échecs (tout chemin)

  • L'importation renvoie zéro résultat → cadres ou calques non visibles dans le fichier. Demandez la permission d'ajuster les limites d'exportation ou de déverrouiller les calques.
  • FETCH_ERROR / timeout → le service Figma est temporairement indisponible. Proposez de réessayer après avoir exécuté npx hyperframes check.
  • Le composant s'affiche vide → soit un calque racine transparent sans fond de remplissage, soit un cadre sans largeur/hauteur visible. Demandez à l'utilisateur de vérifier dans l'éditeur Figma.
  • Le chemin du connecteur est introuvable ou ne répond pas → dites que le mouvement/les shaders ne peuvent pas être importés électroniquement pour l'instant, demandez une exportation native Figma, et dites à l'utilisateur que les phases 1 à 3 restent entièrement disponibles via l'API REST immédiatement.

Individual skills in this repo

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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

laviedezidane/hyperframes-skill

Agent Media OS for 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. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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.

laviedezidane/hyperframes-skill

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