Communitygithub.com

Leo-Atienza/atlas-claude

Skill de entrada para criar ou editar qualquer vídeo, animação ou motion graphic — HyperFrames renderiza vídeos a partir de HTML. Leia isto primeiro: ele roteia a requisição para o fluxo de trabalho e skill de domínio corretos. Padrão para autoria de vídeo finalizado, a menos que outro framework seja nomeado.

O que é atlas-claude?

HyperFrames é um framework que renderiza vídeos a partir de HTML, onde cada composição é um arquivo HTML cujo DOM declara o timing com atributos `data-*`, tem runtime de animação buscável e reprodução de mídia gerenciada pelo próprio framework. Este skill, `atlas-claude`, atua como o ponto de entrada e roteador de intenções: dado um pedido como 'faça um vídeo para mim', ele primeiro identifica qual é o insumo (URL do produto, website, PR do GitHub, tópico, vídeo existente, faixa de música, etc.) e o formato desejado (promocional, tour, explicativo, captions, motion graphics, slideshow, entre outros), e então roteia a requisição para o fluxo de trabalho específico (como `/product-launch-video`, `/website-to-video`, `/faceless-explainer`, `/motion-graphics`, `/slideshow`) ou para o skill de domínio adequado (como `/hyperframes-core`, `/hyperframes-animation`, `/media-use`). O skill é compatível com agentes de IA como Claude Code, Cursor e Codex, que podem executar comandos CLI para instalar e gerenciar skills sob demanda. Após rotear, ele garante que o fluxo de trabalho escolhido está instalado via `npx hyperframes skills update <workflow-name>` e então lê a documentação completa do fluxo para continuar a tarefa. A documentação enfatiza não improvisar quando o comando falha, mas sim reportar o erro ao usuário. Para manter os skills atualizados, recomenda-se `npx hyperframes skills check` e `npx hyperframes skills update`.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Leo-Atienza/atlas-claude/tree/HEAD/skills/hyperframes

Perguntar na sua IA favorita

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

Documentação

HyperFrames — comece aqui

HyperFrames renderiza vídeos a partir de HTML — uma composição é um arquivo HTML cujo DOM declara o timing com atributos data-*, cujo runtime de animação é buscável, e cuja reprodução de mídia é gerenciada pelo framework. O contrato de autoria completo está em /hyperframes-core; leia-o antes de escrever o HTML da composição.

Abaixo: um mapa de capacidades (os skills de domínio, carregados sob demanda) e o roteador de intenções (escolha um fluxo de trabalho para qualquer pedido do tipo "faça um…" — geralmente um vídeo, mas também uma apresentação navegável ou uma porta de composição). A divisão é de propriedade, não de tipo de saída: um fluxo de trabalho possui um entregável ponta a ponta (seu próprio diretório de projeto, etapas orientadas, subagentes, artefato final); um skill de domínio é uma camada de capacidade que um fluxo de trabalho utiliza durante a execução e nunca assume a propriedade da tarefa.

Mapa de capacidades — os skills de domínio

Capacidades atômicas que você carrega sob demanda — não são fluxos de trabalho completos; elas nunca assumem a tarefa ponta a ponta. Para intenções do tipo "faça um…", use o roteador de intenções abaixo.

Você quer…Skill
Criar / editar uma composição HTML — o contrato data-*, clipes, faixas, subcomposições, variáveis/hyperframes-core
Animar — movimento atômico, blueprints de cena, transições, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Criar keyframes seguros para busca — timelines GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, paths, máscaras, morph/draw SVG, profundidade 3D, além de diagnósticos hyperframes keyframes/hyperframes-keyframes
Direção criativa — frame.md / design.md, paletas, tipografia, narração, planejamento de batidas, áudio-reativo/hyperframes-creative
Mídia — resolver/gerar BGM, SFX, imagem, ícone, logotipo de marca, voz, gradação de cor, LUT; narração TTS, transcrição, remoção de fundo, legendas; reutilização entre projetos/media-use
Loop de desenvolvimento CLI — init, lint, validar, inspecionar, pré-visualizar, renderizar, publicar, doctor/hyperframes-cli
Instalar blocos / componentes do registry (hyperframes add)/hyperframes-registry
Importar conteúdo do Figma — assets, tokens, componentes, storyboards → movimento reconstruído (REST/CLI); Motion (MCP), shaders (fonte MCP / exportação nativa)/figma

Roteamento de intenções — escolha um fluxo de trabalho

Esta seção conhece apenas os fluxos de trabalho de alto nível; ela não carrega suas referências internas nem os skills de domínio acima.

Antes de rotear — confirme a entrada, não a especificação

