hyperframes-registry

Visão geral da skill hyperframes-registry

O que a hyperframes-registry faz

A skill hyperframes-registry ajuda você a instalar e encaixar itens reutilizáveis do registry do HyperFrames com bem menos tentativa e erro do que um prompt genérico. Ela foi feita para o trabalho real de transformar a saída de hyperframes add <name> em uma composição funcional, seja ao adicionar um block, mesclar um component ou conferir o que já existe no registry.

Casos de uso ideais

Use a skill hyperframes-registry quando você precisar de um hyperframes-registry guide prático para:

• instalar um item do registry em um projeto existente
• decidir se um item é um block ou um component
• conectar arquivos instalados em index.html
• ler os mapeamentos de caminho em hyperframes.json
• descobrir itens do registry antes de se comprometer com um deles

O que a diferencia

A skill é mais forte quando o caminho de instalação, o tipo de arquivo e os passos de integração importam. Blocks funcionam como subcomposições independentes, com suas próprias dimensões e timeline; components são trechos que se incorporam à composição hospedeira. Essa distinção é o principal ponto de decisão que esta skill hyperframes-registry esclarece antes de você editar arquivos.

Como usar a skill hyperframes-registry

Instale e inspecione os arquivos certos

Para hyperframes-registry install, use a skill junto com a estrutura do repositório, e não no lugar dela. Comece pelo item que você está instalando e depois leia:

• SKILL.md para entender o fluxo de trabalho
• references/discovery.md para busca no registry e campos do manifesto
• references/install-locations.md para paths padrão e remapeamento via hyperframes.json
• references/wiring-blocks.md ou references/wiring-components.md, dependendo do tipo de item
• examples/add-block.md e examples/add-component.md para padrões completos de ponta a ponta

Transforme uma solicitação vaga em um bom prompt

O melhor uso de hyperframes-registry começa com um objetivo específico, e não apenas com um nome. Uma entrada forte inclui:

• o nome do item
• se você quer um block ou component
• onde ele deve ficar no projeto
• se você vai integrá-lo a uma composição existente ou começar do zero
• qualquer remapeamento de caminho em hyperframes.json

Formato de prompt de exemplo:
Install data-chart into my HyperFrames project, wire it into index.html, and tell me which files and attributes need updating.

Fluxo de trabalho que evita erros comuns

Um hyperframes-registry guide confiável segue este roteiro:

1. Execute hyperframes add <name> no projeto.
2. Verifique os arquivos gravados e o snippet que o CLI imprime.
3. Confirme se o item é um block ou component.
4. Conecte blocks com data-composition-src, data-start, data-duration e data-track-index.
5. Incorpore components em HTML, CSS e JS onde o snippet indicar.
6. Atualize os paths se o seu projeto substituir hyperframes.json#paths.

Dicas práticas de qualidade

Para obter uma saída melhor, diga à skill o que sua composição já contém. Por exemplo, informe o tamanho atual do canvas, a duração da timeline e se você já tem um data-composition-id hospedeiro. Isso faz diferença em hyperframes-registry for Design Implementation, porque blocks precisam bater com o layout do host e components precisam se encaixar na timeline e nos estilos atuais.

Perguntas frequentes da skill hyperframes-registry

Isso serve só para tarefas de instalação?

Na maioria dos casos, sim. A skill hyperframes-registry é voltada para decisões de instalação, descoberta e integração. Se você só quer uma explicação conceitual sobre o HyperFrames, um prompt simples já basta. Se você precisa de paths reais e passos de integração, a skill é uma opção melhor.

Qual é a diferença entre um block e um component?

Um block é uma composição completa, com dimensões e duração próprias, pensada para ser incorporada com data-composition-src. Um component é um trecho que você cola em uma composição existente. Se você precisa de temporização independente ou de um canvas separado, escolha um block. Se você precisa de um efeito que se integra à cena atual, escolha um component.

Iniciantes precisam conhecer o repositório antes?

Não. A skill é amigável para iniciantes se você consegue reconhecer o objetivo: “instalar este item e integrá-lo”. O principal risco para quem está começando é pular a etapa de wiring depois de hyperframes add. As referências do repositório reduzem esse risco porque mostram exatamente onde olhar em seguida.

Quando não devo usar esta skill?

Não use hyperframes-registry se você não estiver trabalhando com o registry do HyperFrames, se não estiver instalando nada ou se já souber exatamente quais edições fazer e só precisar reescrever um prompt curto. Ela é mais útil quando a decisão de instalação e os detalhes de integração ainda estão em aberto.

Como melhorar a skill hyperframes-registry

Dê à skill as restrições que faltam

O maior ganho de qualidade vem de informar ao hyperframes-registry o que a composição de destino espera. Inclua tamanho do canvas, duração da timeline, preferência de diretório de instalação e se o projeto hospedeiro usa os paths padrão compositions/ ou paths remapeados. Isso evita suposições erradas sobre paths e wiring.

Mostre a superfície exata de integração

Para um melhor uso de hyperframes-registry, cole a parte relevante da composição hospedeira ou descreva-a com precisão:

• o container de index.html
• o data-composition-id existente
• o tempo inicial atual da timeline GSAP
• quaisquer wrapper elements ou layers já em uso

Isso é especialmente importante para wiring de blocks, porque a posição e a ordem das camadas afetam se o item adicionado vai se comportar corretamente.

Itere a partir da primeira saída

Se o primeiro resultado vier perto do ideal, mas ainda não estiver pronto, refine pedindo um destes itens:

• um caminho de instalação corrigido com base em hyperframes.json
• apenas um snippet mínimo de wiring
• uma recomendação block-vs-component para o mesmo objetivo visual
• um plano de merge que separe os passos de HTML, CSS e JS

Esse ciclo de feedback é a forma mais rápida de melhorar os resultados de hyperframes-registry sem sobrecarregar o prompt inicial.