Communitygithub.com

HyperFrames Audio

Use quando o áudio já colocado em uma composição HyperFrames precisa ser mixado: fade-in/fade-out, crossfade, ganho ou volume de faixa, automação de volume, ducking, uma base musical que compete com uma narração (esculpir a base musical), efeitos em uma faixa (EQ, compressor, limitador, gate, saturação, delay, reverb, chorus, phaser, bitcrush), envelopes de automação desenhados no volume de uma faixa ou em qualquer parâmetro de efeito, ou um barramento submix que carrega uma cadeia, um fader e um relógio de automação para várias faixas ao mesmo tempo (`<hf-audio-group>`). Não use para buscar ou gerar áudio — encontrar BGM, SFX ou fazer uma narração é `/media-use`. Não use para tempo de clipe ou layout de faixa, que é `/hyperframes-core`.

O que é HyperFrames Audio?

Esta skill, HyperFrames Audio, especializa-se na mixagem de áudio dentro do ecossistema HyperFrames, gerenciando relações entre faixas de áudio já posicionadas. Ela fornece ferramentas para fade-in/fade-out, crossfade, ganho/volume de faixa, automação de volume, ducking, esculpir base musical (carve) para evitar conflitos com narração, e uma cadeia completa de efeitos de áudio (EQ, compressor, limitador, gate, saturação, delay, reverb, chorus, phaser, bitcrush). A automação pode ser desenhada no volume da faixa ou em qualquer parâmetro de efeito, e grupos de áudio (`<hf-audio-group>`) permitem aplicar uma cadeia de efeitos, fader e automação a várias faixas simultaneamente. É compatível com plataformas que implementam o padrão HyperFrames, como ambientes web que utilizam o Web Audio API para pré-visualização e renderização. A skill enfatiza que uma mixagem é um conjunto de relações, não uma pilha de processadores, e fornece abordagens como o esculpir de base musical para resolver conflitos entre voz e música sem perder a presença musical.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Instalação de plugins: Antes dos comandos de configuração ou atualização, siga as regras de instalação de plugins quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.

O que HyperFrames Audio faz?

Uma mixagem é um conjunto de relações, não uma pilha de processadores. Duas faixas que soam bem sozinhas podem ser inaudíveis juntas, e a correção quase nunca é "abaixar uma" — é encontrar pelo que elas estão competindo e dar para aquela que precisa. Cada ferramenta aqui existe para expressar uma dessas relações.

Os efeitos residem no elemento como data-fx-chain, e a pré-visualização e a renderização usam o mesmo gráfico Web Audio — o estúdio em um contexto ao vivo, o motor em um offline dentro do navegador que ele já dirige. Há uma única implementação de cada efeito, então o que você ouve enquanto avança é o que é gravado. Você nunca ajusta duas vezes.

O tempo do clipe permanece com /hyperframes-core: cortes de áudio/vídeo e intervalos de origem usam data-start, data-duration e data-media-start, e crossfades sobrepõem clipes em faixas diferentes. Esta skill gerencia fade-in/fade-out de faixa colocada, envelopes de crossfade, ganho/volume de faixa, automação de volume e efeitos, ducking/esculpir narração, e a cadeia de efeitos. /media-use gerencia a obtenção, geração e pré-processamento.

A constante data-playback-rate (0.1..10) é segura para renderização de imagem e som preservado de tom quando elementos de áudio/vídeo correspondentes usam o mesmo tempo, deslocamento de origem e taxa. Uma rampa de velocidade é uma faixa rate em data-automation (veja docs/reference/speed-ramps); ela substitui a constante e mantém o tom na pré-visualização e renderização. HyperFrames não fornece sincronização automática de forma de onda ou correção de deriva. Para receitas copiáveis de corte/crossfade/reajuste de tempo, use /hyperframes-core → references/creator-editing-recipes.md.

Três atributos carregam tudo, no próprio elemento de áudio/vídeo — ou, para os dois primeiros, em um barramento <hf-audio-group> (veja "Um barramento para muitas faixas"):

AtributoContém
data-fx-chainos efeitos, em ordem de sinal
data-automationenvelopes no volume desta faixa ou em seus parâmetros de efeito
data-fx-carveas próprias configurações do esculpir, para que possa ser re-derivado

