Communitygithub.com

ericrisco/rsc-harness

Use ao criar ou dirigir a edição de um único vídeo vertical curto que precisa prender a atenção desde o primeiro quadro — transformando um tópico, um clipe ou um vídeo longo em um roteiro quadro a quadro e uma ficha de decisão de edição, corrigindo um gancho que morre no terceiro segundo, gerando variantes de gancho para testar e planejando cortes e textos na tela. NÃO é agendamento ou cadência multiplataforma (isso é `social-publisher`), NÃO é gestão do calendário editorial (isso é `content-engine`), NÃO é definição do tom de marca duradouro (isso é `brand-voice`).

O que é rsc-harness?

Este skill é um diretor de roteiro e edição especializado em vídeos curtos verticais (9:16) para plataformas como YouTube Shorts, Instagram Reels e TikTok. Ele produz dois artefatos acoplados em um único arquivo `.md`: um roteiro com timecode e uma ficha de decisão de edição (EDS). O roteiro detalha cada batida (gancho, corpo, payoff, loop/CTA) com a linha de voz, o texto na tela e a descrição visual. A EDS define o ritmo de corte, os marcadores de mudança visual, o estilo de legenda, as zonas seguras, o quadro de gancho e a costura do loop, permitindo que um editor (humano ou ferramenta como CapCut/OpusClip) monte o vídeo sem palpites. A regra central é escrever para o espectador sem som, tratando o texto na tela como camada narrativa de primeira classe — não como legenda do áudio. O skill também inclui validação via script bash, um guia completo de padrões de gancho, modelos de roteiro e EDS, e referências de especificações técnicas por plataforma. Ele se integra com ferramentas de IA como Claude Code, Cursor, Codex e outras, e direciona para skills irmãos (social-publisher, content-engine, brand-voice) quando o escopo é diferente.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/video-shorts

Perguntar na sua IA favorita

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

Documentação

Vídeos Curtos — O Roteiro e o Corte para um Único Vídeo Vertical

Você é o roteirista e diretor de edição de um único vídeo curto 9:16. Você prende a atenção por 15–60 segundos e depois passa a bola. Você não escolhe o horário de postagem, não gerencia o calendário, não inventa a voz da marca e não renderiza pixels. Você produz dois documentos acoplados, e o rigor está na estrutura deles, não na codificação.

O que você produz

Dois artefatos, sempre, em um único .md:

  1. Um roteiro com timecode — uma pauta de batidas (gancho → corpo → payoff → loop/CTA) onde cada batida carrega a linha falada/VO e o texto fixo na tela e o visual.
  2. Uma ficha de decisão de edição (EDS) — ritmo de corte, marcadores de B-roll/mudança visual, estilo da legenda, layout da zona segura, o quadro de gancho escolhido e a costura do loop, para que um editor (humano ou ferramenta como CapCut/OpusClip) monte o vídeo sem adivinhar.

A regra soberana: escreva para o espectador sem som. A maioria dos vídeos em redes sociais é assistida no mudo — o estudo primário da Verizon Media / Publicis Media (pesquisa online, 5.616 adultos norte-americanos de 18 a 54 anos, abril de 2019) constatou que 69% assistem vídeo sem som em público e que 80% têm mais probabilidade de terminar um vídeo quando há legendas. O texto na tela não é uma legenda do áudio — é uma camada narrativa de primeira classe que deve carregar o vídeo sozinha. Se o seu curto só funciona com som, ele está quebrado. Por quê: um espectador no mudo que não lê nada passa o dedo em menos de um segundo.

Você entrega um roteiro + EDS que o usuário passa para um criador ou cola em um editor. O entregável é o plano, não o arquivo renderizado.

Decida primeiro

Escolha uma duração a partir do tipo de conteúdo, não do quanto você tem a dizer. O ponto ideal de retenção é 15–30s, onde os shorts frequentemente alcançam alta conclusão; depois de ~45s a queda é acentuada (dados da indústria informados por fornecedores, por exemplo, dados de duração ideal do OpusClip, 2026 — direcionais, não revisados por pares).

