/brag: o guia completo para transformar seu projeto em vídeo de lançamento

Você terminou um app, um site ou um protótipo. O código está pronto, mas falta o mais chato: mostrar isso para alguém num formato que dê vontade de compartilhar. Print não convence, gravação de tela dá trabalho e editar vídeo come uma noite inteira.

O /brag ataca exatamente esse intervalo. É uma skill para agentes de código (Claude Code, Codex, Cursor e outros) que lê o projeto, inventa um ângulo de lançamento, escreve o roteiro e o storyboard e renderiza um vídeo curto, com música, efeitos e uma legenda pronta para postar. O repositório é de Shunit Haviv Hakimi, tem licença MIT e passava de 12 mil estrelas no GitHub em 1º de outubro de 2026.

Este guia reúne tudo o que importa antes de rodar: como funciona por dentro, qual versão usar, instalação, opções, o que sai na pasta, o que ela faz (e não faz) com seus arquivos e quais são os limites. Tudo vem do README e do código das skills no repositório oficial.

O /brag não é um gerador de vídeo genérico. Ele é um roteiro de trabalho que o seu agente segue. A skill define como olhar o projeto, como contar a história e quais regras o vídeo precisa respeitar; a parte pesada de montar e renderizar o vídeo fica com o motor de vídeo.

No /brag completo, esse motor é o Hyperframes, da HeyGen, em que agentes compõem vídeo escrevendo código. O /brag cuida do o quê (ângulo, roteiro, tom, áudio) e o Hyperframes cuida do como (composição, tempo exato das animações, validação e render).

O ponto mais importante: ele lê o código, não um site no ar. Não precisa de URL publicada nem de print. Se o projeto roda na sua máquina, é matéria-prima suficiente.

A skill é organizada em quatro etapas, cada uma com uma condição de saída (um "gate") que o agente precisa cumprir antes de seguir:

1. Inspecionar o projeto. O agente lê index.html, estilos, README, package.json, rotas e componentes. Extrai cores, fontes e o texto do próprio produto. Depois responde a um questionário de 9 perguntas: o que é o app, qual a afirmação mais engraçada ou impressionante, qual o gancho visual, o que mostrar da interface real, qual o vídeo mais curto que funciona, qual tom, como deve soar o áudio, qual a legenda e qual o fluxo de uso (entrada, ação principal, resultado). A skill insiste em mostrar o produto em uso, não só a landing page.
2. Planejar e criar o storyboard. Escreve o brag-plan.md com o ângulo criativo e a sequência cena a cena (texto, tempo, transições, efeitos sonoros). A soma das cenas tem de ficar entre 15 e 25 segundos.
3. Passar para o Hyperframes. Escreve um brief de composição e o Hyperframes constrói o vídeo em composition/. O gate é o comando npx hyperframes check sem nenhum erro, incluindo contraste de texto (WCAG) e estouro de layout.
4. Validar, renderizar e entregar. Pré-visualização local, render do brag.mp4, escolha da melhor imagem como capa (brag.jpg) e share-copy.txt com a legenda.

Um detalhe esperto da etapa 4: a capa escolhida é gravada como o primeiro quadro do vídeo. Plataformas como Slack, X e Discord geram a miniatura sozinhas a partir do quadro 0 e ignoram metadados de capa. Assim a miniatura fica sob seu controle em qualquer lugar.

O repositório traz duas skills. A escolha é automática em parte dos casos, mas vale entender a diferença:

Quando você está no Opus 5.5 e roda /brag sem pedir nada especial, a skill completa troca sozinha para o /brag-slim e avisa em uma linha. Para ficar no fluxo clássico, use /brag --full (ou peça "use the full brag"). Pedir --voice também mantém o fluxo completo, porque o slim não faz narração.

Regra prática: Opus 5.5 e quer simplicidade, vá de /brag-slim. Quer narração, trilha embutida e o pipeline do Hyperframes, ou usa outro agente, vá de /brag completo.

Os comandos abaixo são os do README oficial. Escolha o do agente que você usa.

Claude Code

No terminal do Claude Code, em duas linhas:

/plugin marketplace add latent-spaces/brag
/plugin install brag@brag

O plugin inclui o /brag-slim desde a versão 0.4.0. Se você já tinha o plugin, atualize no terminal:

claude plugin update brag

Codex

codex plugin marketplace add latent-spaces/brag
codex plugin add brag@brag

Para atualizar depois: codex plugin marketplace upgrade brag e codex plugin add brag@brag de novo. O empacotamento oficial para Codex entrou no repositório em 29/09/2026.

Cursor, Copilot, Gemini CLI, opencode e outros

Um comando pela CLI skills:

