Communitygithub.com

marcus/marcus-skills

Crie vídeos premium de demonstração de software e produtos que convertem. Abrange todas as fases, desde miniatura e roteiro até produção, narração, transições, design de som e distribuição. Use ao planejar, roteirizar, storyboard ou revisar qualquer vídeo de marketing de software — explicativos, tours de produto, destaques de funcionalidades, anúncios de lançamento, histórias de clientes ou vídeos de comparação.

O que é marcus-skills?

Esta skill, `marcus/marcus-skills`, é um guia completo para a criação de vídeos de demonstração de software de alta qualidade e alta conversão. Ela fornece um sistema completo que abrange desde a estratégia inicial e roteirização até a produção final e distribuição, com base nas práticas das melhores empresas de SaaS e agências de vídeo. A skill é agnóstica em relação à plataforma, podendo ser aplicada na criação de conteúdo para YouTube, sites de produtos, campanhas de marketing ou qualquer outro canal. Seu valor está em oferecer princípios testados, frameworks de roteiro (como Problema-Agita-Solução e Antes-Depois-Ponte), técnicas avançadas de produção (como design de som e sincronização de corte com a batida da música) e uma seção detalhada sobre otimização para distribuição (miniaturas, títulos e SEO). Para desenvolvedores, ela se destaca por incluir um pipeline técnico para produção assistida por IA, com instruções para usar a API do ElevenLabs para narração e um pipeline Remotion para sincronização automatizada de áudio e vídeo. Em resumo, a skill democratiza o conhecimento de produção de vídeo de nível profissional, transformando um processo complexo em um sistema replicável e orientado a resultados.

Funciona com~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/marcus/marcus-skills/tree/HEAD/skills/software-demo-video

Perguntar na sua IA favorita

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

Documentação

Vídeo de Demonstração de Software

Crie vídeos de produtos de software com aparência premium e que realmente convertam. Esta skill cobre todo o pipeline: estratégia, roteirização, produção e distribuição.

Início Rápido

  1. Escolha o tipo de vídeo - Corresponda ao estágio do funil e ao objetivo (veja Tipos de Vídeo abaixo)
  2. Escreva o roteiro - Escolha um framework, escreva seguindo a contagem de palavras, leia em voz alta (veja references/script-templates.md)
  3. Planeje a produção - Storyboard, selecione a música, prepare o ambiente (veja references/production-techniques.md)
  4. Produza - Grave, filme, anime, edite, misture
  5. Otimize para distribuição - Miniatura, título, SEO, estratégia de incorporação (veja references/thumbnails-and-distribution.md)

Princípios Fundamentais

Estes são os elementos que separam grandes vídeos de software dos esquecíveis. Derivados do estudo da Sandwich Video, Apple, Stripe, Linear, Arc, Figma, Descript e das principais agências de SaaS.

1. Comece com o problema do espectador, não com suas funcionalidades

Todo vídeo de software de alto desempenho abre com a dor que o espectador já sente. O produto aparece como a resolução, não como o assunto. O Slack abre com o caos da comunicação. O Salesforce abre com vendas em queda. O Monday.com abre com "Como é o seu trabalho ideal?" Listas de funcionalidades não criam desejo; problemas sentidos sim.

2. Uma grande ideia por vídeo

Se o espectador esquecer todo o resto, o que ele deve lembrar? Essa é a sua ideia central para o vídeo. Não três funcionalidades, não cinco benefícios. Uma ideia.

ERRADO: "Nossa plataforma tem gerenciamento de projetos, controle de tempo,
        faturamento, chat da equipe e armazenamento de arquivos."

CERTO: "Pare de alternar entre aplicativos. Tudo que sua equipe precisa
        está em um só lugar."

3. Mostre a mágica

A filosofia da Sandwich Video: identifique os momentos que fazem as pessoas pensarem "oh, isso é legal" e construa o vídeo em torno desses momentos. Encontre as 2-3 interações em seu produto que criam alegria genuína e dê a elas o máximo de tempo de tela.

4. Fisgue em 5 segundos ou os perca

55% dos espectadores vão embora em 60 segundos. Seus primeiros 5 segundos devem conquistar os próximos 55. Nunca abra com uma animação de logotipo, "bem-vindo de volta" ou contextualização. Abra com o problema, o resultado ou uma interrupção de padrão. Aberturas diretas superam as introduções de marca em todos os estudos de retenção.

5. O design de som é a técnica mais subestimada

