Instalação de plugins: Antes dos comandos de setup ou freshness, siga regras de execução de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
media-use
O SO de mídia para HyperFrames: resolver · gerar · operar · lembrar — todo tipo de mídia, um skill, zero ruído de contexto.
Primeira execução: instale e faça login na CLI heygen (caminho gratuito), depois verifique com npx hyperframes media-use resolve --doctor. Configuração e provedores: references/setup-providers.md.
Resolver — o único verbo
npx hyperframes media-use resolve --type <type> --intent "<description>" --project <dir>
Retorna uma linha: resolved <id> → <path> (<type>, <metadata>). Todo o ruído de busca permanece no disco.
| Tipo | Intenção em uma linha |
|---|---|
bgm | música de fundo (catálogo HeyGen, 10k+ faixas) |
sfx | efeitos sonoros (biblioteca de 19 arquivos + catálogo) |
image | fotos, fundos (pesquisa de ativos HeyGen, 75k+ vetores) |
icon | ícones, símbolos (transparentes) |
logo | marcas oficiais (theSVG → avatar GitHub → favicon; nunca redesenhado) |
voice | locução TTS (caminho gratuito HeyGen; Kokoro local opcional) |
grade | candidato de correção medido; polimento/estilização amplo segue Tratamentos de Mídia |
lut | arquivo .cube fornecido pelo usuário ou explicitamente escolhido e reutilizável |
Antes de resolver algo novo, liste candidatos reutilizáveis com --candidates e julgue você mesmo o ajuste — regras de reutilização, todas as flags, ingest (--from) e adoção estão em references/resolve.md.
Trate feedback visual amplo como intenção de mídia
Quando um usuário explicitamente pede para corrigir, polir, estilizar, obscurecer, enfatizar ou revelar mídia fotográfica, leia references/media-treatments.md mesmo que ele não mencione correção de cor ou um efeito. Inspecione o <img>/<video> real, escolha uma intenção primária, depois use persistência e verificação determinísticas. Use uma receita correspondente como uma semente testada opcional, ou inspecione hyperframes media-treatment --capabilities --json, depois solicite uma família/efeito relevante com --capability <id> e monte um tratamento personalizado a partir de controles canônicos. Nunca carregue --all para criação comum. Um tratamento pode compor correção, um preset, finalização, efeitos de shader compatíveis, keyframes suportados e sobreposições opcionais do Registry. Adicione apenas ajustes limitados justificados pela fonte e partes compatíveis, nunca efeitos meramente para fazer o resultado parecer mais sofisticado. Persista o payload final combinado com hyperframes media-treatment.
Use um fluxo de trabalho progressivo. Para vídeo, inspecione uma folha de contato rotulada (início/meio/fim) em vez de ler quadros separadamente. Aplique um candidato e inspecione uma folha posterior para correção ou polimento comum. Escalone para quadros individuais ou evidências em movimento apenas quando o resultado for ambíguo, temporal, estilizado, baseado em LUT, sensível a HDR/LOG, privado ou crítico para a marca.
Para correção ou polimento comum, persista o JSON de preset/ajuste do tratamento final.
Não gere um LUT .cube meramente para codificar exposição, sombras, contraste ou aquecimento. Use um LUT apenas quando o usuário fornecer um ou o tratamento selecionado explicitamente possuir um. resolve --type grade --for ... --analyze é evidência de medição, não permissão para substituir o tratamento escolhido por um LUT gerado. Não recrie efeitos suportados de vinheta, granulação, desfoque, pixelização, cor ou tratamento com sobreposições CSS/SVG; isso ignora os controles do Studio e o caminho canônico de preview/render de shader.
Seja proativo — execute uma passagem de oportunidade de mídia
O humano geralmente não sabe qual mídia melhoraria o projeto. Você sabe. Ao construir ou revisar uma composição, faça uma varredura fundamentada e depois pergunte uma vez — não adicione silenciosamente e não perturbe por ativo.
Ofereça uma oportunidade apenas quando um sinal concreto estiver presente:
| Sinal detectado | Ofereça |
|---|---|
| Texto na tela / um script sem locução | Locução TTS (mecanismo de áudio) |
Emoji ou um <div> estilizado como ícone | resolver icons reais |
| Imagem que é placeholder, miniatura ou parece ampliada | uma image melhor (e/ou ampliação — veja references/operations.md) |
| Cortes de cena / transições sem som | sfx de transição |
| Uma peça com mais de ~10s sem trilha musical | bgm |
| Filmagem sub/sobre-exposta ou com dominante de cor | uma correção corretiva (inspecione com hyperframes media-treatment --selector '#hero' --analyze --json) |
| Mídia fotográfica que parece visualmente sem graça ou fora do assunto | Um preset específico e apropriado à fonte ou tratamento personalizado, com o destino pretendido nomeado |
| Uma entrada/revelação de mídia significativa que parece estática | Uma animação de tratamento segura para seek; preserve a cor, a menos que a solicitação também justifique um preset |
Regras que mantêm isso como ajuda, não encheção: fundamentado, não genérico (sem sinal → sem sugestão); opinativo + concreto (proponha a correção específica com padrões escolhidos — o humano aprova tudo / algo / nada); uma vez por projeto (um pedido consolidado; respeite "deixa assim"); na superfície, nunca mude silenciosamente (correções de cor especialmente: proponha e pré-visualize — uma correção de "mundo cinza" arruína um pôr do sol ou visual neon intencional).
Onde olhar — leia apenas o arquivo que sua tarefa precisa
| Tarefa | Leia |
|---|---|
| resolver / reutilizar / adotar / ingerir, flags, cascata, inventário | references/resolve.md |
correção de cor, LUTs, correção inteligente (--for), grade-compare | references/grading.md |
| locução / TTS, música, SFX, legendas, transcrição (mecanismo de áudio) | references/audio.md |
| cortar / reenquadrar / transformar mídia existente, difusão de erro exata, HEVC | references/operations.md |
| tratamentos criativos sensíveis à fonte, efeitos em tempo real, sobreposições, revelações | references/media-treatments.md |
instalação + autenticação, tabela de provedores, escalas de RAM, --local-only, --provider | references/setup-providers.md |
| preferências lembradas + receitas congeladas (memória do usuário) | references/memory.md |
| matriz de propriedade, estatísticas de uso, telemetria, privacidade (voltado a mantenedores) | references/meta.md |