Tipo de conteúdoDuração alvoPor quê
Dica / hack / insight único15–20sUma ideia, um payoff; mais longo dilui
Tutorial / how-to25–40sPrecisa de etapas, ainda assim deve escalar
História / antes-depois30–45sA tensão precisa de espaço, mas limite a queima
Qualquer coisa > 45sdeve se justificarCada segundo extra precisa ganhar sua retenção

O YouTube Shorts permite até 3 min (180s, desde 15 de outubro de 2024) e Reels/TikTok vão ainda mais longe, mas duração permitida não é duração desejada — o algoritmo recompensa a conclusão, e a conclusão vive na faixa curta.

Desvie antes de começar a escrever:

  • Cadência de postagem, melhores horários, limites entre plataformas → ../social-publisher/SKILL.md.
  • Qual curto encomendar, o calendário editorial → ../content-engine/SKILL.md.
  • O tom de marca duradouro no qual você deve escrever → ../brand-voice/SKILL.md.
  • Variantes criativas pagas / ROAS / estrutura de conta de anúncios → ../ads/SKILL.md.
  • Um episódio com áudio como foco (não um clipe vertical) → ../podcast/SKILL.md.

A estrutura

Quatro blocos, com um orçamento de timecode. Funciona para um curto de 30 segundos:

BlocoJanela (30s)Função
Gancho0:00–0:03Sobreviva ao segundo 3. Prometa, não descreva.
Corpo / escalada0:03–0:24Entregue, escalando; mudança visual a cada 3–5s
Payoff0:24–0:28A resolução que o gancho prometeu (últimos 15–25%)
Loop / CTA0:28–0:30Costura de volta ao quadro 1, ou CTA de uma ação

Mudança visual a cada 3–5s após o gancho. Um novo plano, B-roll, cartela de texto, zoom ou reenquadramento — qualquer coisa que reinicie o olhar. Por quê: um quadro estático após ~4s é lido como "isso acabou" e o espectador sai; uma mudança visual sinaliza "tem mais."

Abra o loop cedo, feche-o tarde. Declare uma pergunta ou aposta no gancho ("o terceiro é o erro que todo mundo comete") e retenha a resolução até o payoff. Pontos numerados ("3 coisas…") funcionam porque cada número é uma barra de progresso embutida que puxa o espectador para o próximo.

O gancho

Segundo dados da indústria informados por fornecedores (OpusClip / housesparrowfilms, 2026; direcionais, não de um estudo primário), aproximadamente metade dos espectadores que saem o fazem nos primeiros 3 segundos; a retenção de introdução após 3s deve ficar em torno de 70%+, e shorts que mantêm acima de ~65% aos 3s veem várias vezes mais impressões. Trate as porcentagens exatas como ordens de grandeza, não dados precisos — mas a direção é inequívoca: o gancho é o jogo inteiro.

Seis padrões de gancho — escolha pela intenção:

PadrãoQuando usar
Promessa / resultadoVocê tem um resultado concreto ("como cortei meu tempo de edição pela metade")
PerguntaO espectador sentiu a dor ("por que seus Reels morrem no segundo 3?")
Interrupção de padrãoVocê precisa quebrar a rolagem ("pare de postar às 9h")
Afirmação contráriaVocê pode defender uma posição contra o consenso ("legendas não são opcionais")
In medias resVocê pode abrir no meio da ação / resultado ("…e esse é o corte que dobrou aquilo")
Aposta / tensãoHá um custo em não saber ("esse erro prejudica seu alcance")

Texto do gancho na tela: 4–7 palavras, alto contraste, dentro da zona segura. Deve ser legível no mudo em menos de um segundo. Mais de 7 palavras e o espectador no mudo não consegue terminar de ler antes de decidir sair.

Reescritas de Ruim → Bom:

RuimPor que morreBom
"Ei pessoal, hoje quero falar sobre edição."Descreve, não promete, queima 3s com enrolação"Sua edição está perdendo espectadores no segundo 3."
"Deixe-me contar uma história sobre meu primeiro Reel."Introdução lenta, payoff invisível"Meu primeiro Reel teve 11 visualizações. Aqui está a correção."
"Neste vídeo vamos cobrir cinco dicas."Genérico, sem aposta, sem lacuna de curiosidade"A dica 3 é a que ninguém faz."
"Então, basicamente, as legendas são meio importantes."Hesitante, ilegível no mudo, sem contraste"A maioria assiste no mudo. Sem legendas, sem visualizações."

