Communitygithub.com

jakerains/elevenagents-harness

Esta referência concisa foi elaborada para o harness. A documentação completa do produto está no aplicativo desktop instalado e na documentação oficial do HyperFrames.

O que é elevenagents-harness?

Este skill fornece uma referência de autoria para o harness do HyperFrames, projetado para funcionar como uma ponte entre agentes de IA (como Claude Code) e o ambiente HyperFrames. Ele define a composição de projetos multimídia, incluindo layouts, clipes, linhas do tempo e mídias, com ênfase em animações GSAP controladas e gerenciamento de áudio. O skill também descreve um fluxo de trabalho rigoroso com comandos de lint, verificação e renderização, e oferece suporte à geração de áudio via ElevenLabs quando ativado localmente. É útil para desenvolvedores que desejam criar ou editar projetos HyperFrames programaticamente, garantindo conformidade com as regras do aplicativo desktop e evitando interferências em partes não relacionadas do código.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jakerains/elevenagents-harness/tree/HEAD/references/hyperframes-core

Perguntar na sua IA favorita

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

Documentação

Referência de autoria HyperFrames para esta ponte

Esta referência concisa foi elaborada para o harness. A documentação completa do produto está no aplicativo desktop instalado e na documentação oficial do HyperFrames.

Composição

Um index.html independente tem uma raiz de composição diretamente no body. Use data-composition-id, data-width, data-height e um data-duration finito. CSS width/height na raiz são 100%; as dimensões do canvas pertencem aos seus atributos data. Uma subcomposição usa um template com seus estilos/scripts internos.

Dê aos clipes a classe "clip", data-start/data-duration intencionais e data-track-index. Uma track é uma faixa do Studio, não uma restrição de tempo ou z-index. A duração raiz deve incluir o final de todos os clipes pretendidos. Preserve temporizações, identificadores e mídias não relacionados ao editar.

Registre uma timeline GSAP pausada em window.__timelines[compositionId], usando o mesmo ID da raiz. Anime elementos internos; o framework controla a visibilidade do clipe e a busca de mídia. Não anime display, visibility ou autoAlpha do clipe. Evite conflitos CSS-transform/GSAP, clocks, timers, aleatoriedade não seed e estado de animação dependente de rede.

Use mídia local reproduzível. Cada elemento de áudio precisa de um ID único e temporização intencional. Evite crossorigin em mídia e ancestrais temporizados aninhados ao redor de um vídeo com data-start. Caminhos de arquivo devem corresponder aos ativos reais do projeto.

Fluxo de trabalho

Leia arquivos relevantes e o guia obrigatório do aplicativo antes de editar. Corresponda ao escopo da solicitação do usuário. Não afirme executar ferramentas MCP ou comandos shell indisponíveis. A ponte expõe comandos nomeados: lint, check, timeline e inspect.

Execute verificações nomeadas significativas, relate seu status de saída real e descobertas, e preserve trabalho não relacionado. Um erro de lint pode impedir que as auditorias de runtime/layout/contraste sejam executadas; amostras zero não estabelecem validação visual bem-sucedida. Passar no lint não é prova de qualidade visual.

Renderize apenas quando o usuário solicitar uma exportação e as app_rules permitirem. Consulte render_status até um estado terminal; nunca afirme que uma exportação inacabada foi bem-sucedida. O aplicativo desktop pode ser dono da exportação, caso em que siga suas app_rules.

Ativos de áudio

Quando ativado localmente e solicitado, list_voices retorna os IDs de voz disponíveis do usuário. create_speech e create_sound_effect retornam arquivos MP3 reais relativos ao projeto. Use um caminho retornado na composição com um ID de áudio único e temporização apropriada. Se a geração falhar, relate a falha e não invente um ativo nem tente novamente automaticamente.

Fala e efeitos sonoros são chamadas de API do produto feitas com a própria chave do usuário. Scripts/descrições são enviados para a ElevenLabs e a geração pode consumir créditos. O chat permanece apenas texto. Geração de música e imagem/vídeo não está exposta nesta versão.

Habilidades Relacionadas