As famílias de efeitos fornecidas são ganho, EQ (passa-alta, passa-baixa, pico, prateleiras), compressor, limitador, gate, saturar, delay, reverb, chorus, phaser e bitcrush.

JSON exato para cada um, e as regras que uma faixa deve satisfazer: references/attributes.md. Cada efeito com seus parâmetros, intervalos e unidades: references/fx-registry.md. Como descobrir o que está errado com um arquivo que você não pode ouvir: references/diagnosis.md. Predefinições, trabalhos nomeados e perfis de um knob, além de uma tabela de sintoma para correção: references/presets.md — leia isso antes de construir uma cadeia manualmente, porque uma das predefinições ou trabalhos nomeados geralmente já nomeia o problema.

Como tudo se encaixa

Duas superfícies de autoria escrevem esses atributos; dois ambientes de execução os leem através dos mesmos construtores. Esse meio compartilhado é o motivo pelo qual a pré-visualização prevê a renderização.

flowchart TB
  voice["faixa de voz<br/>arquivo de mídia"]
  bed["base musical<br/>arquivo de mídia"]

  subgraph AUTHOR["Autoria — as únicas coisas que escrevem atributos"]
    panel["Estúdio<br/>Controle de esculpir narração"]
    script["scripts/carve.mjs<br/>detecta o par"]
    analysis["core/audioCarve.ts<br/>carveProfile · analyseCarveBands<br/>analyseCarveDuck · analyseCarveDynamics"]
    panel --> analysis
    script --> analysis
  end

  voice --> analysis
  bed --> analysis

  subgraph ATTRS["Escrito no elemento da base musical"]
    carveAttr["data-fx-carve<br/>fontes · intensidade"]
    chainAttr["data-fx-chain<br/>pico xN + ganho, marcado fromCarve"]
    autoAttr["data-automation<br/>uma faixa por parâmetro esculpido"]
  end

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

  subgraph SHARED["Uma implementação, lida por ambos"]
    build["audioFxGraph.ts · buildFxChain"]
    sched["audioFxAutomation.ts · scheduleChainAutomation"]
  end

  chainAttr --> build
  autoAttr --> sched

  build --> preview["Pré-visualização<br/>AudioContext ao vivo<br/>attachElementFxChain"]
  sched --> preview
  build --> render["Renderização<br/>OfflineAudioContext no navegador headless<br/>applyAudioFxChain"]
  sched --> render

  preview --> heard["o que você ouve enquanto avança"]
  render --> wav["WAV processado<br/>+ chainTailSeconds para que a mixagem deixe a cauda passar"]
  wav --> mix["motor · audioMixer<br/>faixa de volume incorporada no PCM aqui, não no gráfico"]
  mix --> out["a mixagem renderizada"]

  edit["editando o atributo durante a reprodução"] -.->|MutationObserver| preview

As próprias configurações do esculpir nunca são lidas na reprodução — a cadeia e as faixas que ele produziu são o que toca. data-fx-carve existe para que a intensidade possa ser alterada em um esculpir existente em vez de ser adivinhada de volta dos filtros.

Dentro de uma base musical esculpida, o sinal passa primeiro pelos cortes, depois pelo ajuste de nível, depois por qualquer coisa que você construiu — que é o motivo pelo qual um limitador que você adiciona ainda atua como o último teto:

flowchart LR
  src["base musical decodificada"] --> p1["pico<br/>400 Hz"]
  p1 --> p2["pico<br/>1 kHz"]
  p2 --> p3["pico<br/>1.6 kHz"]
  p3 --> g["ganho<br/>ajuste de nível"]
  g --> hand["seus próprios efeitos<br/>ex. limitador"]
  hand --> dest["ganho da faixa, depois saída"]

  l1["faixa fx.n1.gain"] -.->|"envelope do nível<br/>da voz naquela banda"| p1
  l4["faixa fx.n4.gain"] -.->|"o quanto a base<br/>abaixa no geral"| g

Primeiro, descubra o que está errado