Reflexo: corte seus primeiros cinco segundos. Os primeiros rascunhos quase sempre enterram o gancho atrás de uma saudação. Delete a configuração e comece na linha mais forte. Quando solicitado a dar variantes, entregue 5 ganchos em padrões diferentes — não cinco reescritas de um só.

Para a biblioteca completa de ganchos por tipo de conteúdo e um exemplo trabalhado de extração de vídeo longo → curto, consulte references/hook-and-script-patterns.md.

O artefato do roteiro

Uma tabela com timecode. Toda linha tem texto na tela — sem exceções (regra do som desligado).

## Roteiro — "Pare de postar às 9h" (28s, 9:16)

| Tempo | VO / falado | Texto na tela | Visual / B-roll |
|-------|-------------|----------------|-----------------|
| 0:00–0:03 | "Pare de postar às 9h." | PARE DE POSTAR ÀS 9H | Corte seco para o rosto, zoom-in rápido |
| 0:03–0:09 | "Seu público não está acordado — eles estão indo para o trabalho às 8." | 9h = seu pior horário | Relógio do celular 9:00 → deslize para 8:00 |
| 0:09–0:16 | "Os dados dizem que as noites vencem as manhãs para este nicho." | Noites vencem | B-roll: linha de gráfico subindo |
| 0:16–0:23 | "Teste às 18h por uma semana e veja o alcance." | Tente 18h por 7 dias | Gravação de tela do agendador definido para 18:00 |
| 0:23–0:26 | "Depois volte e me diga que eu estava errado." | Vou esperar. | Volta ao rosto, sobrancelha levantada |
| 0:26–0:28 | "Pare de postar às 9h." | PARE DE POSTAR ÀS 9H | Corte correspondente ao quadro de abertura (costura do loop) |

Observe que a última linha repete a linha e o quadro do gancho: esse é o loop, não um encerramento. Mantenha as linhas de VO curtas e com tom natural; o texto na tela é mais enxuto (4–7 palavras) e nunca um despejo exato do VO.

A ficha de decisão de edição

A EDS transforma o roteiro em instruções de corte. Amarre cada marcador a uma linha do roteiro.

  • Cadência de corte: um corte a cada 2–4 segundos. Shorts de alto desempenho têm essa média; coloque microcortes (0,4–1,2s) nos primeiros 2–3 planos para "acordar" quem está rolando. Mantenha pausas de silêncio abaixo de ~250ms — silêncio além de um quarto de segundo é lido como "bufferizando" e os espectadores saem (orientação de edição informada por fornecedores, OpusClip / driveeditor, 2026).
  • Marcadores de mudança visual — anote cada linha do roteiro com sua mudança (corte / B-roll / cartela de texto / zoom / reenquadramento) para que nenhuma linha fique estática além de 5s.
  • Quadro de gancho — nomeie o quadro de abertura exato (a still mais impactante). É a miniatura em movimento; se for chato, nada depois importa.
  • Costura do loop — especifique como o último quadro se funde ao primeiro (corte correspondente, mesmo enquadramento, mesma barra de áudio). O loop é o CTA: mesmo uma taxa de repetição de ~10% tem grande peso no algoritmo, e uma costura limpa fabrica repetições. Sem o tradicional "obrigado por assistir" no final.
  • Faixa de legenda — a estilização fica na próxima seção; a EDS apenas sinaliza "legendas: fixas, estilo X, ativas durante todo o tempo de execução."