npx skills add https://github.com/latent-spaces/brag --skill brag

Acrescente -g para instalar globalmente (vale em qualquer projeto). Sem o -g, a skill fica só no projeto atual.

Só o /brag-slim

npx skills add https://github.com/latent-spaces/brag --skill brag-slim

Sem instalador

Copie as pastas direto para o diretório de skills do agente e reinicie o Claude Code:

rsync -a --exclude '.DS_Store' skills/brag/ ~/.claude/skills/brag/
rsync -a --exclude '.DS_Store' skills/brag-slim/ ~/.claude/skills/brag-slim/

O repositório também expõe a skill nos caminhos padrão de descoberta por links simbólicos: Google Antigravity (.agents/skills/brag/), opencode (.opencode/skills/brag/), Codex CLI (.agents/skills/brag/) e Claude Code (.claude/skills/brag/). No Windows, o Git precisa de core.symlinks true e modo desenvolvedor; se os links não funcionarem, copie a pasta manualmente. Para agentes sem descoberta de skills, o repositório documenta colar o conteúdo de skills/brag/SKILL.md nas instruções personalizadas.

Antes do primeiro vídeo, confira estes pontos. Quase todo erro de primeira vez vem daqui:

• Node.js 22 ou superior. Confira com node -v.
• FFmpeg no PATH. Confira com ffmpeg -version. É ele que monta a capa e fixa o quadro 0 do vídeo.
• Hyperframes CLI (só no /brag completo). Rode npx hyperframes doctor para ver se o ambiente está certo.
• Terminal na pasta do projeto certo. A skill lê o diretório atual.
• README e textos do produto em ordem. O vídeo usa as palavras do próprio projeto; se o README for vago, o vídeo também será.
• Um fluxo de uso claro. Saiba dizer em uma frase: o usuário chega, faz X e obtém Y. É isso que o storyboard procura.

Com a skill instalada, abra o agente na pasta do projeto e peça:

let's /brag

Você pode dirigir o resultado com instruções livres ou com opções:

/brag --tone "fake Series A launch from 2016"
/brag --tone polished --format vertical
/brag --voice

Na versão slim, o vídeo sai a 30 fps em 1920×1080 (paisagem), 1080×1920 (vertical) ou 1080×1080 (quadrado). Se você pedir um tom livre, a skill mapeia para o preset mais próximo para definir ritmo e estrutura, mas preserva a sua direção no plano.

Fluxo sugerido para a primeira vez: rode sem opções, assista, e só então ajuste. Peça para refazer uma cena ou trocar o tom em vez de reescrever o pedido inteiro. Na primeira rodada o objetivo é ver o que o agente entendeu do seu projeto.

São sete tons prontos. Cada um muda a energia do roteiro, o ritmo, a tipografia e as transições:

Para um produto de empresa séria (CRM, painel, ferramenta de governança), polished ou app-store costumam ser o ponto de partida. Os tons mais caricatos funcionam melhor em projetos pessoais e de brincadeira.

Cada execução grava numa pasta brag-output/ dentro do projeto. Se ela já existir, a skill cria uma versão com data e hora (brag-output-2026-10-01-143022/) para não sobrescrever o que você já tinha.

A legenda é pensada para ser específica e sem clichê. Ainda assim, leia antes de postar: é o seu nome que vai embaixo.

As regras criativas são o que separa o /brag de um "faz um vídeo aí". Elas valem em qualquer tom e ajudam você a julgar o resultado:

• Curto. 15 a 25 segundos. Mesmo com narração, a janela não aumenta.
• O gancho decide tudo. Os 2 primeiros segundos são planejados antes do resto. A estrutura típica é gancho, revelação, 2 a 3 destaques e uma frase final.
• Legível. Cada frase fica na tela por cerca de 0,3 s por palavra. Um rótulo curto fica uns 0,8 s. O ritmo vem de movimento e cortes, não de texto que some antes de dar para ler.
• Específico. O vídeo precisa parecer feito para aquele projeto. Frases como "otimize seu fluxo de trabalho" são proibidas; vale o texto e as afirmações do próprio produto.
• Mostre a coisa. Pelo menos uma cena precisa exibir interface, texto ou visual real do produto. Nada de enchimento abstrato.
• Cada quadro é postável. Qualquer imagem congelada do vídeo deveria valer um compartilhamento.

Na prática, isso significa que a qualidade do vídeo depende da qualidade do material de origem: um projeto com texto claro, interface cuidada e um fluxo simples rende um vídeo melhor do que um repositório cheio de telas genéricas.

É a parte que quase ninguém lê e a que mais importa para uso profissional. O repositório documenta cuidados explícitos, e também há pontos que você precisa checar:

• Segredos ficam de fora. A skill foi ajustada (commit de 19/09/2026) para pular arquivos com segredos na inspeção e mantê-los fora do vídeo. Mesmo assim, não rode em pasta com credenciais soltas e revise o vídeo antes de publicar.
• Tudo é local. Uma execução do /brag só renderiza no seu computador. A skill proíbe rodar hyperframes publish ou hyperframes auth: publicar a composição é decisão sua, não do agente.
• Afirmações precisam existir no projeto. Desde 22/09/2026 há uma regra para "ancorar" nomes, números, capacidades e citações no que o projeto realmente escreve. Ela evita um vídeo dizer "10x mais rápido" quando ninguém nunca escreveu isso. Continua sendo seu papel conferir: o hyperframes check valida estrutura, não verdade.
• A trilha precisa de checagem de licença. As músicas embutidas são da série "Happy Beats / Business Moves", do ende.app, e os efeitos são CC0 da Kenney. O próprio README das músicas, no repositório, avisa que os termos exatos da licença ainda devem ser verificados e documentados antes de redistribuir. Se o vídeo vai em anúncio ou material comercial da sua empresa, confirme a licença da faixa ou use --no-music e coloque a sua trilha.
• O código vai para o seu agente. Como qualquer skill, o conteúdo lido é enviado ao modelo que você usa. Em projeto de cliente ou código proprietário, confirme se o contrato e a política do provedor permitem.

O /brag é bom no que se propõe. Para não se frustrar, saiba onde ele não ajuda:

• Não é um vídeo de demonstração longo. São 15 a 25 segundos de lançamento, não tutorial.
• Paisagem é o padrão. Para Reels, TikTok e Shorts peça --format vertical logo na primeira rodada.
• Depende de ambiente. Sem Node 22+, FFmpeg ou Hyperframes funcionando, o fluxo completo trava.
• Narração é opcional e só no completo. Se quiser voz no /brag-slim, terá de gravar ou gerar por fora.
• Funciona melhor com projeto que tem interface. Biblioteca ou serviço de backend sem tela dão menos "coisa para mostrar".
• Não substitui revisão humana. Confira o que o vídeo promete, o nome, a marca, o contraste e o áudio antes de publicar.

Para ver o que a ferramenta consegue, o repositório inclui cinco sites de mentira usados como suíte de teste (Horse Tinder, Taxi for Taxis, Fish Flight School, Bicycles for Snakes e Psychologists for Chatbots), cada um com seu brag.mp4. O vídeo do hero do site de lançamento foi feito pelo próprio /brag no repositório dele.

1. Instale (ou atualize) a skill do seu agente.
2. Confira Node 22+, FFmpeg e npx hyperframes doctor.
3. Abra o agente na pasta do projeto certo, sem segredos soltos.
4. Deixe o README e os textos do produto claros e liste o fluxo (entrada, ação, resultado).
5. Rode let's /brag sem opções na primeira vez.
6. Leia o brag-plan.md: o ângulo está certo? As afirmações existem no projeto?
7. Assista ao vídeo e ajuste tom, formato ou cena.
8. Decida o formato por canal (vertical para Reels, TikTok e Shorts).
9. Confira a licença da música se for uso comercial.
10. Revise share-copy.txt, escolha a capa e publique por sua conta.

O /brag mostra uma tendência que já vale para qualquer equipe: o que era tarefa de "marketing depois" (explicar o que foi construído) vira etapa automática do ciclo de desenvolvimento. O ganho é real quando o produto já existe e a comunicação ficou atrasada.

O risco também é real: um agente que escreve afirmações em nome da sua marca precisa de regra, dono e revisão. A skill traz regras boas (afirmações ancoradas, tudo local, segredos fora), mas a decisão de publicar continua sendo humana. Esse é o mesmo princípio que usamos na Rafique AI para qualquer automação com IA: dono, limite e evidência antes de ir para produção.

Como fizemos este guia: a partir do README e do código-fonte das skills (SKILL.md, referências e arquivos de música) no repositório oficial em 1º/10/2026. Ainda não publicamos um vídeo gerado por ela num projeto nosso; quando publicarmos, contamos o resultado e o custo aqui.

• latent-spaces/brag: repositório oficial (README, skills, licença MIT)
• skills/brag/SKILL.md: skill completa (etapas, opções, tons e regras)
• skills/brag-slim/SKILL.md: skill enxuta para o Opus 5.5
• Site de lançamento do /brag
• Hyperframes (HeyGen): motor de vídeo usado pelo /brag completo
• vercel-labs/skills: a CLI npx skills usada na instalação
• ende.app: origem da música embutida e Kenney: efeitos sonoros CC0