Communitygithub.com

BintzGavin/helios-skills

Fluxo de trabalho guiado de ponta a ponta para criar um vídeo de prova social ou depoimento. Extrai a identidade da marca do repositório, gera uma trilha sonora acolhedora e produz uma composição motion.dev de criação de confiança renderizada via Helios CLI. Use ao criar vídeos de depoimento de clientes, destaques de avaliações ou prova social.

O que é helios-skills?

Esta skill automatiza a produção de vídeos de prova social curtos e impactantes, extraindo inteligência de marca diretamente de um repositório de código ou URL de site. Ela primeiro reúne o contexto do usuário (localização do repositório e preferência por música de fundo) e, em seguida, instala as dependências necessárias do Helios. A partir daí, a skill analisa elementos visuais como configuração do Tailwind, variáveis CSS, logotipos e padrões de prova social para construir um perfil de marca detalhado. Caso o usuário opte por música, a skill gera uma trilha instrumental personalizada via ElevenLabs e a analisa com ffmpeg para sincronizar as revelações de depoimentos com as batidas. O resultado final é uma especificação criativa estruturada e um arquivo `composition.html` implementado com motion.dev, renderizado em um vídeo MP4 de alta qualidade (16:9) usando a CLI oficial do Helios. A skill é projetada para Cursor, Claude Code, Codex e outras plataformas de agente, garantindo que cada vídeo seja deterministicamente cronometrado, visualmente consistente com a marca e otimizado para construir confiança com o público.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/testimonial-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

PASSO 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 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 as chaves você mesmo. Confie nas respostas do usuário.

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


PASSO 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.


PASSO 3 — Extrair Inteligência de 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 do código-fonte (configuração do Tailwind, tokens de design, etc.) e concentre-se em elementos visíveis da marca.

Analise:

• Configuração do Tailwind ou variáveis CSS • Folhas de estilo globais • Tokens de design • Ativos de logotipo • Favicon • Seções ou componentes de depoimentos • Exibições de avaliações/classificações • Logotipos de clientes ou seções de parceiros • Selos de confiança ou marcas de certificação • Padrões de prova social (contadores, estatísticas, logotipos) • Cópias de marketing e propostas de valor • Estrutura de CTA

Construa um perfil de marca interno:

• Proposta de valor central • Público-alvo • Tom de voz (acolhedor, autêntico, confiável) • Densidade visual • Paleta primária • Paleta de destaque (tons quentes para confiança) • Caráter tipográfico • Estratégia de prova social (citações, estatísticas, logotipos ou combinação)

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


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

Use o ElevenLabs com a ELEVEN_LABS_API_KEY existente.

Gere uma faixa instrumental que corresponda a:

• Tom acolhedor e edificante • Construção suave até o clímax emocional • Inspirador, mas não agressivo • Tempo de execução alvo

Salve o áudio localmente.


PASSO 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.

As revelações de citações devem cair nos tempos fortes. As revelações de nome/título devem alinhar-se com as batidas.


PASSO 6 — Ler Regras de Design de Movimento

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

skills/guided/motion-design-rules

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


PASSO 7 — Produzir Especificação Criativa

Você é um diretor criativo sênior e arquiteto de confiança de marca, projetando para Helios usando motion.dev.

Exemplo de entrada: faça um vídeo de depoimento de 30 segundos

Saída:

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

A especificação deve incluir:

• Duração • Proporção de aspecto (16:9) • Resumo da marca • Linguagem de movimento (acolhedor, elegante, deliberado) • Divisão de cenas sincronizadas com batidas • Marcas de tempo exatas • Narração (opcional — pode usar abordagem somente texto) • Texto na tela (citações, atribuição, estatísticas, CTA) • Composição visual (cartões de citação, avatares, classificações por estrelas, logotipos de clientes) • Comportamento explícito de animação motion.dev • Lógica de transição (fades suaves, slides suaves, escala sutil) • Ordem de camadas (textura de fundo → cartão de citação → avatar/foto → atribuição → estatísticas) • Direção de áudio • Requisitos de ativos • Hierarquia tipográfica (texto de citação grande, atribuição menor, estatísticas proeminentes)

Use apenas terminologia compatível com motion.dev.

Requisitos de estrutura de depoimento:

• Momento de abertura da marca ou contextualizador (2-3 segundos) • Citação 1: Citação completa com atribuição • Citação 2: Citação completa com atribuição (se a duração permitir) • Estatísticas de prova social (números, classificações, contagem de clientes) • CTA de encerramento com marca

Cada segmento de citação: • Texto da citação anima (máquina de escrever ou fade-in por linha) • Breve pausa para leitura • Atribuição aparece (nome, cargo, empresa) • Opcional: logotipo da empresa do cliente ou avatar


PASSO 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 revelações de citações com as batidas • Use tipografia elegante de cartão de citação • Inclua elementos decorativos de aspas • 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 • As citações devem permanecer legíveis por no mínimo 4 segundos cada • As classificações por estrelas devem animar sequencialmente


PASSO 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 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 duração ≤ 15 segundos Mostre 1 citação + 1 estatística + CTA. Priorize a citação mais forte.

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

Máximo de 3 citações para qualquer duração. As citações devem ser reais ou representativas — nunca invente. Se não houver depoimentos no repositório, use uma estrutura de espaço reservado com rótulos claros.

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

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 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

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