Communitygithub.com

BintzGavin/helios-skills

Fluxo de trabalho guiado completo para criar um vídeo hype promocional. Extrai identidade da marca do repositório, gera música sincronizada com o ritmo e produz uma composição motion.dev de alta energia renderizada via Helios CLI. Use ao criar vídeos promocionais ou de hype alinhados com a marca.

O que é helios-skills?

Esta skill oferece um pipeline completo e guiado para a criação de vídeos promocionais de alto impacto (hype videos). Ela é projetada para desenvolvedores e criadores que utilizam o ecossistema Helios (helios-project), motion.dev e ElevenLabs. A skill primeiro extrai a identidade visual e tonal da marca, seja analisando o repositório de código do usuário ou pesquisando uma URL fornecida. Em seguida, opcionalmente, gera música instrumental personalizada com a ElevenLabs, analisa o áudio com ffmpeg para extrair BPM e batidas, e sincroniza todas as animações motion.dev com esse mapa de tempo. O resultado é um arquivo `composition.html` com animações CSS/WAAPI sincronizadas, que é renderizado para MP4 através da CLI oficial do Helios. A skill enfatiza a ausência de aleatoriedade, a sincronização determinística e o alinhamento criativo com a identidade da marca, sendo especialmente útil para times de marketing, devs de produto e criadores de conteúdo que desejam gerar vídeos promocionais consistentes com a marca sem edição manual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/promo-video

Perguntar na sua IA favorita

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

Documentação

Você pode estar operando dentro do repositório da marca, ou trabalhando a partir de um contexto externo.

Não adivinhe a identidade da marca. Analise o código-fonte ou pesquise a URL fornecida.


PIPELINE DE EXECUÇÃO

ETAPA 1 — Coletar Contexto

⛔ PARE. Pergunte ao usuário estas duas perguntas:

  1. "Estamos dentro do repositório da sua marca, ou você gostaria de fornecer uma URL (por exemplo, seu site de marketing) para que eu possa pesquisar sua marca online?"

  2. "Você gostaria de música de fundo gerada? Se sim, você precisará de uma ELEVEN_LABS_API_KEY em seu ambiente. Você pode obter uma em https://elevenlabs.io → Perfil → Chaves de API."

Aguarde o usuário responder a ambas as perguntas.

Não tente ler arquivos .env ou verificar chaves você mesmo. Confie nas respostas do usuário.

Se o usuário fornecer uma URL, use-a para pesquisa de marca na ETAPA 3 em vez de analisar o código-fonte. Se o usuário recusar a música, pule a ETAPA 4 e a ETAPA 5.


ETAPA 2 — Garantir Dependências de Runtime do Helios

Instale os pacotes necessários:

npm install @helios-project/core @helios-project/renderer @helios-project/cli

Você renderizará usando o modo DOM.


ETAPA 3 — Extrair Inteligência da Marca do Repositório

Se o usuário forneceu uma URL em vez de um repositório, busque essa URL e extraia os mesmos sinais da marca do site ativo. Pule itens específicos do código-fonte (config do Tailwind, tokens de design, etc.) e foque nos elementos visíveis da marca.

Analise:

• Config do Tailwind ou variáveis CSS • Folhas de estilo globais • Tokens de design • Ativos de logotipo • Favicon • Seções de herói • Cópias de marketing • Estrutura de CTA • Posicionamento do produto • Componentes de UI • Uso existente de motion

Construa o perfil interno da marca:

• Proposta de valor central • Público-alvo • Tom de voz • Densidade visual • Paleta primária • Paleta de destaque • Caráter tipográfico • Posicionamento emocional

Todas as decisões criativas devem estar alinhadas com isso.


ETAPA 4 — Gerar Música Original (Pular se não houver música)

Use a ElevenLabs com a ELEVEN_LABS_API_KEY existente.

Gere uma faixa instrumental que corresponda a:

• Tom da marca • Arco emocional • Tempo de execução alvo

Salve o áudio localmente.


ETAPA 5 — Analisar Áudio Com ffmpeg (Pular se não houver música)

Extraia:

• BPM • Marcas de tempo das batidas • Tempos fortes • Picos de energia

Crie um mapa de tempo das batidas.

Todas as animações devem estar alinhadas a este mapa de tempo.


ETAPA 6 — Ler Regras de Design de Motion

Antes de produzir a especificação criativa, leia e internalize:

skills/guided/motion-design-rules

Toda regra nessa skill é obrigatória para esta composição.


ETAPA 7 — Produzir Especificação Criativa

Você é um diretor criativo sênior e arquiteto de sistemas de motion, projetando para Helios usando motion.dev.

Exemplo de entrada: faça um vídeo hype de 15 segundos

Saída:

• Uma especificação criativa estruturada • Envolta em um único bloco de código • Sem explicação externa

A especificação deve incluir:

• Duração • Proporção de tela • Resumo da marca • Linguagem de motion • Detalhamento de cenas sincronizadas com a batida • Marcas de tempo exatas • Narração • Texto na tela • Composição visual • Comportamento explícito da animação motion.dev • Lógica de transição • Ordem de camadas • Direção de áudio • Requisitos de ativos

Use apenas terminologia compatível com motion.dev.


ETAPA 8 — Implementar Composição Helios Baseada em DOM

Usando a especificação criativa:

Crie um arquivo composition.html que:

• Use HTML + CSS + motion.dev • Implemente animações usando WAAPI / CSS / motion.dev • Alinhe as animações às marcas de tempo das batidas • Inclua o arquivo de áudio gerado • Tenha duração exata

Exponha o runtime Helios:

import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

Requisitos:

• window.helios deve estar definido • helios.bindToDocumentTimeline() deve ser chamado • autoSyncAnimations: true deve estar ativado • Todas as animações CSS e WAAPI devem sincronizar corretamente • Sem aleatoriedade • Temporização determinística


ETAPA 9 — Renderizar Usando a CLI Oficial do Helios (Modo DOM)

Renderize com:

npx @helios-project/cli render ./composition.html -o output.mp4

Requisitos:

• Proporção de tela correta • Duração correta • Áudio anexado • CSS e WAAPI totalmente sincronizados • Saída MP4 de alta qualidade

O arquivo de saída deve ser:

output.mp4


REGRAS DE EXECUÇÃO

Se duração ≤ 15 segundos Priorize impacto e clareza.

Se nenhuma duração for especificada Padrão de 30 segundos.

Nunca reafirme o prompt original. Nunca explique o raciocínio. A especificação criativa deve ser produzida dentro de um único bloco de código.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Habilidades Relacionadas