A tabela abaixo começa com "soa encorpado" — o que pressupõe que alguém já ouviu e disse isso. Dado um arquivo e "corrija isto", você não tem essa frase e não pode ouvir, então você tem que medir. Uma regra rege tudo:

O espectro absoluto de uma única voz desconhecida não pode ser diagnosticado. Os formantes são ±10 dB, as frequências fundamentais variam de 85 a 255 Hz, e as frases diminuem 5-6 dB conforme terminam. Cada uma delas parece um defeito por si só, e cada uma delas é o falante.

Portanto, compare, e compare com algo dentro do mesmo arquivo: o original limpo, se existir, caso contrário, as pausas — o que quer que seja audível em uma lacuna é aditivo, e o espectro da lacuna é o canal, não a voz. Comparar com um espectro médio publicado ou uma voz de controle sintetizada não funciona: dois falantes diferem mais do que a maioria dos defeitos, e ambas as respostas erradas na avaliação que deu origem a esta orientação vieram exatamente disso.

Quando não há original e nenhum silêncio utilizável, um defeito tonal estático é genuinamente subdeterminado. Diga isso e ofereça as leituras que se encaixam, em vez de escolher uma e construir uma cadeia nela.

Comandos, armadilhas e receitas práticas: references/diagnosis.md. Leia-o antes de diagnosticar um arquivo que ninguém descreveu.

Comece pelo sintoma

Depois de conhecer a banda e o tipo, nomeie o que está errado com o áudio. A maioria dos áudios ruins é um ou dois destes, e cada um tem uma resposta fornecida:

Soa comoUse
Zum ou pancada por baixorumble-cut, ou um highpass a 80 Hz
Encorpado, peitoralTrabalho Domar Encorpado (200 Hz)
Abafado, atrás de papelãoTrabalho Reduzir Lama (250 Hz)
Palavras difíceis de entenderTrabalho Adicionar Clareza (3 kHz), ou esculpir a base musical
Áspero e cansativoTrabalho Suavizar Aspereza (3.2 kHz)
Algumas palavras muito mais altas que outrasUniformidade em um compressor, ou Nivelar Níveis
Tom da sala entre frasesroom-gate
Voz e música competindoEsculpir narração — não um EQ em nenhum
Seco, gravado em lugar nenhumroom-tight ou room-natural
Apenas "amador"voice-clean, que são quatro dos acima em ordem

Catálogo completo, o que cada predefinição contém, o vocabulário de bandas e o que é DELIBERADAMENTE NÃO COBERTO (de-essing, remoção de ruído, correspondência de tom): references/presets.md.

Subtraia antes de adicionar, nivele depois de filtrar, relações depois do nível, caráter e teto por último. Cada passo muda o que o próximo ouve — um compressor configurado antes de um passa-alta gasta seu tempo perseguindo ruído de baixa frequência.

Alcance uma família pelo problema, não pelo nome

Filtros (highpass, lowpass, peaking, lowshelf, highshelf) decidem quais frequências uma faixa pode ocupar. Esta é a primeira ferramenta para duas fontes colidindo, porque as colisões acontecem em bandas: uma base musical e uma voz querem ambas 1-3 kHz, e tirar isso da base musical custa muito menos do que abaixar tudo custa à mixagem. Um passa-alta em uma voz é a correção padrão para ruído de baixa frequência; um passa-baixa escurece ou abafa deliberadamente.

Dinâmica (gain, compressor, limiter, gate) decide como o nível de uma faixa se comporta ao longo do tempo. A compressão reduz a distância entre alto e baixo para que as partes baixas possam subir. Um limitador é um teto — ele não molda nada, garante que nada passe. Um gate remove o que está abaixo de um limiar, que é como você silencia o tom da sala entre frases. gain é um estágio de nível simples, e é o que uma faixa de automação monta quando uma faixa precisa sair do caminho.

Não lineares (saturate, bitcrush) mudam a forma de onda, o que adiciona harmônicos que não estavam lá. Use quando uma faixa precisa de caráter ou aspereza em vez de correção — e lembre-se de que é generativo: torna uma fonte fina mais densa, não mais limpa.

