Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Utilisez cette compétence lorsque l'audio déjà placé dans une composition HyperFrames doit être mixé : fondus, gain de piste, automatisation de volume, ducking, sculpture de voie off, effets sur une piste, bus de sous-mix. Ne l'utilisez pas pour sourcer ou générer de l'audio, ni pour le timing des clips.

Qu'est-ce que hyperframes-instruct ?

Cette compétence pour HyperFrames est dédiée au mixage avancé d'audio déjà positionné dans une composition. Elle permet d'appliquer des fondus (entrée/sortie, fondu enchaîné), de régler le gain ou le volume des pistes, de créer des automatisations de volume et d'effets, ainsi que des techniques de ducking et de sculpture de la voie off (voiceover carve). Elle supporte également l'ajout d'une chaîne d'effets complète sur une piste (égaliseur, compresseur, limiteur, gate, saturation, delay, reverb, chorus, phaser, bitcrush). Son utilité principale réside dans la gestion des relations entre les pistes audio. Plutôt que d'empiler des processeurs, elle exprime comment les éléments interagissent pour créer un mix cohérent. La sculpture de voie off, par exemple, n'atténue pas toute la musique de fond, mais seulement les bandes de fréquence qu'occupe la voix, préservant ainsi l'intégrité du morceau musical. La compétence s'intègre parfaitement dans l'écosystème HyperFrames. Les effets sont définis via l'attribut `data-fx-chain`, les enveloppes d'automatisation via `data-automation`et les réglages de sculpture via `data-fx-carve`. Le rendu et la prévisualisation utilisent le même graphe audio Web Audio, garantissant que ce que vous entendez pendant l'édition correspond à ce qui sera rendu. Elle fonctionne avec les piste audio/vidéo et le bus `<hf-audio-group>` pour gérer plusieurs pistes simultanément. Enfin, cette compétence inclut un cadre de diagnostic pour analyser les problèmes audio lorsque vous ne pouvez pas les écouter. Elle fournit des tables de symptômes et des préréglages pour des problèmes courants comme la boue, l'étouffement, l'agressivité ou les collisions voix/musique.

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

Demander à votre IA préférée

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

Documentation

Installations de plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'installation des plugins lorsque cette compétence se trouve à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.

Audio HyperFrames

Un mix est un ensemble de relations, pas une pile de processeurs. Deux pistes qui sonnent bien séparément peuvent être inécoutables ensemble, et la solution n'est presque jamais "baisser l'une" — il s'agit de trouver sur quoi elles se battent et de le donner à celle qui en a besoin. Chaque outil ici existe pour exprimer une de ces relations.

Les effets vivent sur l'élément en tant que data-fx-chain, et la prévisualisation et le rendu utilisent le même graphe Web Audio — le studio dans un contexte live, le moteur dans un contexte hors ligne dans le navigateur qu'il pilote déjà. Il n'y a qu'une seule implémentation de chaque effet, donc ce que vous entendez en déplaçant la tête de lecture est ce qui est écrit. Vous ne réglez jamais deux fois.

Le timing des clips reste du ressort de /hyperframes-core : les coupes audio/vidéo et les plages sources utilisent data-start, data-duration et data-media-start, et les fondus enchaînés superposent les clips sur différentes pistes. Cette compétence gère les fondus d'entrée/sortie des pistes placées, les enveloppes de fondu enchainé, le gain/volume des pistes, l'automatisation du volume et des effets, le ducking/la sculpture de la voie off, et la chaîne d'effets. /media-use gère la source, la génération et le prétraitement.

La constante data-playback-rate (0.1..10) est sûre pour le rendu de l'image et du son préservant la hauteur tonale lorsque les éléments audio/vidéo correspondants utilisent le même timing, le même décalage source et le même taux. Un rampe de vitesse est une voie rate dans data-automation (voir docs/reference/speed-ramps) ; elle l'emporte sur la constante et préserve le pitch dans la prévisualisation et le rendu. HyperFrames ne fournit pas de synchronisation automatique des formes d'onde ou de correction de dérive. Pour des recettes copiables de coupe/fondu enchaîné/recalage temporel, utilisez /hyperframes-core → references/creator-editing-recipes.md.

Trois attributs portent tout, sur l'élément audio/vidéo lui-même — ou, pour les deux premiers, sur un bus <hf-audio-group> (voir "Un bus pour plusieurs pistes") :

AttributContient
data-fx-chainles effets, dans l'ordre du signal
data-automationles enveloppes sur le volume de cette piste ou ses paramètres d'effet
data-fx-carveles propres réglages de la sculpture, pour pouvoir être redérivée

