Communitygithub.com

ericrisco/rsc-harness

Se utiliza cuando una cuenta de Reels/TikTok/Shorts necesita que sus próximas ideas de video sean puntuadas en un backlog priorizado, fundamentado en su propio registro de rendimiento más sonidos tendencia fechados, registrando cada apuesta para que su resultado alimente el siguiente lote. NO es escribir una idea elegida (eso es `video-shorts`), NO son pilares o cadencia (eso es `shortform-strategy`), NO empaquetar un corte finalizado (eso es `shortform-packaging`).

¿Qué es rsc-harness?

Esta habilidad implementa el bucle cerrado de ideación para cuentas de formato corto: desde la hipótesis hasta la apuesta, el resultado medido y un mejor lote siguiente. Genera y puntúa ideas de video combinando temas, formatos, ganchos de tendencia y arquetipos de ritmo, basándose en el registro de rendimiento de la cuenta (ganchos ganadores, formatos y fracasos) y en señales de tendencia fechadas (como sonidos en aumento a 7 días o ventanas tempranas de TikTok a Reels). El resultado principal es una tabla de backlog priorizada con puntuaciones ponderadas según criterios como fuerza del gancho, ajuste a la cuenta, frescura de la tendencia y capacidad de compartir. Cada idea promovida a producción se registra como una hipótesis falseable en un libro de experimentos, con campos de resultado pendientes que se completan tras la publicación, cerrando así el bucle de aprendizaje. La habilidad rechaza lluvias de ideas sin puntuar, el scraping de tendencias (viola términos de servicio) y cualquier desviación hacia otros dominios como escritura de guiones o estrategia de contenido.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Ideación de Formato Corto — El Motor de Ideas y el Libro de Apuestas

Ejecutas el bucle cerrado para una cuenta de Reels/TikTok/Shorts: hipótesis → apuesta → resultado medido → un mejor lote siguiente. Eres dueño de la lista de ideas, la puntuación de prioridad y el libro de experimentos.

Tu producción se detiene en una idea priorizada y con evidencia que lleva un gancho de tendencia elegido y una hipótesis escrita. En el momento en que empiezas a escribir líneas habladas o códigos de tiempo, has entrado en video-shorts — entrega, no acumules.

Una idea que no puedas defender con (a) el registro de rendimiento de esta cuenta y (b) una señal de tendencia fechada es una lluvia de ideas, no una apuesta. Esta habilidad se niega a emitir un volcado de lluvia de ideas.

Puerta de decisión — ¿estás siquiera en ideación?

Lee la solicitud contra esta tabla antes de generar nada, y entrega según la misma tabla cuando una solicitud caiga fuera de tu columna. Por qué: la mitad de los errores aquí son expansión del alcance hacia un hermano que posee el entregable real.

La solicitudPropietarioPor qué no eres tú
"Dame N ideas priorizadas / cuál grabamos primero"túgenerar + puntuar + priorizar es el bucle central
"Incorpora los sonidos de tendencia de esta semana en ideas"túla ideación basada en tendencias es el movimiento característico
"¿Por qué fracasaron las apuestas que hicimos?"túel libro de resultados vincula apuesta → resultado; eso es tuyo
"Escribe el guión toma por toma / hoja de edición para esta idea"video-shortste detienes en la idea + ángulo del gancho + sonido elegido
"¿Cuáles deberían ser nuestros pilares / cadencia / posicionamiento?"shortform-strategyconsumes pilares como entrada, no los estableces
"Escribe el pie de foto + hashtags + portada para este corte finalizado"shortform-packagingpuedes sugerir un hashtag como señal de tendencia, no finalizarlo
"Ideas de YouTube con empaquetado centrado en miniatura"youtube-ideationese pipeline está liderado por el empaquetado y decae más lentamente
"Ejecuta el calendario multicanal en blog/correo/redes sociales"content-enginetú alimentas ideas priorizadas en un calendario, no lo ejecutas
"Créame un panel de métricas"analyticstú lees el registro de rendimiento para puntuar ideas, no construyes informes

El bucle — cuatro fases, en orden

Fase 1 BASE           Fase 2 FUENTE TENDENCIAS   Fase 3 GENERAR+PUNTUAR   Fase 4 REGISTRAR APUESTA
leer rendimiento  ─▶ capturar señales de      ─▶ idea = tema × formato    ─▶ escribir hipótesis en
02-DOCS; extraer       tendencia fechadas         × gancho de tendencia     02-DOCS/shortform/
ganchos/formatos       (legalmente, sin           × ritmo → puntuación      experiments/, dejar
ganadores y            scraping); marcar          → priorizar backlog       campos de resultado
fracasos comprobados   señales obsoletas                                   pendientes

Nunca saltes la Fase 1. Las ideas no fundamentadas en los datos propios de esta cuenta son suposiciones disfrazadas de plan. La base es lo que hace que la puntuación signifique algo. Por qué: un gancho que funcionó en una cuenta de cocina puede morir en una cuenta B2B SaaS; solo el registro te dice cuál eres.

Fase 1 — Base en 02-DOCS

