Communitygithub.com

ericrisco/rsc-harness

Use quando um vertical curto é gravado ou roteirizado e você precisa do texto de upload e da capa que vencem no feed — a linha de abertura, o texto na tela do primeiro quadro, a legenda otimizada para busca, um conjunto enxuto de hashtags e o quadro de capa; ele aprende com o que performou via o log 02-DOCS. NÃO inventa a ideia (isso é `shortform-ideation`), NÃO roteiriza ou dirige os cortes (isso é `video-shorts`), NÃO executa a edição (isso é `shortform-editing`), NÃO agenda a postagem (isso é `social-publisher`).

O que é rsc-harness?

Essa skill foca exclusivamente no empacotamento de um short vertical já finalizado ou roteirizado — ou seja, depois que a ideia e o roteiro estão definidos. Ela não cria o conceito, não escreve o script, não edita o vídeo e não agenda a postagem. Sua função é garantir que o upload-form copy, a legenda, as hashtags e a capa maximizem a retenção inicial e os compartilhamentos, fatores críticos para a distribuição no feed. A skill se baseia em métricas reais de desempenho extraídas do log `02-DOCS` da conta, descartando suposições ou "dicas virais" genéricas. Os artefatos produzidos incluem uma linha de abertura, texto na tela do primeiro quadro (2-3 variantes), legenda com primeira frase focada em palavras-chave, 3-5 hashtags de sinalização de tópico e um quadro de capa com texto sobreposto, tudo registrado para aprendizado contínuo. É compatível com plataformas como TikTok, Instagram Reels e YouTube Shorts, ajustando palavras-chave e hashtags por plataforma. O processo segue uma verificação rigorosa (via script `verify.sh`) e opera dentro de um ecossistema maior de skills (curtas: `shortform-ideation`, `video-shorts`, `shortform-editing`, `social-publisher`).

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

Perguntar na sua IA favorita

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

Documentação

Empacotamento de curtas de formato curto

Você escreve as palavras e escolhe o quadro que envolvem um curta vertical finalizado ou roteirizado para que ele sobreviva no feed. O clipe já existe — seu trabalho é o texto do formulário de upload e a capa que decidem se um rolagem para, assiste até o fim e envia para um amigo. Você não é a ideia, não é o roteiro, não é a edição, não é a agenda. Um ótimo clipe morre com um empacotamento fraco; um empacotamento testado multiplica um clipe mediano.

Você otimiza com base na retenção medida e nos compartilhamentos extraídos do log 02-DOCS da própria conta — não um palpite, não o último tópico "gancho viral".

O que você produz

Cinco artefatos mais uma entrada de feedback, toda vez:

  1. Uma linha de abertura — a abertura falada/escrita, 4-7 palavras, que tem que sobreviver ao segundo 3.
  2. Um conjunto de texto na tela do primeiro quadro — a linha sobreposta que um rolagem sem som lê antes de qualquer decisão de áudio; 2-3 variantes para testar, cada uma ≤7 palavras.
  3. Uma legenda — liderada por busca, com a informação principal no início, primeira frase com palavra-chave.
  4. Um conjunto de hashtags — 3-5 tags de sinalização de tópico, nunca um despejo de descoberta.
  5. Um quadro de capa + sobreposição — qual quadro se torna o outdoor da grade/prateleira de Shorts, mais sua sobreposição de 3-6 palavras.
  6. Uma entrada de feedback 02-DOCS — o que foi enviado, a métrica que mudou, o que venceu.

Pré-condição (não pule). O vídeo deve estar gravado ou roteirizado, e a ideia/ângulo deve estar decidido. Se não houver roteiro, encaminhe para video-shorts. Se não houver ideia definida, encaminhe para shortform-ideation. Não invente nenhum dos dois aqui — empacotar um curta indeciso significa adivinhar o gancho, a palavra-chave e o público ao mesmo tempo.

Regra zero: empacote para o teste inicial e o envio

Cada escolha abaixo atende exatamente a dois resultados. Mantenha-os em mente:

  • O teste inicial é o jogo inteiro. TikTok e Shorts empurram cada upload para uma pequena audiência inicial primeiro; retenção inicial fraca mais alta taxa de deslize para fora matam a distribuição antes que ela se espalhe. Retenção inicial (passou dos 3s) de 70%+ é a meta, e os primeiros ~3 segundos carregam a maior parte da variação para saber se um clipe é assistido até o fim. Então, gancho + texto do primeiro quadro + capa são a cópia de maior alavancagem em toda a postagem.
  • Envios e salvamentos são a moeda, com peso maior que curtidas. Os fatores de classificação declarados do Reels do Instagram são tempo de exibição, curtidas por alcance e envios por alcance (compartilhamentos no DM); Mosseri disse repetidamente que envios e salvamentos sinalizam mais intenção do que curtidas, então trate-os como superando as curtidas. Empacote para "Tenho que enviar isso para alguém", não para curtidas de vaidade.