Tempo (delay, reverb, chorus, phaser) coloca uma faixa em um espaço ou lhe dá largura. Estes são os que mais facilmente estragam uma mixagem, porque uma cauda ou uma cópia desafinada ocupa o mesmo espaço que uma voz precisa. Use-os na coisa que deve ficar atrás de outra coisa, e mantenha a quantidade de efeito úmido mais baixa do que parece certo isoladamente.

A cadeia é serial: cada efeito processa o que o anterior produziu. Portanto, a filtragem corretiva vai cedo, o caráter no meio e um limitador por último, onde pode realmente atuar como um teto.

Esculpir narração

O problema que resolve. Uma base musical sob uma voz dificulta acompanhar a voz. O reflexo é abaixar toda a base musical, o que funciona e custa à base musical toda a sua presença — a música fica mole durante toda a narração. Mas a voz não precisa de todo o espectro. Ela precisa das poucas bandas que realmente ocupa. Esculpir pega apenas essas, e a base musical mantém suas frequências graves e agudas, então ainda é música enquanto a voz ainda é inteligível.

É uma relação, não um efeito. As configurações residem na base musical — a faixa que é processada — e elas nomeiam as vozes para ouvir, exatamente como um compressor sidechain faz: você seleciona a faixa que fica mais baixa e escolhe o que a torna mais baixa. Nunca coloque um esculpir em uma faixa de voz. Uma voz esculpida contra si mesma é um bug, não uma escolha sutil de mixagem.

Cada voz, não uma delas. sources é uma lista, porque uma base musical geralmente toca sob uma sequência inteira — um narrador, uma resposta de entrevista, um segundo apresentador. Eles são somados no próprio relógio da base musical antes que qualquer coisa seja medida (mixCarveSources), então uma análise cobre todos eles: as bandas vêm de toda a fala que existe, e os envelopes sobem onde quer que qualquer uma delas esteja acontecendo. Vozes que nunca tocam enquanto a base musical toca são deixadas de fora; elas não podem mascará-la.

Um esculpir contra mais de um id de clipe está errado. Agrupe os clipes e esculpa contra o grupo. Isso é um invariante, não uma dica. Nomear clipes um por um tem que estar exaustivamente correto e permanece correto apenas até a próxima edição — um quarto clipe de narração adicionado posteriormente toca fora da consciência do esculpir, e a base musical falha em abaixar silenciosamente sob ele. Nomear o grupo em vez disso resolve a associação no momento da análise, então um clipe adicionado ao grupo posteriormente é coberto sem tocar em sources:

<!-- agrupe a narração, depois esculpa a base musical contra o grupo -->
<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>

Uma lista sources nomeando dois ou mais ids de clipe simples em vez de um grupo é detectada pela regra de lint audio_carve_ungrouped_sources — ainda funciona, mas é a versão que silenciosamente piora quando um clipe é adicionado.

Mantenha o grupo de esculpir como um grupo de voz: sem base musical, sem SFX, sem música. Um id de grupo em sources resolve para cada membro atual em cada análise, então o grupo que você nomeia é o grupo que você obtém depois — não as faixas que foram medidas quando foi escrito. Duas maneiras que isso morde:

  • A base musical em seu próprio grupo de origem. Ela é passada para si mesma como uma voz e esculpida contra seu próprio conteúdo — a regra "nunca esculpa uma faixa contra si mesma" chegando uma re-análise depois.
  • Um clipe SFX ou música no grupo de voz. Ele entra no sidechain na próxima análise e a base musical começa a abaixar sob um whoosh, mesmo que a execução que escreveu o atributo nunca o tenha medido.

Ambos são invisíveis no momento em que o esculpir é escrito: a análise soma as vozes que detectou e nunca faz uma viagem de ida e volta pela resolução de grupo, então a primeira passagem é genuinamente correta e apenas a próxima está errada. Portanto, dê a cada função seu próprio grupo — music para a base musical, voiceover para a narração, sfx para os efeitos sonoros — e mantenha o grupo nomeado em sources contendo apenas vozes.

carve.mjs se recusa a escrever a forma de grupo quando vê qualquer um dos casos, registra ids de clipe e informa no stderr qual membro o bloqueou. A regra audio_carve_ungrouped_sources então aponta para o arranjo...

[truncado para tradução]

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.

Habilidades Relacionadas