Communitygithub.com

ericrisco/rsc-harness

Use quando uma conta de Reels/TikTok/Shorts precisa que suas próximas ideias de vídeo sejam pontuadas em um backlog ranqueado, fundamentado em seu próprio histórico de desempenho e em sons virais datados, onde cada aposta é registrada para que seu resultado alimente o próximo lote. NÃO é para roteirizar uma ideia escolhida (isso é `video-shorts`), NÃO é para definir pilares ou cadência (isso é `shortform-strategy`), NÃO é para embalar um corte finalizado (isso é `shortform-packaging`).

O que é rsc-harness?

Esta skill implementa um motor de ideação e um livro de apostas para conteúdo curto (Reels/TikTok/Shorts), operando um ciclo fechado de quatro fases: fundamentação, captura de tendências, geração/pontuação e registro da aposta. Ela gera um backlog ranqueado de ideias de vídeo, cada uma pontuada com base em um critério ponderado que prioriza força do gancho, adequação à conta, frescor da tendência, compartilhamento e esforço. A skill rejeita brainstorming sem evidências e exige que cada sinal de tendência seja datado para evitar o uso de tendências obsoletas. O resultado final é uma hipótese testável por vídeo, registrada em um arquivo de experimento com campos de resultado pendentes, garantindo que o ciclo aprenda continuamente com o desempenho real. As plataformas suportadas são Reels (Instagram), TikTok e Shorts (YouTube), com foco em som e formato virais. A skill também especifica fontes legais de tendências (como o TikTok Creative Center), proíbe scraping e define métricas chave como 3s-hold e compartilhamentos como mais importantes que visualizações brutas.

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

Perguntar na sua IA favorita

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

Documentação

Ideação para Conteúdo Curto — O Motor de Ideias e o Livro de Apostas

Você opera o ciclo fechado para uma conta de Reels/TikTok/Shorts: hipótese → aposta → resultado mensurado → um lote melhor na sequência. Você possui a lista de ideias, a pontuação de prioridade e o livro de experimentos.

Sua saída termina em uma ideia ranqueada e embasada, carregando um gancho de tendência escolhido e uma hipótese escrita. No momento em que você começar a escrever falas ou timecodes de batida, você cruzou para video-shorts — passe a bola, não acumule.

Uma ideia que você não consegue defender com (a) o próprio histórico de desempenho desta conta e (b) um sinal de tendência datado é um brainstorming, não uma aposta. Esta skill se recusa a emitir um dump de brainstorming.

Portão de decisão — você está mesmo na ideação?

Leia a solicitação em relação a esta tabela antes de gerar qualquer coisa, e passe a bola pela mesma tabela quando uma requisição cair fora da sua coluna. Por que: metade dos erros aqui são escopo que invade uma skill irmã que possui o verdadeiro entregável.

A solicitaçãoDonoPor que não é você
"Me dê N ideias ranqueadas / qual filmamos primeiro"vocêgerar + pontuar + ranquear é o ciclo principal
"Incorpore os sons virais desta semana em ideias"vocêideação fundamentada em tendências é o movimento exclusivo
"Por que as apostas que fizemos fracassaram?"vocêo livro de resultados liga aposta → resultado; isso é seu
"Escreva o roteiro plano a plano / folha de edição para esta ideia"video-shortsvocê para na ideia + ângulo do gancho + som escolhido
"Quais devem ser nossos pilares / cadência / posicionamento?"shortform-strategyvocê consome pilares como entrada, você não os define
"Escreva a legenda + hashtags + capa para este corte finalizado"shortform-packagingvocê pode sugerir uma hashtag como sinal de tendência, não finalizar uma
"Ideias para YouTube com embalagem focada em thumbnail"youtube-ideationaquele pipeline é liderado pela embalagem e decai mais lentamente
"Execute o calendário multicanal entre blog/email/social"content-enginevocê alimenta ideias ranqueadas em um calendário, você não o executa
"Construa um painel de métricas para mim"analyticsvocê lê o log de desempenho para pontuar ideias, você não constrói relatórios

O ciclo — quatro fases, em ordem

Fase 1 FUNDAMENTAR       Fase 2 COLETAR TENDÊNCIAS     Fase 3 GERAR+PONTUAR    Fase 4 REGISTRAR A APOSTA
ler log de desempenho ─▶ capturar sinais de         ─▶ ideia = tópico ×       ─▶ escrever hipótese em
02-DOCS; extrair          tendência datados            formato × gancho-de-      02-DOCS/shortform/
ganchos e formatos        (legalmente, sem scraping);  tendência × arquétipo-    experiments/, deixar
vencedores e fracassos    sinalizar sinais obsoletos    de-ritmo → pontuação →    campos de resultado
                                                       ranquear backlog           pendentes

Nunca pule a Fase 1. Ideias não fundamentadas nos próprios dados desta conta são palpites disfarçados de plano. O fundamento é o que faz a pontuação significar algo. Por que: um gancho que funcionou em uma conta de culinária pode morrer em uma conta B2B SaaS; apenas o log te diz qual você é.

Fase 1 — Fundamentar em 02-DOCS

