Communitygithub.com

AlemTuzlak/skills

Use quando o usuário deseja escrever um roteiro de vídeo para demonstração de produto, tutorial de funcionalidade, vídeo de lançamento ou vídeo de mídia social sobre uma funcionalidade ou alteração no produto.

O que é skills?

Esta habilidade permite que um agente AI (como Claude Code, Cursor ou Codex) escreva roteiros de vídeo profissionais para demonstrações de produtos, tutoriais de funcionalidades e vídeos de lançamento. Ela gerencia todos os aspectos da produção de roteiro: ritmo, direções visuais, temporização e comprimentos adequados para cada plataforma. O processo é dividido em seis fases: descoberta, configuração, esboço, escrita, revisão e saída, garantindo que o roteiro final atenda às necessidades específicas do usuário. A habilidade aceita diversas entradas, como briefings de marketing, posts de blog, changelogs, PRs do GitHub, intervalos de commits ou descrições livres. Ela gera três tipos de roteiro (narração, duas colunas ou com apresentador) e se adapta a formatos curtos (30-90 segundos para redes sociais) ou médios (3-5 minutos para YouTube e demos), com ritmo alvo de 130-145 palavras por minuto. O agente também fornece dicas de gancho, direções visuais detalhadas e sugestões de chamada para ação, baseadas no contexto do produto.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/video-script

Perguntar na sua IA favorita

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

Documentação

Escritor de Roteiro de Vídeo

Escreva roteiros de vídeo para demonstrações de produtos, tutoriais de funcionalidades e vídeos de lançamento. Lida com ritmo, direções visuais, temporização e comprimentos adequados para cada plataforma.

Resolução de Entrada

Resolva o argumento (se fornecido) nesta ordem:

  1. Caminho para um briefing de marketing existente (.md contendo "Sumário Executivo" ou "Mensagens-chave") -> briefing de marketing
  2. Caminho para um post de blog existente (.md com estrutura de post de blog) -> post de blog
  3. Caminho para um changelog existente -> changelog
  4. Caminho para uma newsletter existente -> newsletter
  5. Corresponde a URL do GitHub ou padrão #\d+ -> PR
  6. Contém ... ou .. -> intervalo de refs git
  7. Resolve para arquivo/diretório existente -> funcionalidade do código
  8. Caso contrário -> texto livre

Se nenhum argumento for fornecido, pergunte: "Sobre o que deve ser o vídeo? Você pode fornecer um briefing de marketing, post de blog, changelog, URL/número de PR, intervalo de refs git, caminho de arquivo/diretório, ou apenas descrever a funcionalidade."

Se múltiplas interpretações coincidirem, confirme com o usuário.

Fluxo do Processo

digraph video_script {
    rankdir=TB;
    "Resolver entrada" [shape=box];
    "Fase 1: Descoberta" [shape=box];
    "Fase 2: Configuração" [shape=box];
    "Fase 3: Esboço" [shape=box];
    "Esboço aprovado?" [shape=diamond];
    "Fase 4: Escrever" [shape=box];
    "Fase 5: Revisão" [shape=box];
    "Aprovado?" [shape=diamond];
    "Fase 6: Saída" [shape=box];

    "Resolver entrada" -> "Fase 1: Descoberta";
    "Fase 1: Descoberta" -> "Fase 2: Configuração";
    "Fase 2: Configuração" -> "Fase 3: Esboço";
    "Fase 3: Esboço" -> "Esboço aprovado?";
    "Esboço aprovado?" -> "Fase 3: Esboço" [label="não, revise"];
    "Esboço aprovado?" -> "Fase 4: Escrever" [label="sim"];
    "Fase 4: Escrever" -> "Fase 5: Revisão";
    "Fase 5: Revisão" -> "Aprovado?";
    "Aprovado?" -> "Fase 4: Escrever" [label="revisões"];
    "Aprovado?" -> "Fase 6: Saída" [label="sim"];
}

NÃO pule fases. Faça perguntas em um ritmo natural. Se o usuário responder várias de uma vez, aceite respostas agrupadas e pule adiante.

Se o usuário disser "apenas use os padrões" ou similar, escolha padrões razoáveis, declare o que escolheu e peça uma única confirmação.

Fase 1: Descoberta

Passo 1 - Analise a entrada

Tipo de entradaO que ler
Briefing de marketingExtrair declaração do problema, proposta de valor, público, mensagens-chave. Pule para o Passo 3. Ainda faça o Passo 2 se o briefing não tiver contexto do produto.
Post de blogExtrair título, pontos principais, público, CTA. Pule para o Passo 3.
ChangelogExtrair entradas principais, foque nas mudanças mais impactantes. Pule para o Passo 3.
NewsletterExtrair assunto, principais atualizações, CTA. Pule para o Passo 3.
PRDiff, descrição do PR, comentários de revisão, mensagens de commit. Para PRs grandes (20+ arquivos), foque em mudanças voltadas ao usuário.
Refs gitgit diff e git log entre as refs. Priorize mudanças voltadas ao usuário.
Funcionalidade do códigoLeia os arquivos/diretórios especificados.
Texto livreAnalise a descrição do usuário. Se faltar detalhes, peça ao usuário para fornecer mais detalhes ou apontar para um arquivo/PR específico.