Os sons de clique do Figma, a foley da Apple, o silêncio deliberado do Arc – o áudio transforma a forma como os espectadores percebem o conteúdo visual. Adicione sons sutis às interações da interface do usuário. Sincronize os cortes com as batidas da música. Um vídeo com bom design de som parece 2x mais polido do que um sem.

6. Combine o estilo do vídeo com a personalidade do produto

O minimalismo do Linear funciona porque o produto é minimalista. Os vlogs de quarto do Arc funcionam porque o produto é pessoal. Os esquetes de comédia do Descript funcionam porque o público é criativo. A incompatibilidade de estilo é pior do que um baixo valor de produção.

7. Gravações de tela não precisam parecer gravações de tela

Toda grande empresa tem uma estratégia: a Apple recria a UI em gráficos em movimento. O Figma adiciona sons de clique e rótulos de cursor. O Slack cria capturas de tela personalizadas idealizadas. O produto do Linear é bonito o suficiente para ser capturado diretamente. O Stripe trata o código como arte. Encontre sua abordagem.


Tipos de Vídeo

TipoDuraçãoFunilObjetivoPúblico
Explicativo60-90sTopo"O que é isso?"Prospects conscientes do problema
Tour do Produto2-4 minMeio"Como funciona?"Prospects em avaliação
Destaque de Funcionalidade30-90sMeio"O que isso pode fazer?"Usuários + avaliadores
História de Cliente60-120sFundo"Quem mais usa isso?"Compradores em fase de decisão
Vídeo de Lançamento30-90sTodos"O que há de novo?"Usuários + mercado
Comparação2-4 minFundo"Por que isso em vez de X?"Avaliadores ativos
Dica Rápida30-90sPós-venda"Como eu faço isso?"Usuários atuais
Marca/Cultura60-180sTopo"Quem são essas pessoas?"Talentos + curiosos

Veja references/script-templates.md para estruturas de roteiro detalhadas e modelos para preencher para cada tipo.


Frameworks de Roteiro

Escolha o framework que corresponde ao objetivo do seu vídeo. Cada um tem um modelo detalhado em references/script-templates.md.

Problema-Agita-Solução (PAS) – Mais comum

FaseTempoPalavrasPropósito
Problema15-20s30-40Nomeie a dor
Agitação15-20s30-40Mostre as consequências da inação
Solução25-30s50-60Apresente o produto como resolução
CTA5-10s10-20Próximo passo claro

Vídeos que usam a estrutura de resolução de problemas apresentam 60% mais engajamento.

Antes-Depois-Ponte (ADP) – Melhor para produtos visuais

Mostre a transformação: o mundo do espectador hoje, o mundo deles com seu produto, como o produto preenche a lacuna. Melhor para dashboards, ferramentas de design, analytics.

Conte-Mostre-Conte – Melhor para tours e tutoriais

Defina o contexto (conte), demonstre ao vivo (mostre), reforce o valor (conte). Aumenta a retenção em até 65%. Divida produtos complexos em múltiplos módulos de Conte-Mostre-Conte.

Jornada do Herói – Melhor para histórias de clientes

Seu cliente é o herói. Seu produto é o guia. Três atos: o mundo comum (o problema), a jornada (descobrindo e usando o produto), o retorno (resultados transformados com métricas).

Outros frameworks

  • Narrativa JTBD: "Quando [situação], quero [trabalho], para que [resultado]"
  • Gancho-História-Oferta: Gancho de 5s, narrativa de 30s, CTA de 10s (ótimo para formato curto)
  • AIDA: Atenção, Interesse, Desejo, Ação
  • Círculo Dourado: Porquê, Como, O quê (Sinek)
  • Espinha da História da Pixar: "Era uma vez... Todos os dias... Um dia... Por causa disso..."

Ganchos de Abertura

Você tem 5 segundos. Escolha um:

Tipo de GanchoExemploMelhor Para
Declaração do problema"Se você já passou 3 horas debugando configs de deploy..."Tutoriais, públicos conscientes da dor
Revelação do resultadoMostre o resultado final primeiro, depois explique comoTours de produto, destaques de funcionalidades
Interrupção de padrãoZoom rápido, mudança visual súbita, congelamento de quadro + textoRedes sociais, feeds lotados
Provocação de abertura diretaComece no clímax: "...e foi quando o build quebrou"Vídeos narrativos
Pergunta"E se seus deploys nunca falhassem?"B2B, segmentos específicos
Estatística chocante"90% dos tickets de suporte já estão respondidos na sua documentação"Públicos educacionais, orientados por dados
Valor direto"Aqui estão 5 truques de CSS que você não está usando"Fundo de funil, orientado à ação

