Communitygithub.com

BintzGavin/helios-skills

Fluxo de trabalho guiado de ponta a ponta para criar vídeos explicativos ou de demonstração. Extrai a identidade da marca do repositório, gera uma trilha sonora personalizada e produz uma composição motion.dev narrativa renderizada via Helios CLI. Use ao criar vídeos de 'como funciona', demonstração de recursos ou educacionais.

O que é helios-skills?

Esta skill oferece um pipeline completo e automatizado para a criação de vídeos explicativos profissionais, como demonstrações de funcionalidades e vídeos educacionais. Ela é projetada para ser usada com agentes de IA como Claude Code, Cursor ou Codex, que operam dentro do contexto de um repositório de marca ou a partir de uma URL fornecida. O processo começa com a extração inteligente da identidade da marca a partir do código-fonte (arquivos de configuração Tailwind, variáveis CSS, logotipos, tom de voz) ou de um site ao vivo. Opcionalmente, a skill pode gerar uma trilha sonora original usando a API ElevenLabs, analisá-la com ffmpeg para sincronizar as transições do vídeo com as batidas da música e, em seguida, gerar uma especificação criativa detalhada. A composição final é implementada como um arquivo HTML usando motion.dev e WAAPI, e renderizada em um vídeo MP4 de alta qualidade (proporção 16:9) através da CLI oficial do Helios. O resultado é um vídeo narrativo, sincronizado com a marca e com ritmo definido, sem exigir edição manual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/explainer-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 a base de código ou pesquise a URL fornecida.


PIPELINE DE EXECUÇÃO

ETAPA 1 — Coletar Contexto

⛔ PARE. Faça estas duas perguntas ao usuário:

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

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

Aguarde a resposta do usuário para 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 a base de código. 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 de marca do site ativo. Pule itens específicos da base de código (config do Tailwind, tokens de design, etc.) e concentre-se nos elementos visíveis da marca.

Analise:

• Config Tailwind ou variáveis CSS • Folhas de estilo globais • Tokens de design • Ativos de logotipo • Favicon • Estrutura da documentação • Descrições de recursos • Fluxos de integração • Texto de ajuda e microcópias • Arquitetura da informação • Componentes de UI • Uso existente de animação

Construa o perfil interno da marca:

• Proposta de valor central • Público-alvo • Tom de voz (instrucional, solidário, autoritário) • Densidade visual • Paleta primária • Paleta de destaque • Caráter tipográfico • Padrões de hierarquia de informação • Estilo de explicação (visual primeiro vs. pesado em texto)

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


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

Use ElevenLabs com a ELEVEN_LABS_API_KEY existente.

Gere trilha instrumental que combine com:

• Tom calmo e solidário • Progressão constante sem picos dramáticos • Presença sutil de fundo (não deve competir com a narração) • Duraçã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 temporização das batidas.

As transições de seção devem se alinhar aos tempos fortes. As revelações de texto na tela devem se alinhar às batidas.


ETAPA 6 — Ler as Regras de Design de Movimento

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

skills/guided/motion-design-rules

Todas as regras nessa skill são obrigatórias para esta composição.


ETAPA 7 — Produzir Especificação Criativa

Você é um diretor criativo sênior e arquiteto de design instrucional projetando para o Helios usando motion.dev.

Exemplo de entrada: explique como funciona nosso fluxo de checkout em 60 segundos

Saída:

• Uma especificação criativa estruturada • Dentro de um único bloco de código • Nenhuma explicação fora dele

A especificação deve incluir:

• Duração • Proporção de tela (16:9) • Resumo da marca • Arco narrativo (Introdução → Problema → Solução → Como Funciona → CTA) • Linguagem de movimento (medida, deliberada, progressiva) • Divisão de seção sincronizada com batidas • Marcas de tempo exatas por seção • Roteiro de narração (conversacional, claro) • Texto na tela (cabeçalhos de seção, rótulos de recursos, números de etapas) • Composição visual (layouts limpos, espaçamento generoso) • Comportamento de animação explícito do motion.dev • Lógica de transição (crossfades suaves entre seções, slide-ins para conteúdo) • Ordem de camadas • Direção de áudio • Requisitos de ativos • Indicadores de etapa ou marcadores de progresso

Use apenas terminologia compatível com motion.dev.

Requisitos de estrutura narrativa:

• Gancho de abertura (primeiros 5 segundos) • Identificação do problema • Introdução da solução • Passo a passo • Resumo e CTA


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 transições de seção às batidas • Use cabeçalhos de seção claros com numeração de etapas • Inclua o arquivo de áudio gerado • Tenha duração exata • Priorize legibilidade e clareza visual

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 • Nenhuma aleatoriedade • Temporização determinística • O texto deve permanecer na tela tempo suficiente para ser lido (mínimo 3 segundos por mensagem chave)


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 16:9 • 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 a duração for ≤ 30 segundos Comprimir para: Gancho → Conceito Central → CTA.

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

Máximo de 5 seções para qualquer duração. Cada seção deve ter um cabeçalho claro na tela. O ritmo deve permitir compreensão — nunca apresse a informação.

Nunca repita o prompt original. Nunca explique o raciocínio. A especificação criativa deve ser fornecida 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

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 promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

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