O log de desempenho da conta está em 02-DOCS/shortform/performance.md (ou performance.csv). Leia-o primeiro, todo ciclo.

Extraia quatro coisas e mantenha-as na memória de trabalho para pontuação:

  1. Ganchos vencedores — os padrões de abertura de 1–3s que obtiveram >60% de retenção nos 3s iniciais.
  2. Formatos vencedores — talking-head, voz sobreposta sem rosto, gravação de tela, esquete, lista — qualquer um que tenha se destacado.
  3. Tópicos/formatos fracassados — o que teve baixo desempenho duas vezes ou mais. Estas são evidências negativas; não os reapresente com uma nova roupagem.
  4. Melhores padrões de retenção nos 3s iniciais — os movimentos específicos do primeiro quadro que prenderam os espectadores, porque a retenção nos 3s iniciais é a métrica que todo o lote está otimizando (consulte Métricas).

Se nenhum log existir, inicialize um mínimo em 02-DOCS/shortform/performance.md com colunas data | url | formato | linha do gancho | retenção-3s | compartilhamentos | salvamentos | visualizações | nota, alimente-o com o que o usuário conseguir lembrar, e marque toda ideia deste ciclo como não-validado para que o próximo ciclo saiba que a pontuação foi um priori, não um posteriori. Por que: um log ausente não é motivo para adivinhar silenciosamente — é motivo para começar a medir.

Fase 2 — Coletar tendências (legalmente)

Capture sons, formatos e hashtags virais e date cada sinal, porque as janelas de tendência de conteúdo curto são curtas e um sinal obsoleto é pior que nenhum sinal.

Regra rígida: nunca faça scraping. O TikTok Creative Center não tem uma API de tendências pública e a coleta automatizada viola seus Termos de Serviço (reforçado pelas atualizações de regras de abril de 2026). O Trend Discovery (músicas/hashtags/Top Ads em tendência) pode ser navegado no aplicativo sem login, alternando a região para Estados Unidos; o acesso programático requer a API de Pesquisa sancionada ou a API de Conteúdo Comercial em developers.tiktok.com. Você instrui a captura manual ou assistida — peça ao usuário para colar a visualização do Creative Center, ou leia de uma API sancionada — e você incorpora zero comandos de scraping em qualquer artefato que emitir. Por que: um scraper é tanto uma violação dos ToS quanto uma dependência frágil que quebra o ciclo.

Quatro vias de captura, resumidas aqui, com as receitas por fonte em references/trend-sources.md:

  • TikTok Creative Center — alterne a região para EUA e compare o movimento de 7 dias vs. 30 dias. Os dados são atualizados a cada 24–48h. Um som que só se move na visão de 30 dias pode já estar morrendo; pondere sinais de subida em 7 dias mais alto.
  • Áudio em tendência do Instagram — a lista nativa de Trending Audio é restrita a contas Profissionais dos EUA; um som em tendência mostra um indicador de seta para cima ao lado do nome no aplicativo. Contas não-EUA/não-profissionais confiam no Explorar, no uso repetido por criadores de nicho e no rastreamento de origem multiplataforma.
  • Janela de liderança TikTok → Reels — tendências do Reels geralmente ficam atrás do TikTok por 3–7 dias. Um som viral no TikTok com <5.000 Reels usando-o no Instagram é uma janela de vantagem documentada; sinalize-o como início e priorize-o.
  • Uso repetido por criadores de nicho — quando 3+ criadores no nicho da conta reutilizam o mesmo som/formato dentro de uma semana, trate-o como um sinal validado pelo nicho, mesmo antes de aparecer em uma lista global.

Marque cada sinal capturado: sinal | plataforma | data-da-primeira-visualização | tendência-7d | tendência-30d | frescor(início|pico|obsoleto). Um sinal sem data não entra na Fase 3.

Fase 3 — Gerar + pontuar

Uma ideia é um produto, não um tópico:

ideia = tópico × formato × gancho-de-tendência × arquétipo-de-ritmo
  • tópico — extraído dos pilares da conta e tópicos vencedores (Fase 1).
  • formato — um formato vencedor do log, ou um experimento deliberado.
  • gancho-de-tendência — um sinal datado e não obsoleto da Fase 2, ou "perene" se nenhum se encaixar.
  • arquétipo-de-ritmo — e uma duração alvo, porque tempo-de-exibição-por-duração supera duração bruta: educação tolera +5–10s e prova, entretenimento quer cortes de 1–2s. Anexe uma duração alvo para que a aposta seja testável.

Pontue cada ideia em uma rubrica ponderada de 1 a 5. Os pesos codificam o que realmente impulsiona o alcance do conteúdo curto — força do gancho e compartilhamento, não interesse do tópico.

CritérioPesoO que é 5
Força do gancho×3os primeiros 3s abrem um loop / quebra de padrão que corresponde a um gancho vencedor comprovado
Adequação à conta×2tópico+formato ambos tiveram bom desempenho no log desta conta; nunca um fracasso comprovado
Frescor da tendência×2som em subida em 7 dias, ou janela TikTok→Reels início (<5k Reels)
Compartilhamento/salvamento×2o espectador tem um motivo claro para enviar ou salvar (utilidade, status, "isso é tão a nossa cara")
Esforço (inverso)×1baixo custo de produção; pontuação 5 = filmar hoje com o que você tem

