Communitygithub.com

Rune-kit/rune

Planejamento de conteúdo de vídeo. Escreve roteiros de narração, storyboards, listas de planos e checklists de ativos. Salva o plano em marketing/video-plan.md.

O que é rune?

Esta skill é uma ferramenta de planejamento de produção de vídeo para demonstrações de produtos e marketing, que cria planos detalhados em vez de arquivos de vídeo reais. Ela aceita um briefing do usuário ou de outras skills (como marketing e lançamento), com parâmetros como tópico, público, duração, plataforma de publicação e caminho de saída. A skill gera um roteiro com marcas de tempo, um storyboard cena por cena, uma lista de planos de gravação categorizada por tipo (captura de tela, terminal, código, diagrama) e uma lista de ativos necessários, salvando tudo em um arquivo Markdown (por exemplo, `marketing/video-plan.md`). Ela se destaca por impor princípios de redação de roteiro focados em engajamento auditivo, incluindo abertura pela dor do espectador, uso de conectores entre cenas e tratamento seguro para TTS (Text-to-Speech), convertendo números e nomes técnicos em formas fonéticas para evitar erros de leitura. A skill é compatível com plataformas como YouTube, Twitter/X, TikTok e Loom, derivando restrições específicas de cada uma. Conhecida como 'pure L3 utility', ela não faz chamadas externas e tem um perfil de custo baixo (500-1500 tokens de entrada, 500-1000 tokens de saída), sendo recomendada para uso com Sonnet para garantir qualidade de roteiro.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Rune-kit/rune/tree/HEAD/skills/video-creator

Perguntar na sua IA favorita

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

Documentação

Criador de Vídeo

Propósito

Planejamento de conteúdo de vídeo para demonstrações de produtos e marketing. Escreve roteiros de narração com marcas de tempo, cria storyboards cena por cena, define listas de planos e lista os ativos necessários. Salva o plano de produção completo em um arquivo. Esta skill cria PLANOS para produção de vídeo — não arquivos de vídeo reais.

Chamado Por (inbound)

  • marketing (L2): scripts de vídeo de demonstração/explicativo
  • launch (L1): vídeos de demonstração de produto

Chamadas (outbound)

Nenhuma — utilitário L3 puro.

Instruções Executáveis

Passo 1: Receber Briefing

Aceitar entrada da skill chamadora:

  • topic — sobre o que é o vídeo (ex.: "Demonstração do plugin Rune", "Passo a passo da Feature X")
  • audience — quem vai assistir (ex.: "desenvolvedores", "fundadores não técnicos", "usuários existentes")
  • duration — duração alvo em segundos (ex.: 60, 120, 300)
  • platform — onde será publicado: youtube | twitter | tiktok | loom | internal
  • output_path — onde salvar o plano (padrão: marketing/video-plan.md)

Derivar restrições da plataforma:

  • YouTube: sem limite estrito de duração, capítulos recomendados para > 3min
  • Twitter/X: máximo 140 segundos, gancho nos primeiros 3 segundos
  • TikTok: máximo 60 segundos, cortes rápidos, legendas obrigatórias
  • Loom: amigável para comunicação assíncrona, foco em gravação de tela, sem necessidade de música

Passo 2: Roteiro

Escreva um roteiro de narração com marcas de tempo. Antes de escrever uma única linha, aplique os princípios de Arte da Narração abaixo — um roteiro que o espectador OUVE vive ou morre pela abertura e pelo fluxo, não pela lista de planos.

Estrutura:

  • Gancho (0–5s): linha de abertura que prende a atenção — declare o problema ou o benefício
  • Configuração (5–15s): contexto — para quem é e o que aprenderão
  • Demonstração/Corpo (15s–[duração-15s]): conteúdo principal dividido em cenas
  • CTA (últimos 10s): chamada para ação — o que fazer a seguir (dar estrela no repositório, inscrever-se, compartilhar)

Formate cada seção:

[00:00] GANCHO
Narração: "..."
Na tela: [o que o espectador vê]

[00:05] CONFIGURAÇÃO
Narração: "..."
Na tela: [o que o espectador vê]