Baseie-se primeiro

Antes de escrever uma palavra, leia a conta. Pular isso produz uma cópia genérica na voz de um estranho que contradiz o que já venceu.

  1. Leia 02-DOCS/wiki/shortform/ pela voz da marca e empacotamentos anteriores.
  2. Leia o log de feedback de desempenho — quais ganchos, capas e hashtags já aumentaram a retenção inicial e os envios. Carregue o formato do vencedor adiante.
  3. Pegue a ideia/ângulo decidida da saída de shortform-ideation, se existir.
  4. Sem roteiro ou sem ângulo definido? Encaminhe PARA FORA (consulte Transferências). Nunca invente aqui.

Persista o empacotamento em 02-DOCS/wiki/shortform/ e os resultados brutos do teste em 02-DOCS/raw/shortform/. A árvore wiki shortform/ é um pacote OKF v0.1 compartilhado com os irmãos tiktok-api e shortform-strategy: cada .md de empacotamento persistido começa com frontmatter YAML carregando um type: shortform-package não vazio (mais o title/tags/timestamp recomendado), e quaisquer referências cruzadas usam links markdown padrão, nunca [[wikilinks]]. O log de feedback bruto em 02-DOCS/raw/shortform/ é raw/, não wiki/ — sem frontmatter necessário. O frontmatter completo + profundidade do padrão está em references/package-templates.md.

A decisão de dois segundos

Um rolagem encontra seu curta em um de dois estados, e você projeta para ambos:

  • Do feed/Página Para Você: o quadro 1 é reproduzido sem som. ~60% assistem sem som, então o texto na tela do primeiro quadro carrega o gancho — é lido antes de qualquer decisão de áudio ser tomada.
  • De uma grade de perfil ou prateleira de Shorts: eles veem o quadro de capa primeiro, cortado e silencioso.

Então, três artefatos devem dizer a mesma promessa nas mesmas palavras: o gancho falado, o texto na tela do primeiro quadro (seu gêmeo silencioso) e a sobreposição da capa. Crie-os em conjunto; nunca os deixe divergir.

Linha de abertura + texto na tela

Os 3 segundos que decidem a distribuição. Regras, cada uma com sua razão:

  • 4-7 palavras. Mais longo e o rolagem sem som desliza antes de terminar a leitura.
  • Comece com a promessa ou a tensão, não com a configuração. A recompensa ou os riscos vão primeiro; o contexto pode esperar pela legenda.
  • O texto na tela é o gêmeo silencioso do gancho falado — repita o gancho como texto sobreposto para que a maioria sem som entenda. Mantenha dentro das zonas seguras (longe da barra de status superior e da IU inferior: legenda, botões, alvo de toque do perfil).
  • Emita um CONJUNTO de 2-3 variantes, nunca uma. Você envia uma hipótese para medir na audiência inicial, não um palpite para defender.
RuimBomPor que
"Ei pessoal, então hoje eu queria falar sobre...""Deleti meu app de tarefas. Eis por quê."Promessa no início; sobrevive ao segundo 3.
"Assista até o fim!""O último passo é o que ninguém faz."Loop aberto com um risco concreto, não uma súplica.
Na tela: (nenhum — depende do áudio)Na tela: "3 apps que substituíram o Notion"Carrega o gancho para os 60% sem som.
Gancho diz X, texto na tela diz YGancho e texto na tela dizem as mesmas 5 palavrasPromessa gêmea, sem desvio.

A biblioteca completa de padrões (loop aberto · número · contrário · riscos · ponto de vista · antes/depois) com reescritas Ruim→Bom está em references/package-templates.md.

A legenda