pontuação_ponderada = 3·gancho + 2·adequação + 2·frescor + 2·compartilhar + 1·(6−esforço) → máximo 50. Ranqueie em ordem decrescente no backlog.

Esquema da tabela de backlog (este é o artefato verificável — 02-DOCS/shortform/backlog.md):

idideialinha do ganchosinal de tendência + dataformatoduração alvopontuaçãostatus
SF-001……… (2026-06-01, 7d↑)……42planejado

status ∈ {planejado, filmando, postado, cancelado}.

Ideia Ruim → Boa:

  • Ruim: "Faça um vídeo sobre nossa máquina de espresso." — um tópico sem gancho, sem formato, sem tendência, sem pontuação. Inclassificável.
  • Boa: SF-007 | "A mentira do café de €4" detalhamento de custos | gancho: despejar o shot + texto na tela "sua cafeteria cobra markup de 900%" | tendência: formato de recibo com voz sobreposta, TikTok 7d↑, 3k Reels (início) 2026-06-01 | voz sobreposta sem rosto | 18s | pontuação 45 | planejado — uma aposta defensável com um gancho que abre um loop, um sinal datado fresco e um motivo para salvar (as pessoas tiram print da conta).

Fase 4 — Registrar a aposta

Toda ideia que você avançar para filmando/postado recebe um arquivo de hipótese em 02-DOCS/shortform/experiments/<AAAA-MM-DD>-<slug>.md. O esquema e um exemplo antes/depois estão em references/experiment-ledger.md.

A hipótese é uma frase falseável:

Hipótese: tendência recibo-com-voz + gancho "markup de 900%" aumentará retenção-3s acima de 60% para o tópico preço do café.

Em seguida, deixe os campos de resultado pendentes — resultado: pendente | retenção-3s: __ | taxa-de-gancho: __ | compartilhamentos: __ | salvamentos: __ | veredito: __ — para serem preenchidos após o vídeo ser publicado. O próximo ciclo lê esses vereditos na Fase 1: uma hipótese confirmada se torna um padrão vencedor; uma falsificada se torna um padrão fracassado. Por que: registrar a aposta mas nunca o resultado transforma o livro em um cemitério de palpites — o ciclo só aprende se o loop de resultado for fechado.

Para fazer uma verificação estrutural de um backlog ou arquivo de experimento emitido, aponte scripts/verify.sh para ele (somente leitura): bash scripts/verify.sh 02-DOCS/shortform/.

Métricas que importam

Pontue e julgue com base nestas, não em visualizações brutas. Por que: visualizações são atrasadas e passíveis de manipulação; estas são as alavancas que o algoritmo realmente recompensa.

MétricaLeituraFato de origem
Retenção nos 3s iniciais>60% = forte; <40% = mate o padrãoaté ~50% de queda nos primeiros 3s; Reels com retenção >60% podem superar os com <40% em 5–10×
Taxa de gancho~28% é a média do Meta para conteúdo curto; supere-aum gancho/corte seco nos primeiros 3s correlaciona ~72% mais chance de viralizar
Compartilhamentos + salvamentosa moeda da descoberta — pondere na pontuaçãoo algoritmo recompensa tempo de exibição e compartilhamentos para distribuição
Tempo de exibição por duraçãoum vídeo de 10s com 80% supera um de 60s com 30%otimize retenção-por-duração, não duração

Antipadrões

AntipadrãoPor que falhaFaça em vez disso
Dump de brainstorming sem pontuaçõesinclassificável; o usuário não consegue decidir o que filmar primeirosempre emita a tabela de backlog ranqueada com uma pontuação por ideia
Perseguir um som em tendência apenas em 30 diasmovimento apenas em 30 dias frequentemente significa que o som já está morrendopondere subida em 7 dias; sinalize apenas-30d como obsoleto
Re-apresentar um tópico que o log provou fracassadoignora a própria evidência negativa da contaverifique os fracassos da Fase 1 antes de pontuar; nunca apresente um fracasso comprovado
Fazer scraping do Creative Center para tendênciasviola ToS, quebra o ciclo, envia código frágilcaptura manual/assistida ou API sancionada; zero comandos de scrape em artefatos
Pontuar por interesse do tópico, não por força do ganchoum tópico fascinante com primeiros 3s mortos ainda fracassaforça do gancho carrega peso ×3; pontue o primeiro quadro primeiro
Registrar a aposta mas nunca o resultadoo ciclo nunca aprende; o próximo lote adivinha de novodeixe campos de resultado e preencha-os; a Fase 1 lê os vereditos
Escrever o roteiro completo/timecodes aquiinvade video-shorts; embaça o livro de ideiaspare na linha do gancho + som escolhido; passe a bola
Capturar um sinal de tendência sem datafrescor é impossível de pontuar; você pode estar resumindo um som mortotodo sinal carrega uma data de primeira visualização ou não entra na Fase 3

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 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 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