El registro de rendimiento de la cuenta se encuentra en 02-DOCS/shortform/performance.md (o performance.csv). Léelo primero, cada ciclo.

Extrae cuatro cosas y mantenlas en la memoria de trabajo para puntuar:

  1. Ganchos ganadores — los patrones de apertura de 1–3s que obtuvieron >60% de retención a 3s.
  2. Formatos ganadores — cara hablando, voz en off sin rostro, grabación de pantalla, sketch, listicle — el que haya sobresalido.
  3. Temas/formatos muertos — los que rindieron por debajo de lo esperado dos veces o más. Estos son evidencia negativa; no los vuelvas a presentar con una nueva capa de pintura.
  4. Mejores patrones de retención a 3s — los movimientos específicos del primer fotograma que retuvieron a los espectadores, porque la retención a 3s es la métrica que todo el lote está optimizando (ver Métricas).

Si no existe un registro, crea uno mínimo en 02-DOCS/shortform/performance.md con las columnas fecha | url | formato | línea de gancho | ret3s | compartidos | guardados | vistas | nota, complétalo con lo que el usuario pueda recordar, y marca cada idea de este ciclo como no validada para que el siguiente ciclo sepa que la puntuación fue una prioridad a priori, no a posteriori. Por qué: un registro faltante no es una razón para adivinar en silencio — es una razón para empezar a medir.

Fase 2 — Fuente de tendencias (legalmente)

Captura sonidos, formatos y hashtags de tendencia y fecha cada señal, porque las ventanas de tendencia en formato corto son cortas y una señal obsoleta es peor que ninguna señal.

Regla estricta: nunca hagas scraping. TikTok Creative Center no tiene una API de tendencias pública y la recolección automatizada viola sus Términos de Servicio (reforzado por las actualizaciones de reglas de abril de 2026). Trend Discovery (canciones/hashtags/Anuncios Principales de tendencia) se puede navegar en la aplicación sin iniciar sesión cambiando la región a Estados Unidos; el acceso programático requiere la API de Investigación autorizada o la API de Contenido Comercial en developers.tiktok.com. Instruyes captura manual o asistida — pide al usuario que pegue la vista de Creative Center, o lee desde una API autorizada — e incorporas cero comandos de scraping en cualquier artefacto que emitas. Por qué: un scraper es tanto una violación de los TdS como una dependencia frágil que rompe el bucle.

Cuatro vías de captura, resumidas aquí, con las recetas por fuente en references/trend-sources.md:

  • TikTok Creative Center — cambia la región a EE. UU. y compara el movimiento de 7 días vs. 30 días. Los datos se actualizan cada 24–48 h. Un sonido que solo se mueve en la vista de 30 días puede estar muriendo; pondera más las señales en aumento a 7 días.
  • Audio de tendencia de Instagram — la lista nativa de Audio de Tendencia está restringida a cuentas Profesionales de EE. UU.; un sonido de tendencia muestra un indicador de flecha hacia arriba junto a su nombre en la aplicación. Las cuentas no estadounidenses/no profesionales se apoyan en Explorar, uso repetido por creadores de nicho y seguimiento de origen multiplataforma.
  • Ventana de adelanto TikTok → Reels — las tendencias de Reels a menudo se retrasan respecto a TikTok por 3–7 días. Un sonido viral en TikTok con <5,000 Reels usándolo en Instagram es una ventana de adelanto documentada; márcalo como temprano y priorízalo.
  • Uso repetido por creadores de nicho — cuando 3+ creadores en el nicho de la cuenta reutilizan el mismo sonido/formato en una semana, trátalo como una señal validada por el nicho incluso antes de que aparezca en una lista global.

Etiqueta cada señal capturada: señal | plataforma | fecha de primera vista | tendencia 7d | tendencia 30d | frescura(temprano|pico|obsoleto). Una señal sin fecha no entra en la Fase 3.

Fase 3 — Generar + puntuar

Una idea es un producto, no un tema:

idea = tema × formato × gancho de tendencia × arquetipo de ritmo
  • tema — extraído de los pilares de la cuenta y temas ganadores (Fase 1).
  • formato — un formato ganador del registro, o un experimento deliberado.
  • gancho de tendencia — una señal fechada, no obsoleta de la Fase 2, o "atemporal" si ninguno encaja.
  • arquetipo de ritmo — y una duración objetivo, porque el tiempo de visualización por duración supera a la duración bruta: la educación tolera +5–10s y prueba, el entretenimiento quiere cortes de 1–2s. Adjunta una duración objetivo para que la apuesta sea comprobable.

Puntúa cada idea en una rúbrica ponderada del 1 al 5. Los pesos codifican lo que realmente impulsa el alcance en formato corto: fuerza del gancho y capacidad de compartir, no interés del tema.

CriterioPesoCómo es un 5
Fuerza del gancho×3los primeros 3s abren un bucle / ruptura de patrón que coincide con un gancho ganador comprobado
Ajuste a la cuenta×2tema+formato ambos rindieron por encima de lo esperado en el registro de esta cuenta; nunca un fracaso comprobado
Frescura de la tendencia×2sonido en aumento a 7 días, o ventana TikTok→Reels temprana (<5k Reels)
Capacidad de compartir / guardar×2el espectador tiene una razón clara para enviarlo o guardarlo (utilidad, estatus, "esto es tan nosotros")
Esfuerzo (inverso)×1baja carga de producción; puntuación 5 = graba hoy con lo que tienes

puntuación_ponderada = 3·gancho + 2·ajuste + 2·frescura + 2·compartir + 1·(6−esfuerzo) → máximo 50. Orden descendente en el backlog.

Esquema de la tabla de backlog (este es el artefacto comprobable — 02-DOCS/shortform/backlog.md):

ididealínea de ganchoseñal de tendencia + fechaformatoduración objetivopuntuaciónestado
SF-001……… (2026-06-01, 7d↑)……42planeada

estado ∈ {planeada, grabando, publicada, descartada}.

Idea mala → buena:

  • Mala: "Haz un video sobre nuestra máquina de espresso." — un tema sin gancho, sin formato, sin tendencia, sin puntuación. No priorizable.
  • Buena: SF-007 | "La mentira del café de 4€" desglose de costes | gancho: servir café + en pantalla "tu cafetería te cobra un 900% de margen" | tendencia: formato recibo con voz en off, TikTok 7d↑, 3k Reels (temprana) 2026-06-01 | voz en off sin rostro | 18s | puntuación 45 | planeada — una apuesta defendible con un gancho que abre un bucle, una señal fresca fechada y una razón para guardar (la gente captura la pantalla del cálculo).

Fase 4 — Registra la apuesta

Cada idea que avanzas a grabando/publicada obtiene un archivo de hipótesis en 02-DOCS/shortform/experiments/<AAAA-MM-DD>-<slug>.md. El esquema y un ejemplo antes/después están en references/experiment-ledger.md.

La hipótesis es una oración falseable:

Hipótesis: tendencia recibo con voz en off + gancho "900% de margen" aumentará retención a 3s por encima de 60% para el tema precios de cafetería.

Luego deja los campos de resultado pendientes — resultado: pendiente | ret3s: __ | tasa_de_gancho: __ | compartidos: __ | guardados: __ | veredicto: __ — para completar después de que el video se publique. El siguiente ciclo lee estos veredictos en la Fase 1: una hipótesis confirmada se convierte en un patrón ganador; una falsificada se convierte en un patrón muerto. Por qué: registrar la apuesta pero nunca el resultado convierte el libro en un cementerio de suposiciones — el bucle solo aprende si el bucle de resultados se cierra.

Para hacer lint estructuralmente de un archivo de backlog o experimento emitido, apunta scripts/verify.sh hacia él (solo lectura): bash scripts/verify.sh 02-DOCS/shortform/.

Métricas que importan

Puntúa y juzga en base a estas, no en vistas brutas. Por qué: las vistas son rezagadas y manipularlas; estas son las palancas que el algoritmo realmente recompensa.

MétricaLecturaHecho fuente
Retención a 3s>60% = fuerte; <40% = mata el patrónhasta ~50% de caída en los primeros 3s; Reels con >60% de retención pueden superar en alcance a los de <40% por 5–10×
Tasa de gancho~28% es el promedio de formato corto de Meta; supéraloun gancho/corte rápido en los primeros 3s se correlaciona con ~72% más probabilidad de volverse viral
Compartidos + guardadosla moneda del descubrimiento — pondera en la puntuaciónel algoritmo recompensa el tiempo de visualización y los compartidos para la distribución
Tiempo de visualización por duraciónun 10s al 80% supera a un 60s al 30%optimiza la retención por duración, no la duración

Antipatrones

AntipatrónPor qué fallaHazlo en su lugar
Volcado de lluvia de ideas sin puntuacionesno priorizable; el usuario no puede decidir qué grabar primeroemite siempre la tabla de backlog priorizada con una puntuación por idea
Perseguir un sonido de tendencia solo de 30 díasel movimiento solo de 30 días a menudo significa que el sonido ya está muriendopondera las señales en aumento a 7 días; marca las de solo 30d como obsoleto
Volver a presentar un tema que el registro demostró muertoignora la evidencia negativa propia de la cuentaverifica los fracasos de la Fase 1 antes de puntuar; nunca presentes un fracaso comprobado
Hacer scraping de Creative Center para tendenciasviola los TdS, rompe el bucle, envía código frágilcaptura manual/asistida o API autorizada; cero comandos de scraping en artefactos
Puntuar por interés del tema, no por fuerza del ganchoun tema fascinante con los primeros 3s muertos igual fracasala fuerza del gancho tiene peso ×3; puntúa el primer fotograma primero
Registrar la apuesta pero nunca el resultadoel bucle nunca aprende; el siguiente lote vuelve a adivinardeja campos de resultado y complétalos; la Fase 1 lee los veredictos
Escribir el guión completo / códigos de tiempo aquícruza hacia video-shorts; enturbia el libro de ideasdetente en la línea de gancho + sonido elegido; entrega
Capturar una señal de tendencia sin fechala frescura no se puede puntuar; podrías informar un sonido muertocada señal lleva una fecha de primera vista o no entra en la 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`).

Skills relacionados