Communitygithub.com

samyakiasonline-ctrl/hyperframe

Transformez une pull request GitHub (URL, owner/repo#N ou « cette PR » dans un dépôt cloné) en une vidéo explicative du changement de code : journal des modifications, présentation de fonctionnalité, correction ou analyse de refactorisation construite à partir du diff, des commits et des fichiers. L'entrée est un changement de code, pas un site web. Ce n'est pas une promo produit (/product-launch-video) ni une explication sans PR (/faceless-explainer). En cas de doute → /hyperframes.

Qu'est-ce que hyperframe ?

Cette compétence permet de créer une vidéo explicative à partir d'une pull request GitHub, en transformant automatiquement le diff, les commits et les fichiers modifiés en un storyboard visuel et narratif. Elle est conçue pour les développeurs et les équipes techniques souhaitant documenter ou présenter des changements de code de manière professionnelle, sans nécessiter de capture d'écran manuelle. La compétence orchestre un pipeline complet : ingestion des données PR, création d'un système de design « code-éditorial », rédaction d'un script et d'un storyboard, génération audio (voix et musique), construction des frames HTML, et rendu final de la vidéo. Elle prend en charge les PR ouvertes ou fusionnées, avec un support automatique des avatars des contributeurs. Le workflow est structuré en étapes avec des points de validation, et peut fonctionner en mode autonome ou collaboratif.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/samyakiasonline-ctrl/hyperframe/tree/HEAD/.claude/skills/pr-to-video

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 mise à jour, suivez les règles d'exécution du plugin lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.

Tout d'abord, gardez cette compétence à jour — confirmez avec l'utilisateur avant d'exécuter : npx hyperframes skills update pr-to-video. Rapide et sans effet si tout est à jour ; sinon, cela rafraîchit cette compétence ainsi que les compétences du domaine central dont elle dépend avant que vous ne les utilisiez.

media-use : Avant de sourcer des éléments audio/images/logos, appelez /media-use pour résoudre les BGM/SFX/images du catalogue HeyGen et les logos de marque depuis leurs sources officielles. Exécutez --adopt d'abord pour enregistrer les actifs existants. Voir la compétence /media-use.

PR vers HyperFrames

Utilisez cette compétence pour ingérer une pull request GitHub, comprendre le changement, planifier une vidéo explicative du changement de code, et la construire frame par frame dans HyperFrames. L'entrée est un changement de code (lu via gh), pas un site web — il n'y a pas d'étape de capture ni d'actifs réels en dehors des avatars des contributeurs.

La porte d'entrée est /hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa porte, et seulement ensuite continuez. Cette compétence est pour une pull request GitHub (un changement de code). Toute autre intention, un simple « faire une vidéo », ou toute incertitude → lisez d'abord /hyperframes — la couche d'intention possède chaque décision de routage, et une création fraîche arrivant ici sans BRIEF.md passe de toute façon par elle (règle d'ouverture de Configuration).

Vous êtes l'orchestrateur. Travaillez dans le répertoire externe résolu PROJECT_DIR, jamais dans le dépôt appelant par défaut. Exécutez les étapes dans l'ordre et passez chaque porte avant de continuer. Les étapes gérées par l'utilisateur sont l'Étape 0, l'Étape 3 et l'Étape 6. Lisez ../hyperframes/references/brief-contract.md avant l'Étape 0 — il définit les types de portes et comment le flow/storyboard de BRIEF.md dérivent le mode qui régit les portes des Étapes 3/4/6. Faites chaque étape vous-même sauf l'Étape 5, où vous répartissez un groupe limité de travailleurs de frames. Ne placez pas de règles de conception ou de mouvement ici ; elles vivent dans le sous-agent travailleur de frame, le ../hyperframes-animation/rules/ local de cette compétence + ../hyperframes-animation/blueprints/, et hyperframes-creative.

Flux de travail : Étape 0 configuration → hyperframes.json ; Étape 1 ingestion → capture/extracted/ + assets/<login>.png ; Étape 2 système de design → frame.md ; Étape 3 storyboard/script → STORYBOARD.md et SCRIPT.md ; Étape 3.1 audio → audio_meta.json ; Étape 4 design visuel → STORYBOARD.md enrichi ; Étape 5 frames → compositions/frames/NN-*.html et index.html ; Étape 6 rendu final → renders/video.mp4.


Étape 0 : Configuration

