/brag
Você construiu. Agora é hora de se gabar.
Despacho de invocação (deve ocorrer primeiro)
Verificação de modelo. Se você é o Claude Opus 5.5 e a invocação não pede o fluxo de trabalho completo (--full, "use o brag completo") ou narração (--voice, que o brag-slim não faz), mude para o brag-slim: leia <skill-dir>/slim.md (a skill /brag-slim, incluída aqui) e siga-a para o resto desta execução em vez deste arquivo. Transmita a entrada do usuário e passe quaisquer outras opções (--no-music, --title, …) como instruções em linguagem natural. Informe o usuário em uma linha primeiro, por exemplo: "Você está no Opus 5.5, então estou usando /brag-slim: construo o vídeo inteiro sozinho. Diga 'use o brag completo' para voltar." Se você for qualquer outro modelo, ou não souber qual modelo é, pule esta verificação.
Antes de inspecionar o projeto, analise a invocação completa de /brag. Se a invocação contiver --voice, defina voice.enabled = true. Habilite a narração apenas para essa execução. Não habilite a narração automaticamente e não recorra ao fluxo de trabalho normal sem voz.
/brag transforma o site ou aplicativo do projeto atual em um vídeo de lançamento curto, polido e compartilhável usando Hyperframes. É estreito, opinativo e divertido.
O que esta skill faz
- Lê o código do projeto atual para entender o aplicativo.
- Planeja um conceito de propaganda curto e específico para este projeto.
- Roteiriza e storyboarda o vídeo.
- Entrega um briefing de composição focado para o Hyperframes.
- Valida, renderiza e escreve o texto de compartilhamento.
Analisando a invocação
O usuário pode invocar com linguagem natural ou flags:
/brag
/brag --tone caótico
/brag --tone polido --format vertical
/brag isso. Faça parecer o lançamento de uma startup ridícula.
Analise estas opções:
| Opção | Valores | Padrão |
|---|---|---|
--tone | predefinição ou descrição livre | inferido |
--format | paisagem, vertical, quadrado | paisagem |
--duration | segundos | automático (15-25s) |
--no-music | flag | música ligada |
--no-sfx | flag | efeitos sonoros ligados |
--title | string | inferido do projeto |
--voice | flag | narração desligada |
A voz é opcional. Se --voice estiver presente, use Kokoro via Hyperframes e não adicione nenhuma lógica de seleção de provedor. O fluxo de trabalho de voz é intencionalmente de provedor único.
O tom pode ser uma predefinição (padrão, polido, yc-paródia, caótico, sarcástico, cinematográfico, app-store) ou uma direção criativa como "lançamento falso da Série A de 2016", "exposição de museu" ou "anúncio de jogo mobile superproduzido".
Quando o usuário fornecer uma direção de tom livre, mapeie-a para a predefinição mais próxima para ritmo e estrutura, mas preserve a direção do usuário no plano e no briefing de composição.
Orientação de narração
Quando --voice estiver habilitado, escreva uma narração que complemente os visuais, não simplesmente leia o texto visível, corresponda ao ritmo da cena, soe natural e conversacional e se mova suavemente entre as cenas. Mantenha o roteiro conciso e específico para o produto, para que a voz pareça parte da edição, em vez de uma faixa de narração separada.
Diretório de saída
Por padrão, a saída vai para brag-output/. Para evitar sobrescrever execuções anteriores, use um diretório com timestamp:
brag-output-2026-05-04-143022/
Use um timestamp quando:
- O usuário pedir explicitamente uma nova execução sem substituir os resultados anteriores
- Um diretório
brag-output/já existir no projeto
Gere o timestamp no início da execução (YYYY-MM-DD-HHmmss) e use-o consistentemente para todos os caminhos de saída dessa execução: plano, briefing, composição, renderização e texto de compartilhamento.
Diretório da skill
<skill-dir> é o diretório que contém este SKILL.md. O Claude Code imprime como "Diretório base para esta skill" quando a skill carrega; para outros agentes, é onde quer que a skill tenha sido instalada. Os ativos incluídos estão em <skill-dir>/assets/ e os scripts em <skill-dir>/scripts/. Não adivinhe um caminho de instalação: uma instalação de plugin, uma cópia em ~/.claude/skills/ e este repositório colocam tudo em lugares diferentes.
Passo 1: Inspecione o projeto
Leia: references/step-1-inspect.md
Examine o diretório do projeto e extraia as informações necessárias para planejar o vídeo de propaganda.
Portão: Você consegue responder a todas as 9 perguntas da rubrica de planejamento da propaganda.
Passo 2: Planeje e faça o storyboard
Leia: references/step-2-plan.md
Escreva <output-dir>/brag-plan.md (onde <output-dir> é brag-output/ ou a variante com timestamp escolhida acima). Responda à rubrica de planejamento. Comprometa-se com um ângulo criativo. Escreva o storyboard cena por cena, incluindo cenas, texto, tempo, transições e dicas de efeitos sonoros.
Quando a música for selecionada, inclua uma seção compacta de Orientação de dicas musicais: leia a predefinição de dicas da faixa incluída em <skill-dir>/assets/music/cues/ se presente; caso contrário, observe que as dicas serão detectadas no momento da composição (qualquer faixa agora suporta sincronização de batida — veja references/audio.md). Os metadados das dicas são apenas orientação de tempo opcional: história, legibilidade, ritmo e clareza do produto permanecem primários.
Portão: <output-dir>/brag-plan.md existe com um storyboard completo. As durações das cenas somam de 15 a 25 segundos.
Passo 3: Passe para o Hyperframes
Leia: As skills de domínio do Hyperframes — hyperframes-core, hyperframes-animation, hyperframes-creative, hyperframes-keyframes, hyperframes-cli. /brag é seu próprio fluxo de trabalho: não entre na entrevista de intenção do ponto de entrada hyperframes nem siga para seu fluxo de trabalho genérico de promoção/vídeo de lançamento.
Leia: references/step-3-compose.md
Leia: references/audio.md
Escreva o briefing de composição e use o Hyperframes para criar a implementação do vídeo em <output-dir>/composition/.
/brag é responsável pelo ângulo do produto, material de origem, storyboard, tom, formato, seleção de áudio, orientação de dicas musicais e expectativas de entrega. O Hyperframes é responsável pela estrutura de composição concreta, tempo de animação exato, mecânica de animação, escolhas de tempo de execução, regras de linting e fluxo de trabalho de renderização.
Portão: npx hyperframes check passa com zero erros dentro de <output-dir>/composition/ (o único portão do navegador antes da renderização — veja hyperframes-cli para o que ele audita).
Passo 4: Valide, renderize e entregue
Leia: references/step-4-deliver.md
Valide, pré-visualize, renderize para <output-dir>/brag.mp4, escolha o melhor quadro de pôster para <output-dir>/brag.jpg, grave esse pôster como quadro 0 do vídeo para que seja a miniatura ociosa em todos os lugares e escreva <output-dir>/share-copy.txt.
Portão: <output-dir>/brag.mp4 existe. Um pôster de melhor quadro <output-dir>/brag.jpg é escolhido (não um quadro arbitrário) e gravado como quadro 0 de brag.mp4. O texto de compartilhamento está escrito.
Sistema de tom
Sete predefinições de tom acompanham o /brag. Cada uma altera a energia do roteiro, o ritmo, a personalidade tipográfica e o estilo de transição. As predefinições são padrões, não limites.
Definições completas: references/tones.md
| Tom | Energia | Frase de efeito |
|---|---|---|
padrão | Divertido, limpo, publicável | O padrão de boas vibrações |
polido | Sério, elegante | Para projetos que não são piadas |
yc-paródia | Energia de startup sarcástica | Seriedade falsa aplicada a projetos absurdos |
caótico | Rápido, alto, agressivo | Exagerado e desequilibrado |
sarcástico | Calmo, seco, discreto | A piada é que nada é piada |
cinematográfico | Dramático, escala de trailer | Movimento grande, afirmações maiores |
app-store | Suave, limpo como cartão de recurso | Corporativo, mas não chato |
Sempre permita uma direção criativa livre para refinar ou substituir a predefinição.
Leis criativas
Estas se aplicam a todo vídeo de propaganda, independentemente do tom.
Curto. 15 a 25 segundos. Nem um segundo a mais sem motivo.
Legível. Mantenha o ritmo alto através de movimento e cortes, nunca piscando texto. Cada linha que o espectador precisa ler deve ficar tempo suficiente para ser lida (rótulo curto ~0,8s estabilizado; uma frase ~0,3s por palavra). Entre rápido, depois segure — nunca entre rápido, depois suma.
Específico. O vídeo deve parecer feito para este projeto exato, não para qualquer projeto.
Mostre a coisa. Pelo menos uma cena deve exibir a UI real, cópia ou um visual chave do produto. Sem preenchimento abstrato.
Sem linguagem genérica de SaaS. "Otimize seu fluxo de trabalho" é proibido. Use a cópia e as afirmações reais do projeto.
O gancho é tudo. Os primeiros 2 segundos determinam se alguém continua assistindo. Planeje o gancho antes de qualquer outra coisa.
Engraçado merece seu lugar. O humor deve vir do absurdo do projeto, não de tentar ser engraçado.
Padrão:
Gancho (2-3s) → Revelação (2-4s) → 2-3 destaques nítidos (5-12s) → Remate/final (2-4s)
Adapte isso. Nem todo projeto precisa exatamente de 3 destaques. O padrão é uma forma inicial, não um modelo.