Mudanças voltadas ao usuário incluem: novas funcionalidades, mudanças de UI, mudanças de API, melhorias de desempenho, correções de bugs e atualizações de documentação. Mudanças internas incluem: refatorações, adições de testes, mudanças de CI e atualizações de dependências.

Tratamento de erros:

  • gh não disponível -> informe o usuário, ofereça entrada alternativa
  • PR/ref inválido -> peça ao usuário para verificar
  • Arquivo não encontrado -> peça o caminho correto

Passo 2 - Leia contexto mais amplo do produto

Leia se existirem: README, docs/, package.json (ou equivalente).

Se nada for encontrado, pergunte: "Você pode descrever brevemente o produto e para quem ele é?"

Passo 3 - Apresente o entendimento

"Aqui está no que basearei o roteiro do vídeo:"

  • Funcionalidade A - descrição curta
  • Funcionalidade B - descrição curta

"Algo para adicionar, remover ou corrigir?"

NÃO prossiga até que o usuário confirme o escopo.

Passo 4 - Verificação de conteúdo sensível

Antes de prosseguir, verifique por conteúdo potencialmente sensível: patches de segurança, preços internos, credenciais, itens de roadmap não lançados ou conteúdo marcado como confidencial. Sinalize qualquer coisa questionável ao usuário.

Fase 2: Configuração

Faça estas perguntas:

P1 - Duração do vídeo:

  • Curta (30-90 segundos) - mídias sociais (Reels, Shorts, TikTok)
  • Média (3-5 minutos) - YouTube, demonstrações de produto, tutoriais

P2 - Tipo de roteiro:

  • Narração - texto de narração lido sobre gravações de tela/imagens
  • Duas colunas - coluna esquerda: direções visuais/ações na tela, coluna direita: narração
  • Apresentador - palestrante na câmera, entrega conversacional

P3 - Tom: Leia o conteúdo existente do repositório para detectar a voz. Confirme:

"Com base no seu conteúdo existente, o tom parece [ex.: conversacional e amigável para desenvolvedores]. Devo manter esse ou seguir uma direção diferente?"

Se não houver conteúdo para analisar, pergunte diretamente.

P4 - CTA: Infira do contexto:

  • Open source -> "Dê uma estrela no repositório", "Experimente"
  • SaaS -> "Inscreva-se grátis", "Inicie seu teste"
  • Atualização de funcionalidade -> "Experimente agora", "Veja a documentação"

"Sugiro que o CTA seja: [CTA inferido]. Quer usar esse ou algo diferente?"

Fase 3: Esboço

Gere um esboço estruturado com temporização. Use o template apropriado com base na duração do vídeo:

Curta (30-90 segundos) - 3-4 seções:

## [Título de trabalho] - [duração total]

1. **Gancho** (0:00-0:05) - [abordagem]
   - Ponto principal
   - Visual: [o que mostrar]

2. **Problema** (0:05-0:15) - [ponto de dor a estabelecer]
   - Visual: [o que mostrar]

3. **Solução** (0:15-0:45) - [tutorial da funcionalidade]
   - Ponto principal A
   - Visual: [o que mostrar]
   - Ponto principal B
   - Visual: [o que mostrar]

4. **CTA** (0:45-0:60) - [ação a tomar]
   - Visual: [tela final]

Total estimado: ~X palavras (~Y segundos a 135 PPM)

Média (3-5 minutos) - 5-8 seções:

## [Título de trabalho] - [duração total]

1. **Gancho** (0:00-0:10) - [abordagem]
   - Visual: [o que mostrar]

2. **Problema** (0:10-0:30) - [ponto de dor, contexto, por que isso importa]
   - Visual: [o que mostrar]

3. **Visão geral da solução** (0:30-1:00) - [visão geral do que foi construído]
   - Visual: [o que mostrar]

4. **Aprofundamento: [Funcionalidade A]** (1:00-2:00) - [tutorial]
   - Pontos principais
   - Visual: [passos da gravação de tela]

5. **Aprofundamento: [Funcionalidade B]** (2:00-3:00) - [tutorial]
   - Pontos principais
   - Visual: [passos da gravação de tela]

6. **Aprofundamento: [Funcionalidade C]** (3:00-3:45) - [tutorial]
   - Pontos principais
   - Visual: [passos da gravação de tela]

7. **Recapitulação** (3:45-4:30) - [resumir benefícios principais]
   - Visual: [slide de resumo ou lado a lado]

8. **CTA** (4:30-5:00) - [ação a tomar]
   - Visual: [tela final]

Total estimado: ~X palavras (~Y segundos a 135 PPM)

Escalone o número de segmentos de aprofundamento para corresponder às funcionalidades sendo cobertas.