Objectif : Entrer avec un brief confirmé — incluant la référence PR (une URL complète, une référence <propriétaire>/<dépôt>#<N>, ou « cette PR » dans un dépôt cloné) — créer le projet HyperFrames, et rendre le brief durable. Le style est toujours code-éditorial (fixé à l'Étape 2, jamais demandé).

Le brief est confirmé par la couche d'intention, pas par des questions posées ici. Règle d'ouverture, dans l'ordre : (1) BRIEF.md existe → lisez-le et ne demandez rien — le brief est réglé, et son flow/storyboard dérivent le mode (contrat de brief § 1). (2) Pas de BRIEF.md mais le projet existe (hyperframes.json / STORYBOARD.md sur le disque) → reprenez à partir du frontmatter du storyboard et des préférences enregistrées ; ne réinterrogez jamais un projet à moitié construit. (3) Ni l'un ni l'autre — une demande de création fraîche arrivée ici directement → lisez /hyperframes et exécutez sa couche d'intention (references/intent-interview.md) : elle vérifie les recettes et les valeurs par défaut mémorisées, et mène les questions de cette route — y compris la doctrine taille-de-la-PR → longueur, qui réside entièrement dans ../hyperframes/references/routes/pr-to-video.md — puis renvoie le brief verrouillé. Les demandes de modification ignorent tout cela — allez faire la modification.

Résolvez le répertoire du projet avant de faire tout autre travail. Préservez un répertoire de projet fourni par l'utilisateur ; sinon, utilisez l'emplacement de cache externe durable imprimé par le résolveur. Ne créez jamais videos/ dans le dépôt appelant :

PR="<url | propriétaire/dépôt#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "Projet PR vers vidéo : $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs

La vérification préalable des capacités s'exécute avant la récupération, le travail sur le storyboard, l'audio ou la répartition des frames. Si le CLI installé ne peut pas exécuter la commande de validation requise par cette compétence, arrêtez-vous avec ses instructions de mise à niveau plutôt que de dépenser le contexte de l'exécution d'abord.

Initialisez seulement si $PROJECT_DIR/hyperframes.json est manquant. Son nom de base vient de la PR, comme acme-sdk-pr-1842 ; n'utilisez jamais le nom de l'espace de travail ou un horodatage.

npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video — init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si l'une d'elles est obsolète.

Chaque commande de chemin relatif ci-dessous s'exécute avec $PROJECT_DIR comme répertoire de travail. Les exemples sans sous-shell explicite signifient (cd "$PROJECT_DIR" && …) ; ne modifiez jamais l'arborescence de travail du dépôt appelant.

Écrivez BRIEF.md immédiatement après init (jamais avant — init refuse un répertoire non vide) : le brief verrouillé de la couche d'intention, format selon ../hyperframes/references/brief-format.md. Résolvez <MEDIA_DIR> comme le répertoire d'installation de la compétence /media-use. Ensuite, enregistrez chaque réponse basée sur une préférence avec node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomme le sous-ensemble). Si la couche d'intention a adopté une recette, exécutez node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <nom> ; elle copie son frame.md dans le projet (l'Étape 2 est alors ignorée) et retourne les squelettes à partir desquels l'Étape 3 rédige. Une recette remplit les réponses, pas les approbations ; les portes de révision s'exécutent toujours.

Affichez l'état de connexion avant de continuer au-delà de la Configuration — exécutez npx hyperframes auth status et relayez sa sortie textuellement. Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, lorsqu'il est déconnecté, comment se connecter. Appliquez une branche :

  • Collaboratif : attendez que l'utilisateur se connecte ou choisisse explicitement offline / go.
  • Autonome : indiquez l'état et continuez via les moteurs locaux disponibles.

N'omettez pas silencieusement une capacité requise lorsqu'aucun fournisseur hors ligne n'existe ; faites apparaître le blocage. Ne pliez pas cette décision dans une autre question et n'écrivez pas de clés dans un .env par dépôt. Propriété de l'authentification et solutions de repli hors ligne : /media-use references/setup-providers.md § Fournisseurs.

Porte : hyperframes.json et BRIEF.md existent ; la référence PR est capturée dans le brief ; les réponses basées sur les préférences ont été enregistrées (contrat de brief § 2) ; l'état de connexion a été affiché (connecté, ou continuation hors ligne).


Étape 1 : Ingérer la PR (pas de capture)

Objectif : Récupérer les faits de la PR et les intégrer dans le projet comme source d'information. Il n'y a pas de capture de site web. fetch-pr.mjs exécute gh de manière déterministe — complétant la liste des fichiers via gh api paginé afin qu'une grande PR ne soit pas tronquée à ~100 fichiers, et écrivant seulement capture/pr.json + capture/diff.patch (pas de répertoire temporaire). Pour les PR FUSIONNÉES, il résout également un shipped_version au mieux (+ version_source) dans pr.json, afin que la carte de fin puisse citer une version réelle au lieu d'en inventer une. Ensuite, ingest.mjs intègre cela dans le package de capture synthétique hors ligne.