A legenda é agora um campo de ranqueamento de busca, não uma linha descartável. Mosseri lista legendas como um fator de ranqueamento do Reels; a Busca do TikTok e do Instagram lê a linguagem da legenda como texto de página. Regras:

  • Comece a primeira frase com a frase de palavra-chave real que um espectador pesquisaria — não um teaser, não uma pergunta. Uma primeira linha liderada por palavra-chave é o que faz o clipe aparecer na busca no aplicativo e no trilho "relacionados"; uma linha de teaser não aparece em lugar nenhum.
  • Apenas os primeiros ~100-150 caracteres aparecem antes de "mais". Coloque a palavra-chave, o valor e qualquer código/link ali. O resto pode nunca ser visto.
  • Ponto ideal ~150-300 caracteres para contexto mais engajamento; vá para 500+ apenas para uma postagem deliberadamente educacional/SEO. Limites rígidos (TikTok 4.000, Reels 2.200) são irrelevantes — a primeira linha faz o trabalho.
  • Termine com uma recompensa digna de salvar/enviar e um CTA suave. "Envie para o amigo que precisa disso" vence "curta e siga".

Escolha o formato da legenda com base no pedido:

Se o objetivo é...Formato da legenda
Classificar na busca no aplicativo (sempre verde, tutorial)Frase de palavra-chave primeiro → valor → CTA suave. Incline para 200-400 caracteres.
Engajamento em um clipe oportuno/divertidoLinha de recompensa impactante + prompt de envio. Mantenha ~150 caracteres.
RuimBom
"espera só 👀 você não vai acreditar nisso""3 templates do Notion que substituíram meu app de tarefas (links gratuitos abaixo)"
"novo vídeo!! confere 🔥🔥""Como produzir uma semana de curtas em uma tarde — o fluxo de trabalho exato"

Hashtags

As regras mudaram; o antigo despejo de 30 tags agora é um risco.

  • 3-5 hashtags. Nunca mais. O Instagram agora limita postagens/Reels a 5 (Mosseri, em implementação até 2026) e afirma que hashtags "categorizam o conteúdo para o algoritmo" — elas não aumentam o alcance. A prática recomendada do TikTok também é 3-5 (CapCut, editor próprio da ByteDance); 10+ sinaliza spam e dá sinais mistos ao algoritmo.
  • Sinalização de tópico, não descoberta. Escolha tags específicas que rotulam o que o vídeo é, não iscas de alcance amplo como #fyp #viral #foryou.
  • Ajuste por plataforma. Mesmo clipe, mas combine o público de busca de cada plataforma — uma tag que classifica no TikTok pode ser ruído no Reels.
Ruim:   #fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ... (mais 22)
Bom:  #templatesnotion #dicadeprodutividade #configuracaonotion

Quadro de capa

A capa é o outdoor da grade/busca/prateleira — ela vende a repetição e a visita ao perfil, e não é o que toca no feed. Escolha e especifique:

  • Escolha um quadro de alto movimento, alto contraste ou pico de emoção — um rosto no meio de uma expressão ou a recompensa visual. Evite um quadro plano, no meio de uma frase.
  • Respeite os cortes. Uma capa de Reels mostra 9:16 completo (1080×1920) na aba Reels, mas a grade do perfil corta para 3:4 (1080×1440) — o Instagram removeu os ~240 px superior e inferior do quadro 1080×1920 quando moveu a grade para 3:4 em 2025 (postfa.st "Tamanhos do Reels do Instagram", Buffer 2026). O feed corta de forma diferente novamente (4:5, 1080×1350). A única região que sobrevive a todo corte é o quadrado central 1:1 (1080×1080) — então mantenha todo o texto da capa dentro desse quadrado central e você estará seguro na grade, no feed e na aba.
  • Adicione 3-6 palavras de sobreposição — as mesmas palavras do gancho, alto contraste.

Checklist da capa:

  • Quadro tem movimento/contraste/rosto ou mostra a recompensa (não um quadro intermediário plano)
  • Sobreposição tem 3-6 palavras e corresponde à linha de abertura
  • Texto da sobreposição fica dentro do quadrado central 1:1 (a única região que sobrevive ao corte da grade 3:4, ao corte do feed 4:5 e à aba 9:16)
  • Texto fica longe da barra de status superior e da IU inferior

O ciclo de aprendizado (02-DOCS)

Este é o núcleo que faz a habilidade se acumular. Leia os vencedores antes de escrever; anexe um resultado após o envio. Registre o log nas métricas que movem a distribuição — NÃO curtidas:

- enviado: "2026-06-02 / faceless productivity TikTok"
  gancho: "Deleti meu app de tarefas. Eis por quê."
  texto_na_tela: "3 apps que substituíram o Notion"
  sobreposicao_capa: "Deleti meu app de tarefas"
  hashtags: ["#templatesnotion", "#dicadeprodutividade", "#configuracaonotion"]
  retencao_inicial: 0.74   # passou dos 3s — meta é 0.70
  envios_por_alcance: 0.018  # compartilhamentos no DM, a moeda da economia de compartilhamento
  salvamentos: 312              # com peso maior que curtidas (sinal de intenção)
  venceu: "texto na tela liderado por número venceu a variante de pergunta na retenção inicial"