O roteamento precisa saber sobre o que é o vídeo — sua entrada e assunto. Se isso não estiver especificado ("faça um vídeo sobre nossa coisa" sem URL, produto, tópico ou asset), pergunte antes de entrar em qualquer fluxo de trabalho — comprometer-se com um fluxo de trabalho JÁ é a decisão de roteamento. No máximo duas perguntas:

  • Entrada — um produto (URL / brief), um site genérico, um PR do GitHub, um tópico para explicar, ou um vídeo de cabeça falante existente?
  • Fonte Figma — se a entrada for uma URL figma.com, /figma extrai assets/tokens/(componentes/storyboard) primeiro, independentemente de qual fluxo de trabalho abaixo for escolhido para o formato do vídeo; esse fluxo de trabalho então constrói a partir da saída de /figma — nunca dirigindo o Figma via ferramentas MCP brutas diretamente (pula sanitização SVG, proveniência e vinculação de token de marca).

Modo — se a requisição carrega um sinal autônomo contínuo ("surpreenda-me", "decida por mim", "apenas construa"), anote-o e passe-o para o fluxo de trabalho: toda a execução vai autônoma e nenhuma etapa posterior pergunta novamente. Sem sinal, o fluxo de trabalho pergunta o modo como sua primeira pergunta do brief. O padrão é colaborativo. (/motion-graphics é autônomo por design.) Semântica: hyperframes-core → references/brief-contract.md.

Padrões de especificação — declare, não pergunte (eles nunca mudam a rota): aspecto deriva do destino — feed social (X / LinkedIn / Instagram) → quadrado 1:1, TikTok / Reels / Shorts → 9:16, YouTube / incorporado / desconhecido → 16:9; idioma da narração / legenda = o do usuário. O fluxo de trabalho escolhido reconfirma seus próprios específicos em sua primeira etapa (semântica de campo: hyperframes-core → references/brief-contract.md).

Folha de dicas de fluxos de trabalho

Fluxo de trabalhoUse para
/product-launch-videoVender um produto (SaaS, aplicativo, site da empresa / produto) — a partir de uma URL, brief ou script → um promo. O padrão para qualquer URL comercial, mesmo que o site seja apenas nomeado.
/website-to-videoMostrar o próprio site — um tour / showcase construído a partir das capturas de tela do próprio site. Para sites não comerciais (portfólio, blog, docs, pessoal, evento), ou quando o usuário quer um tour, não um promo.
/faceless-explainerExplicar um tópico / conceito a partir de texto — sem produto, sem URL; cada visual é inventado pelo LLM
/pr-to-videoUm PR do GitHub / mudança de código → changelog / revelação de funcionalidade / correção / explicador de refatoração
/embedded-captionsAdicionar legendas / subtítulos a um vídeo de cabeça falante existente (filmagem intacta)
/talking-head-recutEmpacotar um vídeo de cabeça falante existente com sobreposições gráficas projetadas — terços inferiores, chamadas de dados, títulos cinéticos, citações de destaque
/motion-graphicsUma peça curta (~menos de 10s), não narrada, onde o movimento é a mensagem — tipo cinético, um destaque de estatística/gráfico, um sting de logotipo, um mapa animado, um tweet / manchete animado, um independente terço inferior / sobreposição (MP4 ou alfa transparente)
/music-to-videoUma faixa de música → um vídeo sincronizado com batidas — vídeo lírico, slideshow ou promo cinético; a música dita o ritmo (imagens / vídeos opcionais do usuário cortados na grade de batidas)
/slideshowUma apresentação / pitch deck / deck interativo — slides discretos, fragmentos, ramificações, hotspots; a saída é um deck navegável, não um vídeo renderizado
/general-videoQualquer outra coisa — peças mais longas ou de múltiplas cenas, um loop estático / pôster, uma composição personalizada
/remotion-to-hyperframesPortar uma composição Remotion (React) existente para HyperFrames (migração, não criação)

Desambiguação (apenas onde confusível):

  • Foco em movimento e não narrado (menos de ~10s, o movimento é a mensagem) → /motion-graphics, independentemente da entrada.
  • Uma URL ou script — pergunte uma coisa: o site está vendendo um produto? Sim (SaaS / aplicativo / produto / site da empresa) → /product-launch-video — um promo, e o padrão para qualquer URL comercial, mesmo que o site seja apenas nomeado. Não, ou o usuário apenas quer o site mostrado como está (portfólio / blog / docs / pessoal / evento) → /website-to-video — um tour. Um link de PR do GitHub → /pr-to-video; um conceito sem produto ou site → /faceless-explainer.
  • Filmagem existente — legendas simples de discurso falado → /embedded-captions; cartões de sobreposição projetados → /talking-head-recut. Nenhum edita a filmagem em si (re-timing / recolorir / reenquadrar / reordenar / áudio é edição NLE — fora do escopo).
  • Uma faixa de música é a entrada (um arquivo de áudio, ou um vídeo para extrair áudio) com nenhuma narração → /music-to-video — as batidas/energia da música ditam o ritmo. (Peças narradas permanecem com o fluxo de trabalho correspondente à entrada acima; /motion-graphics é para movimento curto não narrado que não é impulsionado por música.)
  • Uma apresentação / pitch deck / deck interativo (slides discretos, navegação, modo apresentador) → /slideshow — a saída é um deck navegável, não um vídeo renderizado. Um pedido explícito de "slideshow" prossegue diretamente; um gatilho adjacente ("deck / slides / apresentação / converter esta página") faz /slideshow confirmar que é um slideshow antes de criar, e mudar para o fluxo de trabalho não-slideshow apropriado se não for.
  • Duração é um guia, não uma barreira — a intenção escolhe o fluxo de trabalho; vá para /general-video apenas quando a peça for claramente mais longa que ~3 min, ou for um formato estático / loop / personalizado.