Les familles d'effets fournies sont le gain, l'égaliseur (passe-haut, passe-bas, pic, shelving), le compresseur, le limiteur, le gate, la saturation, le delay, la reverb, le chorus, le phaser et le bitcrush.

JSON exact pour chacun, et les règles qu'une voie doit satisfaire : references/attributes.md. Chaque effet avec ses paramètres, plages et unités : references/fx-registry.md. Comment déterminer ce qui cloche dans un fichier que vous ne pouvez pas entendre : references/diagnosis.md. Presets, travaux nommés et profils à un bouton, plus un tableau symptôme-solution : references/presets.md — lisez-le avant de construire une chaîne à la main, car un des presets ou travaux nommés nomme généralement déjà le problème.

Comment tout s'assemble

Deux surfaces d'édition écrivent ces attributs ; deux environnements d'exécution les lisent via les mêmes constructeurs. Ce moyen partagé est la raison pour laquelle la prévisualisation prédit le rendu.

flowchart TB
  voice["piste voix<br/>fichier média"]
  bed["piste musique de fond<br/>fichier média"]

  subgraph AUTHOR["Édition — les seules choses qui écrivent les attributs"]
    panel["Studio<br/>Contrôle de sculpture de voie off"]
    script["scripts/carve.mjs<br/>détecte la paire"]
    analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
    panel --> analysis
    script --> analysis
  end

  voix --> analysis
  bed --> analysis

  subgraph ATTRS["Écrit sur l'élément de la musique de fond"]
    carveAttr["data-fx-carve<br/>sources · strength"]
    chainAttr["data-fx-chain<br/>pic xN + gain, tagué fromCarve"]
    autoAttr["data-automation<br/>une voie par paramètre sculpté"]
  end

  analysis --> carveAttr
  analysis --> chainAttr
  analysis --> autoAttr

  subgraph SHARED["Une implémentation, lue par les deux"]
    build["audioFxGraph.ts · buildFxChain"]
    sched["audioFxAutomation.ts · scheduleChainAutomation"]
  end

  chainAttr --> build
  autoAttr --> sched

  build --> preview["Prévisualisation<br/>AudioContext live<br/>attachElementFxChain"]
  sched --> preview
  build --> render["Rendu<br/>OfflineAudioContext dans le navigateur sans tête<br/>applyAudioFxChain"]
  sched --> render

  preview --> entendu["ce que vous entendez en déplaçant la tête de lecture"]
  render --> wav["WAV traité<br/>+ chainTailSeconds pour que le mix laisse passer la queue"]
  wav --> mix["moteur · audioMixer<br/>voie de volume cuite dans le PCM ici, pas dans le graphe"]
  mix --> out["le mix rendu"]

  edit["modification de l'attribut en pleine lecture"] -.->|MutationObserver| preview

Les propres réglages de la sculpture ne sont jamais lus à la lecture — la chaîne et les voies qu'elle a produites sont ce qui est joué. data-fx-carve existe pour que la force puisse être modifiée sur une sculpture existante au lieu d'être déduite des filtres.

À l'intérieur d'une musique de fond sculptée, le signal traverse d'abord les creux, puis l'ajustement de niveau, puis tout ce que vous avez construit vous-même — c'est pourquoi un limiteur que vous ajoutez agit toujours comme le plafond final :

flowchart LR
  src["musique de fond décodée"] --> p1["pic<br/>400 Hz"]
  p1 --> p2["pic<br/>1 kHz"]
  p2 --> p3["pic<br/>1.6 kHz"]
  p3 --> g["gain<br/>ajustement de niveau"]
  g --> main["vos propres effets<br/>ex. limiteur"]
  main --> dest["gain de piste, puis sortie"]

  l1["voie fx.n1.gain"] -.->|"enveloppe du niveau de la voix<br/>dans cette bande"| p1
  l4["voie fx.n4.gain"] -.->|"à quel point la musique de fond<br/>s'atténue globalement"| g

D'abord, déterminer ce qui cloche

Le tableau ci-dessous part de "ça sonne sourd" — ce qui suppose que quelqu'un a déjà écouté et l'a dit. Si on vous donne un fichier avec "répare ça", vous n'avez pas cette phrase et vous ne pouvez pas écouter, vous devez donc mesurer. Une règle gouverne tout cela :