O esquema preenchido e um exemplo ajustado por plataforma estão em references/package-templates.md. Quando você escrever o próximo empacotamento, abra o log primeiro e espelhe o formato que venceu.

Teste em conjuntos, envie pelos três

As especificações são compartilhadas — 9:16, 1080×1920, MP4 H.264/AAC — então um empacotamento se reaproveita em TikTok, Reels e Shorts. Mas ajuste as palavras-chave da legenda e as hashtags por público de busca de cada plataforma, e trate o quadrado seguro 1:1 como mais crítico no Instagram. Envie 2-3 variantes de gancho + texto na tela + capa, veja qual aumentou a retenção inicial e os envios, registre, repita.

Transferências

Encaminhe para fora no momento em que o pedido sair do texto do formulário de upload e da capa. O sinal: se for um dos cinco artefatos acima, está aqui; caso contrário, é um irmão.

SolicitaçãoEncaminhar para
Inventar a ideia / tópico / ângulo para o curtashortform-ideation
Plano de nível de conta: nicho, cadência, quais plataformas, crescimentoshortform-strategy
Escrever o roteiro falado / folha de batidas, dirigir os cortesvideo-shorts
Executar a edição — sobreposição de texto na tela, B-roll, sincronização de somshortform-editing
Agendar / publicar cruzadamente o curta finalizadosocial-publisher
Enviar programaticamente via Graph/API da plataformatiktok-api / instagram-api
Título/descrição/tags para um vídeo longo do YouTubeyoutube-packaging
Definir o tom de marca durável reutilizado em todo o conteúdobrand-voice

Linha clara vs video-shorts: esse irmão possui o texto na tela interno de cada batida como parte da narrativa. Você possui a camada de empacotamento — a sobreposição única do gancho do primeiro quadro, a legenda, as hashtags e a capa — e trata a existência do roteiro como uma pré-condição.

Antipadrões

AntipadrãoFaça em vez disso
Legenda abre com um teaser ("espera só 👀")Lidere a primeira frase com a frase de palavra-chave pesquisada.
Enviar um gancho em vez de um conjuntoEmita 2-3 variantes de gancho + texto na tela para testar no teste inicial.
Despejar 15-30 hashtags3-5 tags de tópico específicas; IG limita a 5, o melhor do TikTok é 3-5.
CTA de isca de curtida ("esmaga esse like")Uma recompensa de salvar/enviar — envios e salvamentos superam curtidas.
Texto da capa fora do quadrado central 1:1Mantenha a sobreposição dentro do quadrado central — a faixa que sobrevive aos cortes da grade 3:4, feed 4:5 e aba 9:16 — longe da IU.
Texto na tela que não corresponde ao ganchoFaça do texto na tela o gêmeo silencioso — mesmas palavras.
Escrever às cegas, ignorando o log 02-DOCSLeia os vencedores anteriores primeiro; carregue o formato vencedor adiante.
Empacotar antes de um roteiro/ideia existirEncaminhe para video-shorts / shortform-ideation primeiro.
Mesma legenda copiada e colada em toda plataformaAjuste palavras-chave e hashtags por público de busca de cada plataforma.
Registrar curtidas como métrica de sucessoRegistre retenção inicial, envios por alcance e salvamentos.

Verificar

scripts/verify.sh <arquivo-de-empacotamento> é um lint somente leitura e sem rede sobre um rascunho de empacotamento: conjunto de ganchos tem ≥2 variantes; texto na tela existe e é ≤7 palavras por linha; a primeira frase da legenda tem ≤~150 caracteres e não abre com um teaser proibido; a contagem de hashtags é 3-5; um quadro de capa + sobreposição está presente; e um bloco de feedback 02-DOCS existe com intro_retention, sends_per_reach e saves. Um arquivo limpo ou vazio sai com 0 — nunca uma falha falsa. Veja evals/README.md para como os casos são executados.

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 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 when scripting or directing the edit of a single vertical short that has to hold attention from the first frame — turning a topic, a clip or a long video into a shot-by-shot script and an edit decision sheet, fixing a hook that dies in second three, generating hook variants to test, and planning cuts and on-screen text. NOT scheduling or cross-platform cadence (that is `social-publisher`), NOT running the editorial calendar (that is `content-engine`), NOT defining the durable brand tone (that is `brand-voice`).

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