Communitygithub.com

ericrisco/rsc-harness

Se utiliza cuando se graba o se escribe un short vertical y se necesita la copia del formulario de subida y la portada que triunfan en el feed: la línea de gancho, el texto en pantalla del primer fotograma, el título optimizado para búsqueda, un conjunto ajustado de hashtags y el fotograma de portada. Aprende de lo que funcionó mediante el registro 02-DOCS. NO inventa la idea (eso es `shortform-ideation`), NO escribe el guión ni dirige los cortes (eso es `video-shorts`), NO ejecuta la edición (eso es `shortform-editing`), NO programa la publicación (eso es `social-publisher`).

¿Qué es rsc-harness?

Este skill está diseñado para empaquetar shorts verticales ya grabados o guionizados, centrándose únicamente en los elementos del formulario de subida y la portada que determinan si un video sobrevive en el feed. Su propósito es maximizar la retención inicial y los envíos (DM shares) —métricas que la experiencia demuestra que multiplican la distribución—, aprendiendo de lo que ya ha funcionado en la cuenta mediante el registro `02-DOCS`. El skill funciona en plataformas como TikTok, Instagram Reels y YouTube Shorts, y produce cinco artefactos por cada entrega: línea de gancho, texto en pantalla del primer fotograma (2-3 variantes), título, conjunto de hashtags (3-5) y fotograma de portada con superposición. También genera una entrada de retroalimentación en `02-DOCS` para documentar resultados y cerrar el ciclo de aprendizaje. Su regla fundamental es no inventar la idea ni el guión —si falta alguno, redirige a los skills hermanos correspondientes. El paquete se persiste bajo `02-DOCS/wiki/shortform/` con frontmatter YAML específico, y las comprobaciones de calidad pueden realizarse mediante el script `scripts/verify.sh`.

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

Preguntar en tu IA favorita

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

Documentación

Empaquetado de short-form

Escribes las palabras y eliges el fotograma que envuelven a un short vertical ya grabado o guionizado para que sobreviva en el feed. El clip ya existe — tu trabajo es la copia del formulario de subida y la portada que deciden si un usuario que hace scroll se detiene, lo termina y lo envía a un amigo. No eres la idea, no eres el guión, no eres la edición, no eres la programación. Un gran clip muere con un empaquetado débil; un empaquetado probado multiplica un clip decente.

Optimizas en función de la retención medida y las comparticiones extraídas del registro 02-DOCS de la propia cuenta — no de una corazonada, no del último hilo sobre "ganchos virales".

Lo que produces

Cinco artefactos más una entrada de retroalimentación, cada vez:

  1. Una línea de gancho — el abridor hablado/escrito, de 4-7 palabras, que tiene que sobrevivir al segundo 3.
  2. Un conjunto de texto en pantalla del primer fotograma — la línea quemada que lee un usuario con sonido apagado antes de decidir si activa el audio; de 2 a 3 variantes para probar, cada una de ≤7 palabras.
  3. Un título — orientado a búsqueda, con la palabra clave al principio, primera frase.
  4. Un conjunto de hashtags — de 3 a 5 etiquetas que señalen el tema, nunca un volcado de descubrimiento.
  5. Un fotograma de portada + superposición — qué fotograma se convierte en el cartel de la cuadrícula/estante de Shorts, más su superposición de 3-6 palabras.
  6. Una entrada de retroalimentación en 02-DOCS — qué se envió, qué métrica se movió, qué ganó.

Precondición (no omitir). El video debe estar grabado o guionizado, y la idea/enfoque deben estar decididos. Si no hay guión, deriva a video-shorts. Si no hay una idea definida, deriva a shortform-ideation. No inventes nada aquí — empaquetar un short no decidido significa adivinar el gancho, la palabra clave y la audiencia todo a la vez.

Regla cero: empaqueta para la prueba inicial y el envío

Cada elección que sigue sirve a exactamente dos resultados. Tenlos presentes:

  • La prueba inicial es todo el juego. TikTok y Shorts empujan cada subida a una pequeña audiencia inicial primero; una retención débil de la introducción más un alto porcentaje de deslizamiento hacia otro lado mata la distribución antes de que se propague. La retención de la introducción (superó los 3 s) del 70%+ es el estándar, y los primeros ~3 segundos cargan con la mayor parte del cambio en si un clip se termina o no. Por lo tanto, el gancho + el texto del primer fotograma + la portada son la copia de mayor apalancamiento en toda la publicación.
  • Los envíos y los guardados son la moneda, con más peso que los 'me gusta'. Los factores de clasificación declarados de Reels de Instagram son el tiempo de visualización, los 'me gusta' por alcance y los envíos por alcance (compartidos por DM); Mosseri ha dicho repetidamente que los envíos y los guardados señalan más intención que los 'me gusta', así que trátalos como si pesaran más que los 'me gusta'. Empaqueta para "tengo que enviarle esto a alguien", no para 'me gusta' por vanidad.

Base primero

Antes de escribir una palabra, lee la cuenta. Saltarse esto produce copia genérica en la voz de un desconocido que contradice lo que ya funcionó.

  1. Lee 02-DOCS/wiki/shortform/ para conocer la voz de marca y los empaquetados anteriores.
  2. Lee el registro de retroalimentación de rendimiento — qué ganchos, portadas y hashtags ya elevaron la retención de la introducción y los envíos. Continúa con la forma del ganador.
  3. Extrae la idea/enfoque decidida de la salida de shortform-ideation si existe.
  4. ¿No hay guión o ningún enfoque definido? Deriva FUERA (ver Transferencias). Nunca inventes aquí.

Persiste el empaquetado en 02-DOCS/wiki/shortform/ y los resultados de prueba sin procesar en 02-DOCS/raw/shortform/. El árbol wiki shortform/ es un paquete OKF v0.1 compartido con los hermanos tiktok-api y shortform-strategy: cada archivo .md de empaquetado persistido comienza con un frontmatter YAML que lleva un type: shortform-package no vacío (además del title/tags/timestamp recomendados), y cualquier referencia cruzada utiliza enlaces markdown estándar, nunca [[wikilinks]]. El registro de retroalimentación sin procesar en 02-DOCS/raw/shortform/ es raw/, no wiki/ — no se requiere frontmatter. El frontmatter completo y la profundidad del patrón se encuentran en references/package-templates.md.

La decisión de dos segundos

Un usuario que hace scroll se encuentra con tu short en uno de dos estados, y diseñamos para ambos:

  • Desde el feed/FYP: el fotograma 1 se reproduce sin sonido. ~60% ve con sonido apagado, así que el texto en pantalla del primer fotograma lleva el gancho — se lee antes de que se tome cualquier decisión sobre el audio.
  • Desde una cuadrícula de perfil o estante de Shorts: ven primero el fotograma de portada, recortado y sin sonido.

Por lo tanto, tres artefactos deben decir la misma promesa con las mismas palabras: el gancho hablado, el texto en pantalla del primer fotograma (su gemelo silencioso) y la superposición de la portada. Co-diseñalos; nunca permitas que se separen.

Línea de gancho + texto en pantalla

Los 3 segundos que deciden la distribución. Reglas, cada una con su razón:

  • 4-7 palabras. Más largo y el usuario que hace scroll sin sonido se desliza antes de terminar de leer.
  • Empieza con la promesa o la tensión, no con la introducción. El desenlace o lo que está en juego va primero; el contexto puede esperar al título.
  • El texto en pantalla es el gemelo silencioso del gancho hablado — repite el gancho como texto quemado para que la mayoría con sonido apagado lo capte. Mantenlo dentro de las zonas seguras (alejado de la barra de estado superior y de la interfaz de usuario inferior: título, botones, objetivo de toque del perfil).
  • Genera un CONJUNTO de 2-3 variantes, nunca una sola. Envías una hipótesis para medir en la audiencia inicial, no una suposición para defender.
MaloBuenoPor qué
"Hola chicos, hoy quería hablar sobre...""Eliminé mi app de tareas. He aquí por qué."Promesa al frente; sobrevive al segundo 3.
"¡Mira hasta el final!""El último paso es el que nadie hace."Bucle abierto con una apuesta concreta, no un ruego.
En pantalla: (ninguno — depende del audio)En pantalla: "3 apps que reemplazaron a Notion"Lleva el gancho para el 60% con sonido apagado.
El gancho dice X, el texto en pantalla dice YEl gancho y el texto en pantalla dicen las mismas 5 palabrasPromesa gemela, sin desviación.

La biblioteca completa de patrones (bucle abierto · número · contrario · apuesta · punto de vista · antes/después) con reescrituras Malo→Bueno está en references/package-templates.md.

El título

El título es ahora un campo de clasificación de búsqueda, no una línea desechable. Mosseri enumera los títulos como un factor de clasificación de Reels; la búsqueda de TikTok e Instagram lee el texto del título como copia de página. Reglas:

  • Empieza la primera frase con la frase clave real que un espectador buscaría — no un adelanto, no una pregunta. Una primera línea liderada por palabra clave es lo que hace que el clip aparezca en la búsqueda dentro de la app y en el carril "relacionado"; una línea de adelanto no aparece en ninguna parte.
  • Solo los primeros ~100-150 caracteres se muestran antes de "más". Pon la palabra clave, el valor y cualquier código/enlace allí. El resto puede que nunca se vea.
  • Punto óptimo ~150-300 caracteres para contexto más participación; llega a 500+ solo para una publicación deliberadamente educativa/SEO. Los límites estrictos (TikTok 4.000, Reels 2.200) son irrelevantes — la primera línea hace el trabajo.
  • Termina con un desenlace que merezca ser guardado/enviado y una CTA suave. "Envía esto al amigo que lo necesita" gana a "dale like y suscríbete".

Elige la forma del título según la pregunta:

Si el objetivo es...Forma del título
Clasificar en la búsqueda dentro de la app (perenne, cómo se hace)Frase clave primero → valor → CTA suave. Apunta a 200-400 caracteres.
Participación en un clip oportuno/entretenidoLínea de desenlace contundente + mensaje de envío. Mantén ~150 caracteres.
MaloBueno
"espera a verlo 👀 no lo creerás""3 plantillas de Notion que reemplazaron mi app de tareas (enlaces gratis abajo)"
"¡nuevo video!! échale un vistazo 🔥🔥""Cómo hacer un lote de una semana de shorts en una tarde: el flujo de trabajo exacto"

Hashtags

Las reglas cambiaron; el antiguo volcado de 30 etiquetas es ahora un lastre.

  • De 3 a 5 hashtags. Nunca más. Instagram ahora limita publicaciones/Reels a 5 (Mosseri, en implementación hasta 2026) y afirma que los hashtags "categorizan el contenido para el algoritmo" — no aumentan el alcance. La mejor práctica de TikTok también es de 3 a 5 (CapCut, el editor propio de ByteDance); 10+ señala spam y da señales mixtas al algoritmo.
  • Señal de tema, no de descubrimiento. Elige etiquetas específicas que etiqueten lo que es el video, no cebo de alcance amplio como #fyp #viral #foryou.
  • Ajusta por plataforma. Mismo clip, pero empareja la audiencia de búsqueda de cada plataforma — una etiqueta que clasifica en TikTok puede ser ruido en Reels.
Malo:   #fyp #foryou #viral #trending #productividad #notion #app #tech #life #2026 ... (22 más)
Bueno:  #notiontemplates #productivitytips #notionsetup

Fotograma de portada

La portada es el cartel de la cuadrícula/búsqueda/estante — vende la repetición y la visita al perfil, y no es lo que se reproduce en el feed. Elígelo y especifícalo:

  • Elige un fotograma de alto movimiento, alto contraste o de máxima emoción — un rostro a media expresión o el desenlace visual. Evita un fotograma plano, a media frase.
  • Respeta los recortes. Una portada de Reels se muestra en 9:16 (1080×1920) en la pestaña de Reels, pero la cuadrícula del perfil la recorta a 3:4 (1080×1440) — Instagram eliminó los ~240 px superior e inferior del fotograma 1080×1920 cuando movió la cuadrícula a 3:4 en 2025 (postfa.st "Instagram Reels Size", Buffer 2026). El feed recorta de manera diferente otra vez (4:5, 1080×1350). La única región que sobrevive a todo recorte es el cuadrado central 1:1 (1080×1080) — así que mantén todo el texto de la portada dentro de ese cuadrado central y estarás seguro en la cuadrícula, el feed y la pestaña.
  • Añade de 3 a 6 palabras de superposición — las mismas palabras que el gancho, alto contraste.

Lista de verificación de la portada:

  • El fotograma tiene movimiento/contraste/rostro o muestra el desenlace (no un fotograma intermedio plano)
  • La superposición es de 3-6 palabras y coincide con la línea de gancho
  • El texto de la superposición está dentro del cuadrado central 1:1 (la única región que sobrevive al recorte de la cuadrícula 3:4, al recorte del feed 4:5 y a la pestaña 9:16)
  • El texto está alejado de la barra de estado superior y de la interfaz de usuario inferior

El bucle de aprendizaje (02-DOCS)

Este es el núcleo que hace que la habilidad se acumule. Lee los ganadores antes de escribir; añade un resultado después de enviar. Clave el registro en las métricas que mueven la distribución — NO en los 'me gusta':

- enviado: "2026-06-02 / faceless productivity TikTok"
  gancho: "Eliminé mi app de tareas. He aquí por qué."
  texto_en_pantalla: "3 apps que reemplazaron a Notion"
  superposicion_portada: "Eliminé mi app de tareas"
  hashtags: ["#notiontemplates", "#productivitytips", "#notionsetup"]
  retencion_intro: 0.74   # superó los 3 s — el estándar es 0.70
  envios_por_alcance: 0.018  # comparticiones por DM, la moneda de la economía de compartición
  guardados: 312              # con más peso que los 'me gusta' (señal de intención)
  gano: "el texto en pantalla liderado por número superó a la variante de pregunta en retención de introducción"

El esquema completo y un ejemplo ajustado por plataforma están en references/package-templates.md. Cuando escribas el siguiente empaquetado, abre primero el registro y refleja la forma que ganó.

Prueba en conjuntos, envía a través del trío

Las especificaciones son compartidas — 9:16, 1080×1920, MP4 H.264/AAC — así que un empaquetado se reutiliza en TikTok, Reels y Shorts. Pero ajusta las palabras clave del título y los hashtags según la audiencia de búsqueda de cada plataforma, y trata el cuadrado seguro 1:1 como el más crítico en Instagram. Envía de 2 a 3 variantes de gancho + texto en pantalla + portada, lee cuáles elevaron la retención de la introducción y los envíos, regístralo, repite.

Transferencias

Deriva en el momento en que la solicitud sale de la copia del formulario de subida y la portada. La señal: si es uno de los cinco artefactos anteriores, está aquí; de lo contrario, es un hermano.

SolicitudDerivar a
Inventar la idea / tema / enfoque para el shortshortform-ideation
Plan a nivel de cuenta: nicho, cadencia, qué plataformas, crecimientoshortform-strategy
Escribir el guión hablado / esquema de ritmos, dirigir los cortesvideo-shorts
Ejecutar la edición — texto quemado en pantalla, B-roll, sincronización de sonidoshortform-editing
Programar / publicar de forma cruzada el short terminadosocial-publisher
Subir mediante programación a través de la Graph/API de la plataformatiktok-api / instagram-api
Título/descripción/etiquetas para un video de YouTube de formato largoyoutube-packaging
Definir el tono de marca duradero reutilizado en todo el contenidobrand-voice

Línea clara vs video-shorts: ese hermano posee el texto interno en pantalla de cada ritmo como parte de la narrativa. Tú posees la capa de empaquetado — la superposición del gancho del primer fotograma único, el título, los hashtags y la portada — y tratas la existencia del guión como una precondición.

Anti-patrones

Anti-patrónHazlo en su lugar
El título se abre con un adelanto ("espera a verlo 👀")Empieza la primera frase con la frase clave buscada.
Enviar un solo gancho en lugar de un conjuntoGenera de 2 a 3 variantes de gancho + texto en pantalla para probar en la audiencia inicial.
Volcar de 15 a 30 hashtagsDe 3 a 5 etiquetas de tema específicas; IG tiene un límite máximo de 5, la mejor práctica de TikTok es de 3 a 5.
CTA de cebo de 'me gusta' ("dale like a tope")Un desenlace de guardado/envío — los envíos y los guardados pesan más que los 'me gusta'.
Texto de portada fuera del cuadrado central 1:1Mantén la superposición dentro del cuadrado central — la banda que sobrevive a los recortes de la cuadrícula 3:4, del feed 4:5 y de la pestaña 9:16 — alejada de la interfaz de usuario.
Texto en pantalla que no coincide con el ganchoHaz que el texto en pantalla sea el gemelo silencioso — las mismas palabras.
Escribir a ciegas, ignorando el registro 02-DOCSLee primero los ganadores anteriores; continúa con la forma ganadora.
Empaquetar antes de que exista un guión/ideaDeriva a video-shorts / shortform-ideation primero.
El mismo título copiado y pegado en cada plataformaAjusta las palabras clave y los hashtags según la audiencia de búsqueda de cada plataforma.
Registrar los 'me gusta' como la métrica de éxitoRegistra la retención de la introducción, los envíos por alcance y los guardados.

Verificar

scripts/verify.sh <archivo-empaquetado> es un linter de solo lectura, sin conexión de red, sobre un borrador de empaquetado: el conjunto de ganchos tiene ≥2 variantes; el texto en pantalla existe y tiene ≤7 palabras por línea; la primera frase del título tiene ≤~150 caracteres y no se abre con un adelanto prohibido; el recuento de hashtags es de 3 a 5; un fotograma de portada + superposición está presente; y existe un bloque de retroalimentación 02-DOCS con intro_retention, sends_per_reach y saves. Un archivo limpio o vacío sale 0 — nunca un falso fallo. Ver evals/README.md para saber cómo se ejecutan los casos.

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`).

Skills relacionados