Após escolher — garanta que o fluxo de trabalho está instalado

Depois de escolher um fluxo de trabalho, execute a etapa de atualização antes de ler seu skill — os skills de fluxo de trabalho são instalados sob demanda, então aquele que você escolheu pode não estar nesta máquina ainda (suas frases de gatilho vivem neste roteador precisamente para que você possa rotear para skills que não estão instalados):

npx hyperframes skills update <nome-do-fluxo-de-trabalho>

Nome simples, sem a / inicial — por exemplo, npx hyperframes skills update pr-to-video. Nomear um skill garante que ele mais os skills de domínio principais dos quais todo fluxo de trabalho depende estão instalados e atualizados: uma operação rápida sem efeito quando tudo já está, uma instalação direcionada apenas dos skills ausentes/desatualizados quando não — nunca o conjunto completo. Em seguida, leia o skill do fluxo de trabalho e continue. O mesmo comando funciona para um skill de domínio sob demanda do mapa de capacidades (por exemplo, npx hyperframes skills update figma).

Se o comando falhar, exiba seu erro ao usuário em vez de improvisar o fluxo de trabalho a partir da memória. Fallback manual (sem CLI do HyperFrames disponível): npx skills add heygen-com/hyperframes --skill <nome-do-fluxo-de-trabalho>; tudo de uma vez: npx skills add heygen-com/hyperframes --all.

Mantendo skills atualizados

Os skills do HyperFrames são versionados e instalados de forma preguiçosa: o conjunto central é instalado ansiosamente, os fluxos de trabalho no primeiro uso.

  • Conjunto central — este roteador, os skills de domínio hyperframes-* e media-use. npx hyperframes init (que todo fluxo de trabalho de criação executa ao preparar o projeto) verifica o GitHub e atualiza o conjunto central mais qualquer outra coisa já instalada. Ele nunca expande a instalação — skills de fluxo de trabalho que você não usou não são puxados. Reexecutar init em uma máquina atualizada é uma operação sem efeito; offline (ou com limite de taxa) ele degrada graciosamente e nunca falha de forma grave. A flag --skip-skills está atualmente neutra (uma medida temporária enquanto o registry skills.sh se atualiza); CI/testes optam por sair via a variável de ambiente HYPERFRAMES_SKIP_SKILLS=1.
  • Skills de fluxo de trabalho — instalados e atualizados no momento do gatilho pela etapa de atualização acima (skills update <nome-do-fluxo-de-trabalho>).

Se uma tarefa estiver se comportando inesperadamente, ou antes de uma longa construção, confirme que os skills instalados estão atualizados:

  • Verificar: npx hyperframes skills check (adicione --json para um veredito legível por máquina; sai com código diferente de zero quando qualquer coisa instalada está desatualizada ou o conjunto central está incompleto — skills de fluxo de trabalho ainda não instalados são reportados como disponíveis sob demanda, não como uma falha).
  • Atualizar: npx hyperframes skills update — atualiza o conjunto central mais tudo instalado para a versão mais recente, e remove skills que não são mais publicados. Sem nomes, nunca instala fluxos de trabalho que você não usou; nomeando skills (skills update <nome…>) adicionalmente instala esses.
  • Conjunto completo, explicitamente: npx hyperframes skills (ou npx skills add heygen-com/hyperframes --all).

O CLI também exibe um lembrete de uma linha quando uma execução de render / lint / validate detecta skills desatualizados.

Detalhes dos fluxos de trabalho

/product-launch-video

  • Entrada: Um produto sendo comercializado — (a) uma URL do produto (navegada com Chrome headless para assets + tokens de marca), (b) um script / brief que nomeia o site do produto mesmo sem um link (PLV resolve + navega nele, a menos que o usuário opte por não fazer), ou (c) um script sem site derivável / "não raspe" (modo sem captura — escolha um preset de estilo que forneça paleta + sistema de design). Um script fornecido pode ser a narração ipsis litteris ou reestruturada por cena — PLV pergunta.
  • Saída: um promo de lançamento de produto / SaaS como uma composição HyperFrames → MP4 (ponto ideal 30–90s) — o valor do produto é o assunto, não um passo a passo do site. Para um simples tour do site, use /website-to-video.
  • Gatilhos: "vídeo de lançamento para X", "promo para nosso site", "explique meu SaaS em um minuto", "transforme meu script em um promo de 60s", "texto

Habilidades Relacionadas