Le spectre absolu d'une voix unique inconnue ne peut pas être diagnostiqué. Les formants sont à ±10 dB, les fondamentales vont de 85 à 255 Hz, et les phrases déclinent de 5 à 6 dB en finissant. Chacun de ces éléments apparaît comme un défaut à lui seul, et chacun d'eux est le locuteur.

Donc comparez, et comparez par rapport à quelque chose dans le même fichier : l'original propre s'il existe, sinon les pauses — tout ce qui est audible dans un silence est additif, et le spectre du silence est celui du canal plutôt que de la voix. Comparer à un spectre moyen publié ou à une voix de contrôle synthétisée ne fonctionne pas : deux locuteurs diffèrent plus que la plupart des défauts, et les deux mauvaises réponses dans l'évaluation qui a conduit à ces conseils provenaient exactement de cela.

Lorsqu'il n'y a ni original ni silence utilisable, un défaut tonal statique est véritablement sous-déterminé. Dites-le et proposez les lectures qui correspondent, plutôt que d'en choisir une et de construire une chaîne dessus.

Commandes, pièges et recettes éprouvées : references/diagnosis.md. Lisez-le avant de diagnostiquer un fichier que personne n'a décrit.

Partez du symptôme

Une fois que vous connaissez la bande et le type, nommez ce qui cloche dans l'audio. La plupart des mauvais audios sont un ou deux de ceux-ci, et chacun a une réponse fournie :

Cela ressemble à...Utilisez
Bourdonnement ou cognement en dessousrumble-cut, ou un highpass à 80 Hz
Sourd, dans la poitrineApprivoiser la sourdité job (200 Hz)
Étouffé, derrière du cartonRéduire la boue job (250 Hz)
Les mots difficiles à distinguerAjouter de la clarté job (3 kHz), ou sculpter la musique de fond
Dur et fatigantAdoucir la dureté job (3.2 kHz)
Certains mots beaucoup plus forts que d'autresUniformité sur un compresseur, ou Niveler les niveaux
Résonance de la pièce entre les phrasesroom-gate
La voix et la musique se battentSculpture de voie off — pas un EQ sur l'une ou l'autre
Sec, enregistré nulle partroom-tight ou room-natural
Juste "amateur"voice-clean, qui est quatre des ci-dessus dans l'ordre

Catalogue complet, ce que contient chaque preset, le vocabulaire des bandes, et ce qui n'est délibérément PAS couvert (dé-essing, suppression de bruit, correspondance tonale) : references/presets.md.

Soustrayez avant d'ajouter, nivelez après avoir filtré, relations après le niveau, caractère et plafond en dernier. Chaque étape change ce que la suivante entend — un compresseur réglé avant un passe-haut passe son temps à poursuivre le grondement.

Attaquez-vous à une famille par le problème, pas par le nom

Filtres (highpass, lowpass, peaking, lowshelf, highshelf) décident quelles fréquences une piste est autorisée à occuper. C'est le premier outil pour deux sources qui entrent en collision, car les collisions se produisent en bandes : une musique de fond et une voix veulent toutes deux 1-3 kHz, et retirer cela à la musique de fond coûte bien moins à la musique de fond que de baisser le tout coûte au mix. Un passe-haut sur une voix est la solution standard pour le grondement ; un passe-bas assombrit ou étouffe délibérément.

Dynamiques (gain, compressor, limiter, gate) décident comment le niveau d'une piste se comporte dans le temps. La compression réduit la distance entre le fort et le faible afin que les parties faibles puissent monter. Un limiteur est un plafond — il ne façonne rien, il garantit que rien ne dépasse. Un gate supprime ce qui est en dessous d'un seuil, c'est ainsi que l'on fait taire la résonance de la pièce entre les phrases. gain est une simple étape de niveau, et c'est ce qu'une voie d'automatisation utilise lorsqu'une piste doit se retirer.

Non linéaires (saturate, bitcrush) modifient la forme de l'onde, ce qui ajoute des harmoniques qui n'étaient pas là. Utilisez-les lorsqu'une piste a besoin de caractère ou de grain plutôt que de correction — et rappelez-vous que c'est génératif : cela rend une source fine plus dense, pas plus propre.

Temporels (delay, reverb, chorus, phaser) placent une piste dans un espace ou lui donnent de la largeur. Ce sont ceux qui peuvent le plus facilement gâcher un mix, car une queue ou une copie désaccordée occupe le même espace qu'une voix a besoin. Utilisez-les sur l'élément qui doit se trouver derrière quelque chose d'autre, et gardez la quantité de traitement plus faible qu'elle ne sonne juste isolément.