Apresente o esboço e aguarde aprovação antes de escrever.

Fase 4: Escrever

Referência de ritmo

Duração do vídeoPalavras alvoPPM
30 segundos~65 palavras130
60 segundos~135 palavras135
90 segundos~200 palavras135
3 minutos~400 palavras135
5 minutos~675 palavras135

Alvo de 130-145 PPM para entrega conversacional. Sinalize qualquer seção que exceda seu tempo alocado.

Formato do roteiro por tipo

Roteiro de narração:

## [Título]

### Gancho (0:00-0:05) - ~15 palavras
VISUAL: [Descrição do que está na tela]

[Texto da narração aqui.]

### Nome da seção (0:05-0:20) - ~30 palavras
VISUAL: [Descrição do que está na tela]

[Texto da narração aqui.]

Roteiro de duas colunas:

| Tempo | Visual | Narração |
|---|---|---|
| 0:00-0:05 | [Tela: página inicial carrega] | [Texto da narração] |
| 0:05-0:15 | [Tela: clique no menu de configurações] | [Texto da narração] |
| 0:15-0:30 | [Tela: ativar modo escuro] | [Texto da narração] |

Roteiro com apresentador:

## [Título]

### Gancho (0:00-0:05) - ~15 palavras
CÂMERA: [Apresentador na câmera, plano médio]

[Texto do apresentador aqui. Conversacional, direto para a câmera.]

### Nome da seção (0:05-0:20) - ~30 palavras
CÂMERA: [Corte para gravação de tela]
NARRAÇÃO: [Narração sobre gravação de tela]

CÂMERA: [Volta para o apresentador]
[Texto do apresentador aqui.]

Gancho

Os primeiros 3-5 segundos determinam se os espectadores continuarão assistindo. O gancho deve:

  • Abordar um ponto de dor ou fazer uma pergunta provocativa
  • NÃO começar com o nome da sua empresa/produto
  • NÃO começar com "Neste vídeo, vou mostrar a você..."
  • Criar curiosidade imediata ou ressonância emocional

Direções visuais

Sempre inclua direções visuais inline, independentemente do tipo de roteiro:

  • VISUAL: / TELA: para gravações de tela e imagens
  • CÂMERA: para direções de câmera do apresentador
  • Seja específico: "TELA: Clique no botão de exportar, mostre PDF baixando" não "TELA: Mostre a funcionalidade"
  • Inclua notas de transição entre as cenas

Temporização por seção

Inclua duração estimada e contagem de palavras para cada seção:

  • ### Nome da seção (0:15-0:30) - ~30 palavras
  • Sinalize se alguma seção exceder seu orçamento de tempo
  • A contagem total de palavras do roteiro deve corresponder à duração alvo a 135 PPM

Regras de escrita

  • Conversacional, não com som de roteiro. Escreva como as pessoas realmente falam.
  • Frases curtas. Máximo de 10-15 palavras por frase.
  • Uma ideia por frase.
  • Voz ativa sempre.
  • Nunca use travessões no conteúdo gerado. Sem caracteres "---". Use vírgulas, dois pontos, pontos finais ou parênteses.
  • Mostre, não conte. "Veja como isso carrega rápido" > "Carrega muito rapidamente"
  • Para vídeos de formato médio, use a regra de três: três benefícios, três funcionalidades, três exemplos. Para formato curto, foque em um único benefício principal.

CTA

  • Últimos 5-10 segundos do vídeo
  • Ação única e clara
  • Inclua direção visual para a tela final (botão de inscrição, sobreposição de link, código QR)

Fase 5: Revisão

Apresente o roteiro completo com a divisão de temporização:

"Aqui está o roteiro:"

[Roteiro completo]

Divisão de temporização:

  • Gancho: 5s (~15 palavras)
  • Problema: 10s (~25 palavras)
  • Solução: 30s (~70 palavras)
  • CTA: 10s (~20 palavras)
  • Total: 55s (~130 palavras a 135 PPM)

"Quer alguma alteração?"

Aguarde aprovação. Só prossiga para a saída quando o usuário confirmar.

Fase 6: Saída

Sempre imprima o roteiro final aprovado no terminal.

Depois pergunte: "Quer que eu salve isso em scripts/<slug>.md? Ou um caminho diferente?"

Crie o diretório se não existir. Se o arquivo já existir, pergunte se deve sobrescrever ou criar uma cópia versionada.

Tratamento de Erros

  • gh não disponível -> informe o usuário, ofereça entrada alternativa
  • PR/ref inválido -> peça ao usuário para verificar
  • Sem contexto do produto -> peça ao usuário para descrever o produto
  • Roteiro excede duração alvo -> sinalize e sugira cortes antes da revisão

O que esta habilidade NÃO faz

  • Gravar ou editar vídeo
  • Gerar miniaturas ou assets visuais
  • Criar animações ou motion graphics
  • Escrever posts de blog ou cópia para redes sociais (use /blog-post ou /social-copy)

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Habilidades Relacionadas