Passo 3: Storyboard

Crie um detalhamento cena por cena:

Para cada cena:

  • Número e nome da cena
  • Duração em segundos
  • Descrição visual (o que aparece na tela)
  • Texto da narração (do Passo 2)
  • Tipo de transição: corte | fade | zoom | deslizar

Exemplo:

Cena 3: Demonstração ao vivo — comando de instalação
Duração: 12s
Visual: Janela do terminal, comando digitado "npm install -g @rune/cli", saída rolando
Narração: "Instale em segundos com um único comando."
Transição: corte

Passo 4: Lista de Planos

Defina exatamente o que precisa ser gravado ou mostrado:

Categorize por tipo:

  • Gravação de tela: liste cada estado de tela a capturar (URL, estado do app, o que fazer)
  • Trecho de código: liste cada bloco de código a exibir (caminho do arquivo + intervalo de linhas, ou inline)
  • Diagrama/slide: liste cada visual estático necessário (título, pontos principais)
  • Terminal: liste cada sequência de comando a gravar

Formato:

Plano 1 — Gravação de tela
  URL: https://myapp.com/dashboard
  Ação: Clicar em "Novo Projeto" → preencher formulário → clicar em Criar
  Duração: ~8s

Plano 2 — Terminal
  Comando: npm install -g @rune/cli && rune init my-project
  Saída esperada: [descrever o que deve aparecer]
  Duração: ~10s

Passo 5: Ativos Necessários

Liste todos os ativos necessários antes que a gravação possa começar:

  • Capturas de tela (quais páginas/estados)
  • Trechos de código (quais arquivos, quais seções)
  • Diagramas (tópico, estilo: fluxograma | arquitetura | tabela comparativa)
  • Fundos de slides ou cartões de título
  • Thumbnail (dimensões baseadas na plataforma: YouTube 1280x720, Twitter 1200x628)

Passo 6: Relatório

Use Write para salvar o plano de vídeo completo em marketing/video-plan.md (ou no output_path especificado):

# Plano de Vídeo: [tópico]

- **Plataforma**: [plataforma]
- **Duração Alvo**: [duração]s
- **Público**: [público]
- **Criado**: [data]

## Roteiro
[roteiro completo com timestamps do Passo 2]

## Storyboard
[detalhamento cena por cena do Passo 3]

## Lista de Planos
[todos os planos do Passo 4]

## Ativos Necessários
[checklist do Passo 5]

## Notas da Plataforma
[restrições e dicas para a plataforma alvo]

Em seguida, produza um resumo para a skill chamadora:

## Plano de Vídeo Criado

- Arquivo: [output_path]
- Cenas: [quantidade]
- Planos: [quantidade]
- Tempo estimado de gravação: [n] minutos
- Ativos a preparar: [quantidade] itens

### Próximos Passos
1. Preparar os ativos listados no plano
2. Gravar os planos na ordem da lista de planos
3. Editar usando o storyboard como referência

Arte da Narração (decide se um roteiro prende ou entedia)

Um roteiro de demonstração é OUVIDO por uma pessoa, não lido de um slide. Esses princípios separam um roteiro envolvente de uma narração genérica — aplique-os no Passo 2, antes de escrever qualquer linha.

Os 9 princípios:

  1. Abertura pela dor. Comece pela maior dor do espectador ou por uma estatística já em andamento ("Se você sempre precisa…", "Este repositório tem 9k estrelas e…"). NUNCA uma abertura plana de catálogo ("Hoje vamos ver…", "Esta é uma ferramenta que…") — ela não nomeia nenhum problema e não dá razão alguma para não rolar para baixo.
  2. Estruturas de contraste. "não só X mas Y", "não X, é Y", "como X mas com Y". Contraste prende a atenção.
  3. Discurso em 2ª pessoa. "você verá imediatamente", "se você desenvolve em um Mac M-Series…". Traga o espectador para dentro.
  4. Imediatismo demonstrativo. "aqui mesmo", "isso", "na linha do tempo agora". Concreto e presente.
  5. Nomes reais específicos, mantenha o jargão. Nomeie arquivos reais, comandos, concorrentes ("Final Cut", "Cursor", "ffmpeg"). Termos genéricos ("uma ferramenta de IA", "o framework") são proibidos. Não traduza à força jargão em palavras estranhas.
  6. Prova social quantificada — UMA VEZ. "mais de 9k estrelas". Nunca despeje estrelas + forks + issues consecutivamente como fragmentos separados.
  7. Cláusulas curtas, fluxo com vírgulas. "Você pode cortar, substituir ou regenerar." Um fôlego, não fragmentos em tópicos.
  8. Ressalva como recurso. Diga um limite honesto ou "quem NÃO deve usar isso". Esta é a linha que mais constrói confiança no vídeo — um recurso de retenção, não de preenchimento.
  9. Aterrissagem em caso de uso. Termine em um cenário ESPECÍFICO de espectador, não em "vá conferir".