PR="<url | propriétaire/dépôt#N | N>"

# Récupère la PR de manière déterministe : exécute gh, complète la liste des fichiers via gh api paginé
# (afin qu'une grande PR ne soit pas tronquée à ~100 fichiers), écrit seulement capture/pr.json +
# capture/diff.patch — pas de répertoire temporaire. Les erreurs gh auth / introuvable / privé quittent avec le code 1 ici.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)

# Transformation hors ligne → capture/extracted/{tokens.json (couleurs:[] → palette code-éditoriale),
# visible-text.txt (le brief), people.json (contributeurs, filtrés par bot, nom+login,
# avatarFile=assets/<login>.png)}.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
  --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)

# La seule étape réseau pour les personnes — télécharge l'avatar GitHub de chaque contributeur vers
# assets/<login>.png pour le générique de fin. Au mieux ; quitte toujours avec le code 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

Si fetch-pr.mjs quitte avec le code 1 (gh auth / introuvable / privé), signalez sa sortie d'erreur et arrêtez-vous — ne fabriquez pas le contenu de la PR. Si ingest.mjs quitte avec le code 1, lisez sa sortie d'erreur (généralement un pr.json malformé), corrigez et réexécutez (déterministe). fetch-people-avatars.mjs quitte toujours avec le code 0 ; les avatars manquants signifient simplement qu'il n'y aura pas de générique de fin pour l'auteur.

people.json porte un name pour les contributeurs que gh a déjà nommés (l'auteur de la PR, les auteurs de commits, mergedBy) — null pour les autres (relecteurs/commentateurs/assignés, pour lesquels gh pr view ne donne jamais qu'un login brut). Avant d'écrire le générique de fin à l'Étape 3, résolvez vous-même tout name null pour les 1 à 6 personnes qui apparaîtront réellement sur cette frame : gh api users/<login> --jq .name (vous avez déjà gh — pas besoin de script). Si GitHub n'a pas de nom public pour cet utilisateur non plus, revenez au login à l'écran et retirez cette personne de la ligne parlée (voir la section crédits de story-design.md — le voiceover doit toujours dire les noms, jamais les handles bruts).

Porte : capture/pr.json, capture/diff.patch, capture/extracted/tokens.json, capture/extracted/visible-text.txt et capture/extracted/people.json existent ; vous pouvez énoncer le changement de la PR en une phrase claire. assets/<login>.png est au mieux — son absence n'est pas un échec.


Étape 2 : Système de Design

Objectif : Adopter le preset de frame code-éditorial ; un script le transforme en frame.md + skin de légende de cette vidéo.

Le style est fixe — code-éditorial (éditorial chaud ; une surface de code marine conçue pour les diffs). Exécutez :

node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .

Le script copie le FRAME.md du preset code-éditorial → frame.md, le remixe sur tous les tokens de marque dans capture/extracted/tokens.json (une PR n'en a aucun → couleurs:[]/polices:[] conserve la palette propre du code-éditorial, un design complet), copie le skin de légende du preset vers .hyperframes/caption-skin.html, et s'auto-valide (quitte avec le code 1 sur une correspondance brisée). Procédez dès qu'il quitte avec le code 0 — pas d'édition manuelle.

Porte : build-frame.mjs a quitté avec le code 0 — frame.md existe depuis le preset code-éditorial, et .hyperframes/caption-skin.html existe comme source du skin de légende.


Étape 3 : Storyboard et Script

Objectif : Transformer la PR en un plan d'explication frame par frame approuvé.

Lisez ../hyperframes-creative/references/story-spine.md (langage d'accroche, valeur avant preuve, storyboard comme proposition, visuels traçables à la source), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md et ../hyperframes/references/script-format.md. Utilisez-les pour écrire STORYBOARD.md et, lorsque la narration est nécessaire, SCRIPT.md. Définissez la duration: du frontmatter d'après la length du brief — une attente approximative ; l'assemblage indique où la coupe atterrit par rapport à celle-ci.

Utilisez story-design.md pour l'archétype de la PR (journal des modifications / présentation de fonctionnalité / explication de correction / analyse de refactorisation), les types de frames natifs de la PR, l'accroche, la persuasion, les beats, le budget de mots par frame et le générique de fin. La séquence vient de la conception narrative, pas de l'ordre des fichiers du diff — expliquez le changement, ne lisez pas le diff à voix haute. En tant que guide souple, consultez le menu rôle→blueprint dans ../hyperframes-animation/blueprints-index.md : pour chaque beat, écrivez le voiceover dans la forme qu'implique son blueprint candidat et étiquetez cet identifiant blueprint: lorsqu'un correspond (la vérité du storyboard décide toujours quels beats existent — ne forcez jamais un beat à correspondre à une forme). Présentez 2 à 4 morceaux de diff réels (depuis capture/diff.patch), chacun un petit extrait lisible ; nommez le bloc code-* que chacun veut dans la scene de la frame. Les frames ne portent aucun asset_candidates sauf le générique de fin credits (1 à 6 avatars assets/<login>.png). Utilisez les champs obligatoires exacts des références du storyboard et du script.

Après la rédaction, exécutez le passage de plan de la boucle de révision — ../hyperframes/references/review-loop.md § 1 : présentez le plan comme une proposition et posez les deux questions — approuvez ou modifiez, et croquis d'abord (recommandé) ou sautez. Les retours arrivent sous forme de réponse de chat ; bouclez jusqu'à approbation. Ceci est une porte de point de contrôle (contrat de brief § 1) : en mode autonome, il n'y a rien à demander — publiez le même résumé en tant que notification et continuez ; les croquis se fondent dans la construction, et l'aperçu final avec sa question unique vient à l'Étape 6.

Porte : STORYBOARD.md existe, chaque frame a les champs narratifs requis, SCRIPT.md existe lorsque la narration est nécessaire, et l'utilisateur a approuvé le plan (autonome : le résumé a été publié en tant que notification).


Étape 3.1 : Audio

Objectif : Générer la narration, les timings des mots, la musique et les métadonnées audio à partir du script approuvé.

Lancez l'audio après l'approbation de l'Étape 3. Exécutez-le en arrière-plan, puis continuez à l'Étape 4.

Choisissez la voix de narration à partir de la demande de l'utilisateur avant d'invoquer. Si la demande a nommé une voix, un genre ou un ton, choisissez un identifiant de voix correspondant et passez-le avec --voice <id>. La valeur par défaut du pipeline est autrement Marcia (féminine) sur HeyGen / am_michael sur Kokoro — donc une demande comme « une voix masculine » est ignorée silencieusement sauf si vous passez le drapeau. Les identifiants de voix sont spécifiques au fournisseur ; résolvez par rapport au fournisseur que l'état de connexion de l'Étape 0 a sélectionné : HeyGen (connecté) via node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (ou GET /v3/voices?engine=starfish) ; Kokoro (hors ligne) via la table des voix dans <MEDIA_DIR>/audio/references/tts.md (préfixes am_/bm_ masculin, af_/bf_ féminin). Lorsque l'utilisateur n'a exprimé aucune préférence, revenez à la voix mémorisée (contrat de brief § 2) avant la valeur par défaut du pipeline.

Générez l'audio complète du script :

# 1. TTS paragraphe par paragraphe → fichiers WAV dans le répertoire des pistes
node <MEDIA_DIR>/audio/scripts/synthesize-script.mjs \
  --script ./SCRIPT.md \
  --storyboard ./STORYBOARD.md \
  --voice <id> \
  --provider <heygen|kokoro> \
  --out-dir ./audio/tracks

# 2. Générer les timings des mots (pour le sous-titrage/Karaoké)
node <MEDIA_DIR>/audio/scripts/word-timings.mjs \
  --tracks ./audio/tracks \
  --script ./SCRIPT.md \
  --out ./audio/word_timings.json

# 3. Choisir la musique de fond via /media-use (appelez la compétence /media-use)
#    (La compétence /media-use gère la sélection BGM)

# 4. Mélanger narration + BGM → piste finale
node <MEDIA_DIR>/audio/scripts/mix-audio.mjs \
  --tracks ./audio/tracks \
  --bgm ./audio/bgm.wav \
  --out ./audio/final_mix.wav

Porte : ./audio/tracks/ contient un fichier WAV par paragraphe de script ; ./audio/word_timings.json contient les timings des mots ; le mixage final ./audio/final_mix.wav et les métadonnées ./audio/audio_meta.json (chemins des pistes, BGM, durée, etc.) existent.


Étape 4 : Conception Visuelle

Objectif : Enrichir le storyboard avec des spécifications visuelles détaillées — mise en page, animations, transitions et composition de chaque frame.

Lisez ../hyperframes-animation/rules/ pour les modèles d'animation et les règles de composition. Enrichissez STORYBOARD.md avec des champs visuels pour chaque frame :

  • layout : La disposition des éléments (ex. split-screen, top-code-bottom-caption, full-frame)
  • animation : L'animation d'entrée/sortie pour la frame (ex. fade-in, slide-left, scale-up)
  • transition : La transition entre les frames (ex. cut, crossfade, slide)
  • composition : Description détaillée de ce qui apparaît à l'écran et où

Utilisez les blueprints de ../hyperframes-animation/blueprints/ comme modèles pour les types de frames courants (ex. code-diff, architecture-diagram, credits). Chaque frame doit avoir un visual_type correspondant à un blueprint.

# Valider l'enrichissement visuel du storyboard
node <SKILL_DIR>/scripts/validate-visuals.mjs \
  --storyboard ./STORYBOARD.md \
  --rules ../hyperframes-animation/rules/

Porte : STORYBOARD.md a des champs visuels pour chaque frame, validés par le script. L'utilisateur a approuvé le design visuel (ou notification en mode autonome).


Étape 5 : Frames (Réparties aux Travailleurs)

Objectif : Construire chaque frame en tant que fichier HTML indépendant avec CSS/JS embarqués, puis les assembler en une séquence.

Vous ne faites pas les frames vous-même. Vous répartissez un groupe limité de travailleurs de frames (sous-agents). Chaque travailleur reçoit une frame spécifique du storyboard enrichi et ses règles de conception, et produit un fichier HTML dans compositions/frames/.

# Créer le répertoire de sortie des frames
mkdir -p "$PROJECT_DIR/compositions/frames"

# Répartir les frames aux travailleurs (appelez l'API du sous-agent pour chaque frame)
# Syntaxe : node <SKILL_DIR>/scripts/dispatch-frames.mjs <storyboard> <output-dir>
node <SKILL_DIR>/scripts/dispatch-frames.mjs \
  --storyboard ./STORYBOARD.md \
  --rules ../hyperframes-animation/rules/ \
  --blueprints ../hyperframes-animation/blueprints/ \
  --out-dir ./compositions/frames

# Générer l'index.html qui séquence les frames
node <SKILL_DIR>/scripts/build-sequence.mjs \
  --frames-dir ./compositions/frames \
  --timings ./audio/word_timings.json \
  --out ./compositions/index.html

Le script de dispatch crée un fichier compositions/frames/NN-description.html pour chaque frame (NN = numéro de frame à deux chiffres). Chaque fichier HTML est autonome avec CSS/JS embarqués. build-sequence.mjs génère index.html qui charge les frames dans l'ordre avec les timings audio.

Porte : Tous les fichiers compositions/frames/NN-*.html existent, compositions/index.html existe et s'affiche correctement dans un navigateur.


Étape 6 : Rendu Final

Objectif : Rendre la séquence de frames en fichier vidéo MP4 avec l'audio synchronisé.

node <SKILL_DIR>/scripts/render-video.mjs \
  --frames ./compositions/index.html \
  --audio ./audio/final_mix.wav \
  --timings ./audio/word_timings.json \
  --hyperframes . \
  --out ./renders/video.mp4

Le script de rendu :

  1. Capture chaque frame depuis index.html aux timings spécifiés (headless Chromium).
  2. Superpose le skin de légende depuis .hyperframes/caption-skin.html en utilisant les timings des mots.
  3. Synchronise les images avec la piste audio finale.
  4. Produit renders/video.mp4.

Passage de la porte finale : Lancez l'aperçu et montrez-le à l'utilisateur. Posez la seule question : « Approuvez-vous cette vidéo ? Si vous souhaitez des modifications, dites-les maintenant. » Les révisions peuvent renvoyer à n'importe quelle étape antérieure. En mode autonome, l'aperçu est montré comme statut final et une confirmation est attendue.

Porte finale : L'utilisateur a approuvé la vidéo finale. renders/video.mp4 est la sortie livrable.


Références

  • ../hyperframes/references/brief-contract.md — Contrat de brief, portes et types de modes
  • ../hyperframes/references/storyboard-format.md — Format du storyboard
  • ../hyperframes/references/script-format.md — Format du script
  • ../hyperframes/references/review-loop.md — Boucle de révision
  • ../hyperframes-creative/references/story-spine.md — Principes de narration
  • ../hyperframes-animation/blueprints-index.md — Index des blueprints
  • ../hyperframes-animation/rules/ — Règles d'animation
  • ../hyperframes-animation/blueprints/ — Blueprints de composition
  • /media-use — Compétence de médias (audio/images/logos)

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

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.

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

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