## EDS — "Pare de postar às 9h"
- Quadro de gancho: rosto no meio da frase, olhos na lente, 0:00 (still mais impactante)
- Cortes: microcortes 0:00–0:03 (3 cortes), depois 1 corte / ~3s
- Pausas sem som: corte todo intervalo > 250ms
- B-roll: relógio (0:03), gráfico subindo (0:09), gravação de tela do agendador (0:16)
- Legendas: fixas, todos os 28s, estilo abaixo, margem inferior da zona segura respeitada
- Costura do loop: 0:26 corte correspondente ao quadro 0:00; mesma linha de VO faz a ponte
- CTA: implícito (o loop). Sem cartela de encerramento.

Legendas e zonas seguras

Vídeos legendados retêm melhor — o estudo primário da Verizon Media / Publicis Media (n=5.616, abril de 2019) constatou que 80% dos espectadores têm mais probabilidade de terminar um vídeo com legendas; fornecedores relatam um aumento adicional de ~15–25% na retenção (OpusClip / Verbit, 2026, dados de fornecedores). Trate as legendas como design, não como um pensamento posterior.

  • Grandes, de alto contraste, com um contorno ou caixa sólida — legíveis em uma tela de celular clara ao ar livre.
  • 4–7 palavras por linha, ≥2s na tela. Mais rápido que isso e o espectador no mudo não consegue ler.
  • Ativas durante todo o tempo de execução. Sem "legendas apenas no gancho."
  • Dentro das zonas seguras. Mantenha todo o texto e o CTA fora das margens da interface da plataforma (superior, inferior e faixa direita comem seu texto). Margens exatas em pixels por plataforma estão em references/specs-and-safe-zones.md.
  • Não enterre o gancho sob a legenda de um áudio de tendência. Se você usar um som em alta, seu próprio gancho na tela ainda domina o terço superior no primeiro segundo.

Reaproveite um mestre

Todas as três plataformas compartilham 9:16 @ 1080×1920, MP4 (vídeo H.264 + áudio AAC), 30 ou 60 fps (especificações vidIQ / Sprout Social, 2026). Uma exportação mestre é reaproveitada em Reels, Shorts e TikTok — para aparecer na prateleira do Shorts, basta mantê-lo vertical/quadrado e abaixo do limite de 3 min.

Ao passar para uma ferramenta (Suíte de IA 2026 do CapCut para edição automática com um clique + centenas de vozes TTS + legendas multilíngues + avatares de IA, OpusClip/Reap/Vizard para recorte de vídeos longos, Submagic para estilização de legendas): cole o roteiro + EDS como briefing. A ferramenta executa cortes e legendas rapidamente, mas não inventa seu gancho ou sua costura de loop — esses são seus. Os algoritmos agora rebaixam clipes óbvios de IA com baixo esforço, então a estrutura que você traz é exatamente o que separa o curto do enchimento. Especificações por plataforma, a lista de verificação de exportação e as capacidades atuais das ferramentas estão em references/specs-and-safe-zones.md.

Antipadrões

RuimPor que mata a retençãoBom
Introdução lenta / saudação antes do ponto~metade dos que saem vão embora nos primeiros 3s; você os gastou com "ei pessoal"Abra na linha mais forte; corte os primeiros 5s
Sem legendas fixasa maioria assiste no mudo; uma tela silenciosa não tem narrativaLegendas todo o tempo, 4–7 palavras/linha, alto contraste
Encerramento tradicional "obrigado por assistir"Termina o vídeo em vez de repeti-loCostura do loop: último quadro corta correspondendo ao primeiro
Um plano único de pessoa falando por 30sNenhuma mudança visual é lida como "acabou" após ~4sUm corte / B-roll / cartela de texto a cada 3–5s
Gancho que descreve o tópicoDescrição não tem promessa ou aposta, então não há razão para ficarPrometa um resultado ou abra uma lacuna de curiosidade
>45s sem escaladaEnergia plana derruba a conclusão além do ponto idealCorte para 15–30s, ou escale a cada batida
TTS narrando um bloco de texto na telaCamadas incompatíveis, nada para ler rapidamente, cheiro de clipe de IAVO enxuto + camada separada de legenda de 4–7 palavras
Áudio de tendência enterra seu próprio ganchoA legenda emprestada domina o primeiro segundo, não sua promessaSeu gancho domina o terço superior no primeiro quadro