"Armas" nomeadas e numeradas. Dê a cada diferencial um título e um número ("Arma 01/02"). Explore 2-3 especificidades NÃO ÓBVIAS (uma regex, uma guarda, um algoritmo, um fallback) — um mecanismo preciso e surpreendente vale mais que uma lista genérica de capacidades.

Conectores entre cenas. Cada cena após a primeira abre com um conector linguístico que remete à anterior ("O núcleo disso é…", "Especificamente…", "Mas note…") para que o vídeo inteiro soe como UM monólogo, não N legendas telegráficas lidas em sequência. Leia o roteiro completo em voz alta em sequência — se parecer com frases de efeito desconexas, reescreva.

Padrões de falha automática — rejeite o roteiro se aparecer algum:

  • ❌ Gancho/Problema/Solução/CTA tratados como fragmentos isolados
  • ❌ Estatísticas laterais (estrelas/forks/issues) como cenas separadas de uma linha
  • ❌ Cada frase recomeça como um tópico independente ("X executa um pipeline. Y escreve. Z narra.")
  • ❌ Alegações genéricas de capacidade ("completo", "muito poderoso", "popular na comunidade")
  • ❌ Descrição do README/repositório em vez do produto
  • ❐ Fechamento com "vá conferir" / "obrigado por assistir"

Narração: Segurança para TTS (quando a narração é gerada por máquina)

Quando a narração for sintetizada por um motor TTS (voz de IA, não leitura humana), a narration falada e o texto na tela são canais SEPARADOS — um é ouvido, o outro é lido. Otimize cada um de forma independente; nunca alimente um slug bruto, número ou símbolo no TTS e espere que a voz adivinhe corretamente. (Os exemplos em vietnamita abaixo ilustram o padrão; aplique a mesma substituição fonética + números por extenso para o idioma que o motor TTS alvo falar.)

Números → palavras faladas (muitos motores TTS neurais podem ler dígitos puros incorretamente):

FormaTTS lê erradoEscreva como
Decimal de versãoGPT 5.5 → "cinco vírgula cinco"GPT cinco ponto cinco
Decimal de estatística82,7%oitenta e dois vírgula sete por cento
Especificação200MPduzentos megapixels
Preço$5 / 21 milhõescinco dólares / vinte e um milhões de reais
Multiplicador / percentual2x / 30%o dobro / trinta por cento

Nomes de marcas/ingleses → fonéticos na narração, grafia exata na tela:

Termonarração (ouvida)exibição (lida)
READMEréqui meiREADME
ffmpegéfe éfe eme pê e gêffmpeg
GitHub / repoguitiúbi / répuGitHub / repo
API / GPTê pê i / gê pê têAPI / GPT

