Communitygithub.com

motion-script

Convierte un enlace en un guion completo para reel de papercut. Investiga una lista de hechos, escribe el guion de 75–95 palabras sobre el esqueleto de 10 tiempos, una pista de banners, una tabla de puesta en escena con un escenario por banner y el pase de humor.

¿Qué es motion-script?

Este skill genera automáticamente un guion para reel de papercut a partir de un enlace. Primero investiga hechos y capturas de pantalla de la fuente para crear una base verificable (`research/facts.md`). Luego, según el modo elegido (drop de código abierto, lanzamiento de noticia o truco de función), escribe un guion de 75–95 palabras en un esqueleto de 10 tiempos, con voz en segunda persona, contracciones y cláusulas cortas. Simultáneamente produce una pista de 10–18 banners en mayúsculas (hechos duros que no repiten la voz en off) y una tabla de puesta en escena que asigna un escenario físico, una propiedad héroe y una interacción de producto a cada banner. Finalmente aplica un pase de humor con un gag por banner, un momento de mascota sufriendo y un accesorio que regresa. El resultado se escribe en `narration/script.json` y en `STORYBOARD.md`, listo para pasarlo al siguiente skill `motion-storyboard`. Es útil para creadores de contenido que usan herramientas como Claude Code, Cursor o Codex y quieren automatizar la escritura de reels virales con un estilo consistente de papercut.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boytegar/motion-skills/tree/HEAD/skills/motion-script

Preguntar en tu IA favorita

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

Documentación

Guion papercut

La investigación, el guion, la pista de banners, la puesta en escena y los gags se escriben juntos, porque cada uno alimenta a los demás. El sistema completo, con el banco de frases y dos ejemplos escenificados, está en references/storytelling.md. Banco de gags y formatos: references/comedy.md.

Cada tiempo ejecuta tres pistas que hacen trabajos diferentes:

  • Voz en off (mostrada como etiquetas de subtítulos): cuenta la historia, informal y en segunda persona, cambia cada frase.
  • Banner: añade el hecho duro, número o advertencia honesta que la voz en off omite, cambia cada 1,8–3 s.
  • Escenario: literalmente ilustra un sustantivo concreto de la voz en off, con la interfaz de producto haciendo la demo, cambia con el banner.

Pre-vuelo

  • Instalación: Mínimo es suficiente. Resuelve $MOTION_LIB solo si quieres la hoja de fondo (style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg) al elegir escenarios. Cada imagen cuesta aproximadamente 0,7–1,5k tokens, así que abre solo lo que el paso necesite.
  • Necesita el BRIEF al inicio de episodes/NN-slug/research/facts.md y el bloque HOOK al inicio de episodes/NN-slug/video/STORYBOARD.md. Si falta uno: ejecuta primero motion-strategy o motion-hook.
  • La investigación necesita fetch web o búsqueda, y cualquier herramienta de navegador para capturas de pantalla. Sin ellos, pide al usuario capturas y hechos.

1. Investigación y UI aproximada

  • Recopila hechos de la fuente con una fuente para cada uno: nombre, fabricante, números, precio, requisitos, limitaciones, números de competidores. Marca cualquier cosa incierta.
  • Toma las pantallas clave (2–4), etiquetas reales y texto de botones, el color de acento y las imágenes principales. El video reconstruye una versión aproximada de la UI como accesorios de papercut, no una grabación de pantalla (references/storytelling.md sección 5).
  • Confirma el encuadre de rol desde el BRIEF. Nunca inventes el comportamiento del producto. Consulta la nota de encuadre de rol en $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md.
  • Escribe la lista en research/facts.md debajo del BRIEF. Cada número en el guion, banners y UI debe remitirse a ella.

2. Elige el modo

ModoCuándo
Drop de código abiertoUna alternativa gratuita o local a un producto de pago
Lanzamiento de noticia / vale la penaUn nuevo nivel, modelo o función de pago de una gran empresa
Desbloqueo de función / tutorialUn ajuste oculto o comando que cambia cómo funciona una herramienta

Fórmulas de gancho y el medio de cada modo: references/storytelling.md sección 6. Aplica la actualización del gancho: abre la brecha y la apuesta, no la noticia.

3. Guion sobre el esqueleto

Escribe 75–95 palabras para 22–30 s, aproximadamente 3,5–4 palabras por segundo, dentro del formato elegido, con un nuevo escenario cada 1,5–3 s. Los 10 tiempos:

  1. Gancho (0–3 s), ya fijado por motion-hook
  2. Prueba o tensión
  3. Reencuadre ("Así que, en lugar de..., puedes...")
  4. Revelación del nombre ("Se llama...", nunca antes del gancho)
  5. Cómo funciona, una demo concreta
  6. Escalada ("Y X es solo el comienzo, porque..." más una pila de exactamente tres)
  7. Pico ("Y mira esto:" más el número más grande)
  8. Contra (el contrapunto honesto)
  9. Remate ("lo que significa...")
  10. Llamada a la acción ("Menos mal que hice [obsequio]. Para el enlace, comenta PALABRA_CLAVE").

Acorta los tiempos en lugar de acelerar la voz. Reglas:

  • Segunda persona, contracciones, cláusulas cortas unidas por "y", "porque", "lo que significa". Vocabulario al nivel de audiencia en SERIES.md.
  • Nombra una gran marca en la primera oración, incluso cuando el tema sea otra cosa.
  • Cada número es concreto y tiene fuente. Una pila de funciones, siempre tres elementos.
  • Al menos una limitación real, en la voz en off o en los banners. La palabra clave de la CTA es una palabra corta vinculada al tema.
  • La última línea repite la palabra clave o número del gancho, luego da la palabra clave.

Escríbelo en narration/script.json como [{"id": "l1_hook", "text": "..."}, ...], una línea por oración o grupo de cláusulas. La línea l1_hook es SAY del bloque HOOK. Marca la o las dos palabras en las que se apoya cada línea (el número, la palabra sorpresa, el veredicto) en la tabla de puesta en escena; motion-voice las usa.

4. Pista de banners

10–18 banners, 3–7 palabras, TODO EN MAYÚSCULAS, un hecho cada uno, aproximadamente uno cada 2–3 s. Nunca repiten la voz en off: leídos solos son una hoja de hechos. Incluye una estadística titular, una traducción de precio, un hecho de credibilidad, disponibilidad, al menos una advertencia honesta, al menos un hecho de confianza o seguridad, afirmaciones de funciones, al menos un contraste con competidores, y un banner de rango/decisión antes de la CTA. Tipos y ejemplos: references/storytelling.md sección 3.

5. Tabla de puesta en escena

Una fila por banner, escrita en STORYBOARD.md debajo del bloque HOOK:

t (s) | Palabras de VO debajo | BANNER | ESCENARIO (habitación + color de fondo) | PROP HÉROE (un juego visual del sustantivo concreto de la VO) | MOMENTO UI DEL PRODUCTO | ACCIÓN DEL MASCOTA y accesorio de vestuario | GAG

  • Un nuevo escenario por cada banner, colores de fondo rotando. El escenario ilustra una palabra de la línea de VO, no el banner.
  • Los números se convierten en accesorios físicos: carteles de precio, balanzas, muros multiplicadores, indicadores, medidores, carreras. Los competidores aparecen como tarjetas clavadas, nunca como el héroe.
  • La mascota es el representante del espectador y reacciona. La UI del producto es una reconstrucción aproximada en un monitor o portátil de papel con interacciones falsas.
  • Un callback a un escenario anterior antes de la CTA. El escenario de la CTA muestra un cuadro de comentarios escribiendo la palabra clave.
  • motion-storyboard añade las columnas de cámara y transición.

6. Pase de humor (después del guion, antes de que la puesta en escena sea definitiva)

Añade la columna GAG. La voz en off se mantiene seria; solo la imagen es tonta.

  1. Un formato para todo el reel.
  2. Un gag por banner que representa el punto, de references/comedy.md.
  3. Un accesorio de vestuario por idea. El accesorio propio de la mascota se queda puesto y se añade uno encima.
  4. Un tiempo de mascota sufriendo, en la línea de contra.
  5. Un accesorio en el fotograma 0 que vuelve cambiado en el escenario de la CTA (ME VOY se convierte en GRATIS).
  6. Un momento de fondo absurdo sin explicación.
  7. Como máximo un meme, reconstruido en el estilo propio de la serie, nunca un clip real, foto fija o audio.

Ningún gag puede tapar el banner, los subtítulos o el número clave, y cada uno debe leerse en menos de 1 s.

Compuerta

  • 75–95 palabras, 22–30 s, una limitación honesta, una pila de exactamente tres.
  • Cada número y banner remite a facts.md; los banners solos se leen como una hoja de hechos.
  • La última línea repite la palabra clave o número del gancho.
  • Pase de humor hecho: accesorio por idea, un tiempo de sufrimiento, un accesorio que regresa, un momento absurdo, como máximo un meme.

Entrega

El siguiente es motion-storyboard. Lee narration/script.json y el bloque HOOK y la tabla de puesta en escena en episodes/NN-slug/video/STORYBOARD.md. Para una ejecución solo de guion, detente aquí y entrega esos archivos al usuario. El prompt de storytelling para copiar y pegar para otra herramienta está en references/storytelling.md sección 7.

Individual skills in this repo

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

Skills relacionados