Interrupções de padrão nos primeiros 5 segundos mostram 23% mais retenção.

Aberturas diretas superam introduções de marca. Corte as animações de logotipo. Fisgue primeiro, a marca depois.


Narração

Ritmo

Tipo de VídeoPPMNotas
Explicativo130-150Ponto ideal para compreensão
Tutorial120-130Mais lento para informações complexas
Promocional/Lançamento150-160Mais rápido para energia

Referência de contagem de palavras: 30s = ~75 palavras, 60s = ~150 palavras, 90s = ~225 palavras, 2min = ~300 palavras.

Ponto de Vista

Use segunda pessoa ("você") para narração – ela atrai os espectadores e os torna protagonistas. Mude para primeira pessoa para CTAs ("Iniciar meu teste grátis" converte 90% melhor do que "Iniciar seu teste grátis").

Tom

  • Conversacional: Frases curtas, contrações, direto. Melhor para explicativos, startups.
  • Profissional: Medido, autoritário. Melhor para enterprise, segurança, finanças.
  • Entusiasmado: Enérgico, voltado para o futuro. Melhor para lançamentos.
  • Empático: Caloroso, compreensivo. Melhor para introduções focadas no problema.

Escreva como você fala. Leia o roteiro em voz alta. Se você tropeçar, reescreva.

Voz de IA vs. Humana

A voz de IA é 60-86% mais barata e instantaneamente atualizável. Mas: a narração por IA mostra 70% menos retenção e 35% maior abandono em 45 segundos. Use voz humana para conteúdo de alto risco. A IA é aceitável para conteúdo interno/de tutorial de alto volume.

API ElevenLabs with-Timestamps

Use o endpoint /v1/text-to-speech/{voice_id}/with-timestamps para dados de sincronização em nível de palavra. Ele retorna áudio idêntico mais alinhamento em nível de caractere, que você agrega para temporização em nível de palavra e sentença. Isso permite a composição automatizada da temporização – as durações das seções são derivadas do áudio medido, não adivinhadas a partir da contagem de palavras.

Áudio por Seção

Sempre gere um arquivo de áudio por seção do roteiro, em vez de uma única narração concatenada. Arquivos concatenados inserem pausas variáveis entre as seções (2-4 segundos cada) que se acumulam em 20-35 segundos de desvio ao longo de 10 seções. O áudio por seção, cada um fixado em seu quadro de composição, elimina o desvio cumulativo completamente. Mantenha um arquivo concatenado apenas para pré-visualização/audição.

Clones de Voz

Se uma voz clonada estiver disponível (por exemplo, via clonagem de voz do ElevenLabs), use-a para narração autêntica do fundador/desenvolvedor com velocidade e custo de IA. A qualidade do clone é alta o suficiente para uso em produção. A flag --voice <voice_id> no script de narração seleciona o clone.

Controle de Velocidade e Ritmo

Configurações de voz do ElevenLabs que afetam o ritmo:

  • stability: 0.5 – variação natural sem divagar
  • similarity_boost: 0.75 – consistência de voz entre as seções
  • style: 0.3 – expressividade sutil sem exageros
  • use_speaker_boost: true – melhoria de clareza

Para um ritmo mais rápido, aumente a estabilidade para perto de 0.7 e reduza o estilo para perto de 0.1. Para uma entrega mais calorosa e conversacional, diminua a estabilidade para perto de 0.3 e aumente o estilo para perto de 0.5.

Elenco de Voz

Personalidade da MarcaEstilo de Voz
Inovadora/techClara, confiante, ritmo médio
Calorosa/acessívelAmigável, sorriso na voz
EnterpriseGrave, medida, barítono
Brincalhona/criativaEnérgica, expressiva, inflexão variada
Audaciosa/disruptivaRitmo acelerado, confiante, provocativa

Referência Rápida de Produção

Detalhes completos em references/production-techniques.md.

Gravação de Tela

  • Grave em 4K/60fps, entregue em 1080p ou 4K
  • Mova o cursor a 50% da velocidade natural, pause 0,5-1s antes de clicar
  • Feche todas as notificações, use um perfil de navegador limpo, pré-carregue todas as telas
  • Screen Studio ($89) é o padrão ouro atual para demonstrações polidas
  • Pós-processamento: zoom de 150-300% para destaques, suavize todos os zooms (cúbico/quíntico), adicione sombras sutis

