Communitygithub.com

Roteiro de Narração

Escreva a narração em voz para um tutorial ou demonstração — as palavras reais, frasadas para o ouvido e sincronizadas uma instrução por ação com o que está na tela, com um orçamento de ritmo e um tom confiante e sem jargões. Use quando alguém disser

O que é Roteiro de Narração?

Este skill gera scripts de narração otimizados para tutoriais em vídeo, focando em sincronia entre fala e ação na tela. É útil para desenvolvedores, criadores de conteúdo e educadores que querem produzir demonstrações claras e envolventes. O skill prioriza frases curtas, voz ativa, ritmo controlado (140-160 palavras por minuto) e ausência de jargões, garantindo que cada instrução corresponda a uma ação visível. Ele fornece uma estrutura de três partes por etapa (objetivo, ação, confirmação) e um formato de saída em duas colunas (ação na tela vs. linha falada), facilitando o uso por editores e talentos de locução.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/SkillMedev/tutorial-video-studio/tree/main/skills/narration-script

Perguntar na sua IA favorita

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

Documentação

O que Roteiro de Narração faz?

Um tutorial vive ou morre pela sua narração. O espectador está tentando fazer a coisa enquanto ouve, então cada palavra compete com a atenção dele na tela. Escreva menos, diga de forma mais clara e prenda cada linha a uma ação visível.

Escreva para o ouvido, não para a página

A linguagem falada não é a linguagem escrita. Leia cada linha em voz alta antes de mantê-la.

  • Frases curtas. Uma ideia cada. Se você ficar sem fôlego, é longa demais.
  • Voz ativa, presente, segunda pessoa: "Clique em Salvar" — não "O botão Salvar seria então clicado pelo usuário."
  • Corte todos os "basicamente", "simplesmente" e "apenas". "Apenas clique em Configurações" diz silenciosamente a um espectador preso que ele é burro. Elimine isso.
  • Contrações são boas ("você vai", "é"); soam humanas.

Sincronize a narração com a ação

A regra cardinal: uma instrução por ação na tela, e as palavras chegam com a ação, nunca descrevendo o que já aconteceu.

  • Enuncie a ação um instante antes ou exatamente quando ela acontece na tela, para que a mão do espectador e o cursor se movam juntos.
  • Nunca narre um clique que já terminou — "e agora salvamos" depois da animação de salvar é ar morto.
  • Quando a tela fizer algo complexo, pare de falar e deixe respirar. Silêncio sobre um visual claro vence narração competindo com ele.

Ritmo

  • Aponte para ~140-160 palavras por minuto para instrução. Mais rápido perde quem está acompanhando.
  • Orçamente o roteiro contra as durações por cena do storyboard. Se um momento é 8 segundos, isso é ~20 palavras, não 50.
  • Construa pausas deliberadas nas transições e em qualquer momento em que o espectador precise olhar em vez de ouvir.

Estruture cada etapa

Uma forma confiável de três partes por etapa mantém os espectadores orientados:

  1. Objetivo — o que vamos fazer e por quê ("Para compartilhar isso, criaremos um link público.").
  2. Ação — a instrução concreta única ("Abra o menu Compartilhar e escolha Qualquer pessoa com o link.").
  3. Confirmação — como é o sucesso ("Você verá o link ficar verde quando estiver pronto.").

Sinalize entre as etapas com transições leves — "A seguir", "Agora que o link existe, vamos…" — para que a espinha do tutorial seja sempre audível.

Tom

Confiante e caloroso, como um colega competente sentado ao lado. Nunca condescendente, nunca exagerado. Defina um termo na primeira vez que aparecer, depois use-o consistentemente. Corresponda exatamente aos rótulos da interface na tela — se o botão disser "Novo projeto", diga "Novo projeto", não "criar um projeto".

Formato de saída

Entregue um roteiro de duas colunas que o editor e o talento de locução possam seguir:

Ação na telaLinha falada
Cursor abre o menu Compartilhar"Abra o menu Compartilhar no canto superior direito."
Link alterna para público"Mude para Qualquer pessoa com o link."

Marque [pausa] onde o visual deve carregar o momento, e negrito nas palavras a serem enfatizadas. Observe o tempo aproximado por linha se as durações do storyboard forem conhecidas.

Não faça

  • Não escreva música, efeitos sonoros ou dicas de mixagem aqui — ritmar o áudio, ducking e beat-matching é sincronia de som e música.
  • Não planeje a ordem da cena ou lista de shots — isso é storyboard de vídeo, que este roteiro deve seguir.
  • Não descreva preenchimento que o espectador já pode ver ("aqui está a tela, como você pode ver, há alguns botões").
  • Não deixe uma linha ultrapassar o orçamento de duração da sua cena; corte palavras, não pausas.

Individual skills in this repo

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

Captions From Transcript

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video

Kinetic Typography

Put text in motion the right way - title cards, animated captions, lower-thirds, callouts, and word-by-word reveals - with a reading-time-per-word budget so copy holds long enough to read, plus enter/exit timing, weight and size transitions, and type hierarchy in motion. Use when someone asks to

Motion Design Principles

The craft layer for motion: pick the right easing (ease-in / ease-out / ease-in-out / spring), get timing and spacing right, build the anticipation→action→follow-through arc, and apply Disney

Product Demo Director

Direct the craft of putting a real software UI on screen - cursor choreography, zoom/pan/callout language, screen-recording vs recreated-UI, and making state changes legible with highlights, focus pulls, and slow-downs. Use when filming or recreating an app for a product demo, feature walkthrough, onboarding clip, or release reel and asking

Remotion Compose

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says

Remotion Render

Renders a Remotion composition to MP4 and runs the edit-and-re-render loop - CLI render commands, 1080p/4K/9:16 presets, concurrency tuning, codec selection, batch variants from a JSON data file, and Lambda for cloud rendering. Use when someone says

Remotion Setup

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just

Screencast Capture

Capture clean raw screen and camera footage for a tutorial or product demo - choosing the recorder (macOS Screenshot toolbar, QuickTime, OBS, Windows Game Bar), setting resolution / frame-rate / cursor / microphone, prepping a distraction-free stage, and recording in retakeable segments. Use when someone says

SkillMedev/tutorial-video-studio

Plan a product demo, feature announcement, or launch video as a beat sheet and shot list BEFORE animating - hook in the first 3s, problem, reveal, proof, CTA - with target duration and pacing per scene type, output as a JSON scene plan that remotion-compose consumes directly. Use when someone says

Social Video Formatter

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says

Sound and Music Sync

Score a video like an editor: beat-match cuts to the music, land SFX on transitions, pace the voiceover so it breathes, source royalty-free tracks safely, and duck the music so the VO sits clearly on top. Use when adding music, sound effects, or voiceover to a video, when asked to

Habilidades Relacionadas