Remova da narração falada: emojis, URLs (diga "github ponto com barra…"), símbolos (→ & % $ # / @), comandos com barra (diga "o comando de instalação do plugin"), extensões de arquivo no meio da frase (diga "o arquivo YAML"), identificadores camelCase, reticências … e travessão — (TTS os lê errado — divida em duas frases curtas). Termine cada frase com . ou ? para uma pausa natural.

Mantenha o jargão, registro falado natural. Escreva como um amigo experiente DIRIA — mas mantenha o termo técnico padrão ("commit", "endpoint", "prompt" permanecem em sua forma usual; uma tradução forçada soa errada e perde o significado). Só traduza quando a palavra local for a que as pessoas realmente usam.

Notas de produção para um vídeo falado (se ele for realmente produzido, não apenas planejado):

  • Uma voz, um provedor em todas as cenas — uma mudança de voz/provedor no meio do vídeo é chocante.
  • Meça a duração do TTS PRIMEIRO, depois ajuste os visuais de cada cena ao comprimento real do áudio — estimar duração e depois renderizar causa desalinhamento A/V.
  • Legendas estilo karaokê são o #1 sinal profissional para formato curto (TikTok/Reels/Shorts): uma legenda central inferior que preenche palavra por palavra em sincronia com a voz, com destaque em palavras-chave. Compreensão em reprodução silenciosa e o mais forte indicador "profissional" — reserve uma faixa de legenda inferior para isso.

Nota

Esta skill cria PLANOS para produção de vídeo. A gravação e edição reais devem ser feitas por um humano ou uma ferramenta dedicada de gravação de tela.

Formato de Saída

Plano de Vídeo salvo em marketing/video-plan.md com roteiro, storyboard, lista de planos, checklist de ativos e notas da plataforma. Relatório resumido com contagens de cenas/planos e tempo estimado de gravação. Veja o Passo 6 Relatório acima para o modelo completo.

Restrições

  1. DEVE confirmar os parâmetros do vídeo (duração, resolução, formato) antes de gerar
  2. NÃO DEVE exceder tamanhos de arquivo razoáveis sem confirmação do usuário
  3. DEVE salvar no diretório de ativos do projeto

Arestas Afiadas

Modos de falha conhecidos para esta skill. Verifique-os antes de declarar concluído.

Modo de FalhaGravidadeMitigação
Restrições da plataforma não aplicadas (ex.: Twitter max 140s excedido)ALTAPasso 1: derivar restrições da plataforma imediatamente — elas restringem tudo a jusante
Seção CTA ausente no roteiroMÉDIACTA (últimos 10s) é obrigatório em todo roteiro — sem exceções, independentemente da duração
Não salvar no arquivo (apenas saída verbal)ALTARestrição 3 + Passo 6: Write no output_path é obrigatório — apenas verbal = sem persistência
Prometer um arquivo de vídeo entregável realMÉDIANota explicitamente: esta skill cria um PLANO — a gravação real é feita por um humano
Abertura plana de catálogo ("Hoje vamos ver…") em vez de um gancho pela dorALTAArte da Narração #1: comece pela maior dor do espectador — uma abertura que não nomeia nenhum problema perde o scroll em 2 segundos
Slugs/números/símbolos brutos deixados na narração para TTS ("README", "82.7%", "5.5")ALTASeção Narração: reescreva a narração falada foneticamente + números por extenso; mantenha a grafia exata apenas no canal de exibição
Roteiro parece N fragmentos de som desconexosMÉDIAConectores da Arte da Narração: cada cena após a primeira abre remetendo à anterior — leia o roteiro completo em voz alta antes de declarar concluído

Feito Quando

  • Restrições da plataforma identificadas e aplicadas a duração/formato
  • Arte da Narração aplicada — abertura pela dor, conectores entre cenas, ≥1 ressalva como recurso, nenhum padrão de falha automática
  • Se a narração for falada por TTS: números por extenso + nomes de marcas fonéticos no canal falado, grafia exata na exibição
  • Roteiro escrito com marcas de tempo (gancho, configuração, demonstração/corpo, CTA)
  • Storyboard criado cena por cena com transições
  • Lista de planos categorizada por tipo (gravação de tela, terminal, código, diagrama)
  • Checklist de ativos necessários gerada
  • video-plan.md escrito no output_path com a capacidade de edição de arquivo do runtime
  • Relatório de Plano de Vídeo Criado emitido com contagens de cenas, planos e ativos

Perfil de Custo

~500-1500 tokens de entrada, ~500-1000 tokens de saída. Sonnet para qualidade de roteiro.

Individual skills in this repo

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

Habilidades Relacionadas