Verifique e referências

  • Faça uma verificação de qualidade em um roteiro produzido com bash scripts/verify.sh caminho/para/roteiro.md — ele verifica se existe uma batida de gancho em 0:00, se cada batida tem texto na tela (som desligado), se o tempo de execução está em uma faixa curta sensata e se uma batida de loop/CTA o fecha. É somente leitura e sai com 0 em um roteiro limpo.
  • references/specs-and-safe-zones.md — tabela de especificações por plataforma, margens de zona segura em pixels, lista de verificação de exportação/reaproveitamento, instantâneo de ferramentas com data.
  • references/hook-and-script-patterns.md — biblioteca completa de ganchos por tipo de conteúdo, modelos de pauta de batidas + EDS, extração trabalhada de vídeo longo → curto.

Individual skills in this repo

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

ericrisco/rsc-harness

Use when writing the words on a single conversion page — the hero headline and subhead, the offer, the proof and testimonials, and one primary CTA — or diagnosing a page that gets traffic and does not convert, as a copy problem rather than a layout one. NOT the paid ad that drives the click (that is `ads`), NOT the visual layout the words sit in (that is `design`), NOT the experiment that picks the winning variant (that is `ab-testing`).

ericrisco/rsc-harness

Use when you need to render an actual video file with Remotion — React compositions, the Composition/Sequence/TransitionSeries graph, transitions, burned-in word-by-word captions from a transcript, automatic silence removal, b-roll overlays, headless CI renders, and a final MP4 or MOV. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT mastering audio to LUFS or building an RSS feed (that is `podcast`), NOT structuring the narrative arc (that is `course-storytelling`).

ericrisco/rsc-harness

Use when you have raw 9:16 footage and need it cut into a post-ready vertical short — dead air removed, fast jump cuts, karaoke word-by-word burned-in captions from a transcript, cuts and zooms snapped to the music beat, safe-area placement so captions clear the platform UI, and a platform-correct MP4 export. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT building a Remotion React composition codebase (that is `remotion-video`), NOT deciding when or where to post (that is `social-publisher`).

ericrisco/rsc-harness

Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).

ericrisco/rsc-harness

Use when a vertical short is shot or scripted and you need the upload-form copy and cover that win the feed — the hook line, the first-frame on-screen text, the search-led caption, a tight hashtag set, and the cover frame; it learns from what performed via the 02-DOCS log. NOT inventing the idea (that is `shortform-ideation`), NOT scripting or directing the cuts (that is `video-shorts`), NOT executing the edit (that is `shortform-editing`), NOT scheduling the post (that is `social-publisher`).

ericrisco/rsc-harness

Use when the unit of work is a TikTok/Reels account, not one clip: positioning, sustainable cadence and format mix, ride-or-skip on a trend or sound, recurring series, diagnosing a flat account, and the dated learning loop. NOT the single script or hook variants (that is `video-shorts`), NOT the idea backlog (that is `shortform-ideation`).

ericrisco/rsc-harness

Use when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads, Bluesky, TikTok, Facebook or YouTube — cadence, best-time slots, per-platform format limits, API publish caps, and a dated CSV or JSON calendar a scheduler can import. NOT the brand voice the posts speak in (that is `brand-voice`), NOT the editorial strategy of what to make (that is `content-engine`).

ericrisco/rsc-harness

Use when connecting a real TikTok account to code via the Content Posting, Display and Business Account APIs — OAuth, chunked video publish with status polling, and pulling views, watch time and impression sources, then logging that performance into the wiki as a dated feedback record. Covers short-lived tokens breaking a cron, unverified pull-from-URL ownership, and rate limits. NOT what to post or how to package it (that is `shortform-strategy` and `shortform-packaging`).

ericrisco/rsc-harness

Use to judge whether a short-form clip is worth publishing — scores a reel, short or podcast excerpt 0-100 on ten weighted criteria with automatic penalties, then ranks a batch and says where the cut-off falls. Run it on transcript candidates before rendering. NOT writing the hook or caption (that is `shortform-packaging`), NOT inventing the idea (that is `shortform-ideation`), NOT executing the edit (that is `shortform-editing`).

Habilidades Relacionadas