La chaîne est en série : chaque effet traite ce que le précédent a produit. Ainsi, le filtrage correctif va tôt, le caractère au milieu, et un limiteur en dernier où il peut effectivement agir comme un plafond.

Sculpture de voie off

Le problème qu'elle résout. Une musique de fond sous une voix rend la voix difficile à suivre. Le réflexe est de réduire le volume de toute la musique de fond, ce qui fonctionne et coûte à la musique de fond toute sa présence — la musique devient molle pendant toute la voix off. Mais la voix n'a pas besoin de tout le spectre. Elle a besoin des quelques bandes qu'elle occupe réellement. La sculpture ne prend que celles-ci, et la musique de fond conserve ses basses et ses aigus, donc c'est toujours de la musique tandis que la voix reste intelligible.

C'est une relation, pas un effet. Les réglages vivent sur la musique de fond — la piste qui est traitée — et ils nomment les voix à écouter, exactement comme un compresseur sidechain : vous sélectionnez la piste qui devient plus silencieuse et choisissez ce qui la rend plus silencieuse. Ne mettez jamais une sculpture sur une piste de voix. Une voix sculptée contre elle-même est un bogue, pas un choix de mix subtil.

Chaque voix, pas une seule. sources est une liste, car une musique de fond passe généralement sous toute une séquence — un narrateur, une réponse d'interview, un second présentateur. Ils sont additionnés sur l'horloge propre de la musique de fond avant que quoi que ce soit ne soit mesuré (mixCarveSources), donc une analyse les couvre tous : les bandes proviennent de tout le discours présent, et les enveloppes montent partout où il se produit. Les voix qui ne jouent jamais pendant que la musique de fond joue sont laissées de côté ; elles ne peuvent pas la masquer.

Une sculpture contre plus d'un identifiant de clip est erronée. Regroupez les clips et sculptez contre le groupe. C'est un invariant, pas un conseil. Nommer les clips un par un doit être exhaustivement juste et ne reste juste que jusqu'à la prochaine édition — un quatrième clip de narration ajouté plus tard joue en dehors de la conscience de la sculpture, et la musique de fond ne parvient pas à s'atténuer silencieusement en dessous. Nommer le groupe à la place résout l'appartenance au moment de l'analyse, donc un clip ajouté au groupe plus tard est couvert sans toucher du tout à sources :

<!-- regroupez la narration, puis sculptez la musique de fond contre le groupe -->
<audio id="vo-intro" data-audio-group="voiceover" …></audio>
<audio id="vo-middle" data-audio-group="voiceover" …></audio>
<audio id="vo-outro" data-audio-group="voiceover" …></audio>

<audio id="music" data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.8}' …></audio>

Une liste sources nommant deux identifiants de clip simples ou plus au lieu d'un groupe est détectée par la règle de lint audio_carve_ungrouped_sources — cela fonctionne toujours, mais c'est la version qui se détériore silencieusement lorsqu'un clip est ajouté.

Gardez le groupe de sculpture comme un groupe de voix : pas de musique de fond, pas d'effets sonores, pas de musique. Un identifiant de groupe dans sources se résout en chaque membre actuel à chaque analyse, donc le groupe que vous nommez est le groupe que vous obtenez plus tard — pas les pistes qui ont été mesurées lorsqu'il a été écrit. Deux façons dont cela mord :

  • La musique de fond dans son propre groupe source. Elle est donnée à elle-même comme une voix et sculptée contre son propre contenu — la règle "ne jamais sculpter une piste contre elle-même" arrive une réanalyse plus tard.
  • Un clip d'effets sonores ou de musique dans le groupe de voix. Il entre dans la sidechain lors de la prochaine analyse et la musique de fond commence à s'atténuer sous un bruit de glissement, même si l'exécution qui a écrit l'attribut ne l'a jamais mesuré.

Les deux sont invisibles au moment où la sculpture est écrite : l'analyse additionne les voix qu'elle a détectées et ne passe jamais par la résolution de groupe, donc le premier passage est vraiment correct et seul le suivant est erroné. Donnez donc à chaque rôle son propre groupe — music pour la musique de fond, voiceover pour la narration, sfx pour les bruitages — et gardez le groupe nommé dans sources ne contenant rien d'autre que des voix.

carve.mjs refuse d'écrire la forme de groupe lorsqu'il voit l'un ou l'autre cas, enregistre les identifiants de clip, et indique sur stderr quel membre l'a bloqué. La règle audio_carve_ungrouped_sources pointe alors vers l'arrangement...

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

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.

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