Transições

  • Cortes secos para 90%+ das transições
  • Transições de zoom para navegação entre funcionalidades (0,3-0,8s)
  • Dissoluções apenas para passagem de tempo (0,5-2s)
  • Máscara de UI para um polimento de marca (a barra lateral se expande para cobrir o quadro, revela uma nova cena)
  • Nunca use transições como decoração. Cada transição deve servir à narrativa.

Música

Tipo de VídeoClimaRitmo
Lançamento/chamativoAnimado, em construção120-140 BPM
Passo a passoLeve, discreto90-110 BPM
EnterpriseProfissional, caloroso80-100 BPM
Aplicativo de consumoDivertido, moderno110-130 BPM

Sincronize seus cortes com a batida. Transições principais nos tempos fortes, transições secundárias nos contratempos. Isso cria a "sensação Apple" – cada corte caindo em uma batida musical.

Plataformas de música: Epidemic Sound ($10-20/mês, melhor para volume), Artlist ($10/mês, ativos abrangentes), Musicbed (premium, cinematográfica).

Sincronização de Narração (Pipeline Remotion)

Para produções baseadas em Remotion, use o pipeline de sincronização automatizada:

script.md --> narrate-sync.ts --> sync-manifest.json --> constantes de composição S --> audit-sync.ts --> render

Princípios-chave:

  • Áudio por seção: Um MP3 por seção do roteiro, cada um fixado em seu quadro de composição exato. Nunca use um único arquivo concatenado como fonte de áudio da composição.
  • Fórmula de temporização da seção: ceil(duracao_narracao_segundos * fps) + 15 quadros de preenchimento. Sempre derive do áudio medido, nunca de estimativas de contagem de palavras.
  • Manifesto de sincronização: Arquivo JSON com dados de temporização em nível de palavra e sentença (início/fim em segundos e quadros). Gerado automaticamente pelo script narrate-sync.
  • Audite antes de renderizar: Execute audit-sync para detectar quadros mortos, excessos de narração e lacunas visuais. Corrija quaisquer problemas antes de renderizar.

Detalhes completos em references/remotion-production-pipeline.md.

Efeitos Sonoros

Adicione cliques, whooshes e estalos sutis a interações-chave da UI. Mantenha os EFeitos Sonoros -20 a -30 dB abaixo da narração. Nem todo clique precisa de um som – reserve para momentos significativos.

Gravação de Locução

  • Mínimo: Blue Yeti / AT2020 USB+ ($50-130)
  • Profissional: Shure SM7B / RE20 ($300-450)
  • Grave em uma sala silenciosa e tratada. Sorria enquanto grava.
  • Cadeia de pós-processamento: redução de ruído > EQ > compressão > de-essing > limitador > normalizar para -16 LUFS

Miniatura e Distribuição

Detalhes completos em references/thumbnails-and-distribution.md.

Lista de Verificação de Miniatura

  • 1280x720px, abaixo de 2MB, 16:9
  • Um ponto focal claro
  • Máximo de 3-5 palavras, alto contraste, legível em tamanhos pequenos
  • NÃO repete o título do vídeo
  • Cria curiosidade ou resposta emocional
  • Consistente com a marca visual do canal
  • 2-3 variantes prontas para teste A/B

Miniaturas amarelo+preto produzem o maior CTR com 8,2%. Miniaturas de alto contraste melhoram o CTR em 20-40%.

Fórmulas de Título

Ideal: 55-70 caracteres, 10-11 palavras. Números aumentam o CTR em até 36%.

PadrãoExemplo
Transformação"Como [Ferramenta] Reduziu Nosso Tempo de Deploy em 80%"
Comparação inesperada"[Ferramenta A] vs [Ferramenta B] – O Vencedor Me Surpreendeu"
Advertência"Pare de Usar [Prática] – Faça Isso em Vez Disso"
Velocidade/resultado"Construa um [Coisa] em [Tempo] com [Ferramenta]"
Descoberta"Encontrei a Melhor Ferramenta de [Categoria] (Não é a [Esperada])"

YouTube vs. Site

  • YouTube para descoberta e construção de audiência (otimize miniaturas/títulos)
  • **Auto-hospedado (Wistia/…) para conversão (incorpore em páginas de produto, landing pages, hubs de ajuda)

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas