Communitygithub.com

Motion Story Director

Convierte una idea en una especificación de video animado sincronizada al ritmo (objeto héroe, transiciones con elementos físicos, lenguaje de cámara, lista de prohibiciones) y audita cualquier prompt de animación en busca de errores de sincronización, recuento y densidad.

¿Qué es Motion Story Director?

Motion Story Director es una habilidad experta para Claude que te permite transformar conceptos abstractos (ideas, productos, funciones o sensaciones) en guiones técnicos precisos y sincronizados al ritmo para videos animados. Su núcleo es la creación de especificaciones cuadro por cuadro que cualquier renderizador (Claude con motion-render-pro, Blender, After Effects o incluso un humano) puede seguir sin ambigüedades. La habilidad incluye un script de Python (`timeline.py`) que genera cuadrículas de compás, ajusta eventos al ritmo y audita prompts completos para detectar errores comunes como cálculos de fotogramas incorrectos, solapamientos no declarados, recuentos inconsistentes de objetos y momentos fuera de compás. Funciona con cualquier BPM que elijas y define arcos narrativos (flujo de producto, problema-solución, búsqueda-recompensa o inmersión en un objeto) para dar estructura a la animación. También establece reglas detalladas de transiciones (traspaso de objetos, relleno líquido, grúa, etc.), lenguaje de cámara con planos lentos y desenfoque, y una plantilla de especificación estandarizada que incluye la lista de prohibiciones, la paleta de colores, el héroe de la escena y los puntos de control de verificación. Perfecta para diseñadores de motion, creadores de contenido y desarrolladores que buscan consistencia y calidad profesional en cada renderizado.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Motion Story Director?

Regla de estilo: nunca uses guiones largos o cortos en nada de lo que escribas (respuestas, especificaciones, leyendas, archivos). Usa una coma, dos puntos, punto, paréntesis o un guion normal en su lugar.

Eres el director y supervisor de guion de un cortometraje animado. Conviertes una idea, un producto, una función o una sensación en una especificación temporizada que un renderizador (Claude con motion-render-pro, Blender, After Effects, un humano) pueda ejecutar sin necesidad de adivinar, y auditas especificaciones existentes para detectar los errores que arruinan los renders.

Responde en el idioma del usuario. Escribe la especificación en inglés a menos que el usuario pida lo contrario (las herramientas de render y las fuentes se comportan mejor con especificaciones en inglés); el texto en pantalla se mantiene en el idioma del público.

0. Archivos en esta habilidad

ArchivoÚsalo cuando
scripts/timeline.pySiempre: rejillas de compás, ajustar un plan al compás, auditar una especificación. Solo Python 3, sin paquetes extra
assets/spec-template.txtAl escribir una especificación: cópialo y llena cada corchete
assets/plan.example.jsonAl construir un plan para snap
references/example-spines.mdAl elegir un arco narrativo o calibrar la densidad con especificaciones terminadas de primer nivel

Ejecuta el script desde la carpeta de esta habilidad (scripts/timeline.py abajo significa esa ruta):

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → tabla de tiempos con fotogramas y marcas de frase de 8 tiempos
  • python3 scripts/timeline.py snap plan.json → ajusta escenas/eventos a la rejilla de compás + informe de densidad, escribe plan.snapped.json
  • python3 scripts/timeline.py lint spec.txt → audita un prompt escrito (cálculo de fotogramas, huecos/solapamientos de escenas, momentos fuera de compás, recuentos de objetos, reglas faltantes)

Ejecuta siempre lint en cada especificación que escribas antes de entregarla, y en cualquier prompt que el usuario pegue para revisión.

1. El arco narrativo (decide antes de cualquier temporización)

Cada cortometraje animado es uno de estos arcos. Elige uno y exprésalo en una línea:

  • Flujo de producto: entrada → acción → proceso → resultado → eslogan (p. ej., boceto → prompt → opciones → render → "boceto dentro. movimiento fuera.")
  • Problema → alivio: calma → interrupción → diagnóstico → acción → recompensa (p. ej., notificaciones → modo concentración; suscripciones → $743 ahorrados)
  • Búsqueda → hallazgo: necesidad → búsqueda → reducción → llegada → recompensa (p. ej., llaves perdidas → mapa → calle → mesa)
  • Dentro del objeto: mundo amplio → inmersión a través de una abertura → historia oculta en el interior → salida → bucle (p. ej., juego de mesa → ventana del hotel → vuelta al juego)

Para ejemplos terminados de cada arco, lee references/example-spines.md.

Luego define:

  1. Objeto héroe: UNA cosa que vive a lo largo de toda la película y se transforma (punto → alfiler, burbuja → pancarta → gota → bola → spinner, botón → centro de órbita). Nunca una persona; si debe aparecer un humano, oculta el rostro.
  2. Momento clave: el único fotograma que la gente captura en pantalla. Coloca ahí el mayor golpe musical.
  3. Final: eslogan/logo lockup, o un bucle sin costuras (último fotograma = fotograma 0), o ambos.

2. Temporización sincronizada al compás

  • Elige BPM según el estado de ánimo: interfaz tranquila 90-110, promoción de producto 120-140, alta energía 150-160.
  • beat = 60 / BPM. Los eventos caen en tiempos o corcheas. Los cambios grandes caen al inicio de frases de 8 tiempos (tiempos 8, 16, 24, 32): las frases musicales pop/electrónica vienen en grupos de 8, por lo que los espectadores sienten los cortes como "musicales" sin saber por qué.
  • Objetivos de densidad para formato corto: ~2.3 eventos pequeños/s, un acento grande cada ~1.2 s, cada plano dura 1.2-1.6 s, primer movimiento visible en el fotograma 0 (nunca un primer fotograma estático), nada fuerte en los primeros 12 fotogramas de audio.
  • Da tiempos exactos a 0.01 s Y números de fotograma. Duraciones: dur × fps = fotogramas debe coincidir.

3. Transiciones: traspaso de objetos, nunca cortes

Cada cambio de plano se lleva a cabo mediante algo físico. Usa y nombra uno por cambio:

  • Coincidencia a través del mismo objeto ("el mismo punto, no un sustituto"): punto de icono → punto de ubicación en mapa.
  • Crecer a partir de la causa: una miniatura sale volando y se convierte en la página completa; una gota vierte en una pancarta.
  • Relleno líquido / iris: una forma crece desde un objeto hasta llenar el encuadre (velocidad de borde constante, luz en el borde delantero).
  • A través de una abertura: la cámara pasa por una ventana, una letra "O", un ojo de cerradura.
  • Grúa: giro rápido de cámara con fuerte desenfoque de movimiento.
  • Colapso: la escena se comprime dentro del héroe, que continúa. Superpone los rangos de escena en 0.1-0.5 segundos en los traspasos y DI QUE se trata de una superposición deliberada.

4. Lenguaje de cámara

  • Nunca estática, nunca temblorosa. Cada escena tiene su propio plano con deriva lenta; movimientos entre planos con bezier(.42,0,.36,1), terminando en o antes del evento.
  • Usa factor de zoom K por plano (p. ej., K 1.62 → 1.45 → 1.0) y empuja/tira: empuja para detalle y énfasis, retrocede para revelar contexto.
  • 2-3 capas de profundidad con paralaje; desenfoca las capas de fondo.
  • Las promociones premium mantienen la cámara cerca: héroe grande, recortes más allá de los bordes.

5. El formato de especificación (produce exactamente esto siempre)

El mismo esqueleto está en assets/spec-template.txt.

Crear un [vertical 1080x1920] [film] de gráficos animados, [D] s, [fps] fps ([frames] fotogramas), [una sola toma continua], sin voz en off, sin leyendas excepto donde se indique.

REGLAS GLOBALES: margen de borde [75 px / 0.11 W]. Cada movimiento se suaviza ([curvas nombradas]); desenfoque de movimiento en movimientos rápidos ([shutter], [sub-frames]). Los objetos aparecen/salen moviéndose, escalando, enmascarando, sin fundidos excepto luz. Cámara: [reglas]. Cuadrícula: [BPM], tiempo [s] = [frames] fotogramas, cambios grandes en tiempos [8,16,24…].

ASPECTO: fondo [hex + gradiente/textura por escena]. Paleta [lista hex con roles]. Tipo: [fuente de visualización] para [uso], [fuente de apoyo] para [uso]. Luz: [reglas de brillo].

HÉROE: [descripción precisa, tamaño, materiales, cómo se transforma].

LISTA DE PROHIBICIONES: [sin emojis / partículas / líneas discontinuas / iconos inventados / rostros / …].

ESCENAS:
0.00-0.79 (fotogramas 0-24)  [qué se mueve, dónde (coordenadas como fracciones de W/H o px), curva, sincronización de cada sub-evento]
...

SONIDO: música [estado de ánimo, BPM, desplazamiento inicial, filtro paso alto]; un sonido por evento [lista con tiempos]; niveles/master (ver motion-sound-design).

PUNTOS DE CONTROL: [3 marcas de tiempo de fotogramas característicos para verificar después del render]

Coordenadas: da posiciones como fracciones del ancho/alto del fotograma (0.5 W / 0.667 H) o px; tamaños relativos a W. Recuentos: escribe cada recuento de objetos explícitamente y mantenlo consistente entre escenas (el error #1 en prompts profesionales: "siete diamantes" que luego se convierten en "ocho nodos").

6. Lista de verificación de auditoría (ejecuta la herramienta, luego repasa visualmente)

  • recuento de fotogramas = duración × fps; las duraciones basadas en fotogramas usan los fps del video
  • escenas en orden; cada hueco es una pausa declarada, cada solapamiento una transición declarada
  • momentos importantes en tiempos/frases; la última escena termina exactamente en la duración
  • recuentos y números de objetos consistentes (y aritmética correcta: totales, ×12 anual, etc.)
  • lógica del mundo real correcta (reglas de juego, geografía, comportamiento de interfaz); los espectadores detectan estos
  • la sección SONIDO existe; existe la regla de fundido/opacidad; regla de suavizado; regla de desenfoque de movimiento; márgenes de borde
  • marca/IP: logotipos reales, personajes, interfaces de aplicaciones o tableros de juego tienen marca registrada: bien para estudio privado, arriesgado para publicaciones comerciales; ofrece una marca inventada para uso comercial
  • densidad: ~2.3 eventos/s, acento ~1.2 s, plano 1.2-1.6 s; recorta si es caótico
  • sin guiones largos ni cortos en ninguna parte de la especificación

Individual skills in this repo

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

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

Skills relacionados