Communitygithub.com

suntay44/motionable

Pipeline interno de motionable (modo plan, aprobación, escenas, música, crítica, render). Comienza con /motionable:scratch, :website o :project en su lugar.

¿Qué es motionable?

Este skill define el pipeline completo de producción cinematográfica para motionable, un estudio de animación AI-driven. Permite a un agente (como Claude Code) pasar de hechos sobre un producto a una película terminada, siguiendo un flujo estructurado: modo plan, aprobación, construcción, revisión y entrega. Funciona principalmente en Claude Code (plugin), pero su estructura de scripts y archivos markdown podría adaptarse a otros entornos. El skill es útil para equipos de marketing o creadores de contenido que necesitan producir videos promocionales únicos y consistentes, basados en evidencia del producto y no en plantillas genéricas. Se apoya en documentos como PLAN.md, ENGINE.md y checklist.md, y usa scripts Bash para generar y verificar escenas, música y críticas. Al final, entrega el video renderizado junto con recomendaciones para variantes y pruebas A/B.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

Preguntar en tu IA favorita

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

Documentación

motionable: make

Llegas aquí con hechos sobre un producto (cada uno con una fuente), las respuestas del usuario, rutas de imágenes, colores y notas sobre su personalidad. Tu trabajo es una película terminada que se sienta como este producto, y como ninguna otra película en el estudio.

ROOT es la raíz de motionable: ${CLAUDE_PLUGIN_ROOT}. Si eso no se expande, usa la carpeta dos niveles arriba de la ruta real de este archivo (realpath), que contiene engine/ y scripts/.

Lee ROOT/PLAN.md (modo plan), ROOT/ENGINE.md (los ingredientes), ROOT/rules.md (reglas estrictas) y ROOT/checklist.md (crítica) antes de planificar. ROOT/examples/owly/ muestra cómo se ve el trabajo terminado. Nunca copies su apariencia, sonido o estructura: es una dirección entre infinitas.

1. Crear la película

  • Dónde: las películas viven en la carpeta actual (normalmente el estudio del usuario para videos promocionales), como <slug>/.
    • Si la carpeta actual es el repositorio del producto, usa motionable/<slug>/ en su lugar.
    • Nunca escribas dentro de una carpeta de producto proporcionada a /motionable:project.
    • Si <slug>/ existe, pregunta: ¿hacer una nueva versión (<slug>-2/) o continuar esa película?
  • Crearla: ejecuta bash ROOT/scripts/new.sh <film> "<Nombre del producto>". Copia el motor en la película y escribe las plantillas.
  • Activos: copia las imágenes en <film>/assets/ con nombres claros (logo.png, screen-home.png…). Un archivo de fuente de marca, si el usuario lo tiene, va en assets/fonts/.

2. Modo plan (interno: sin comando, sin menú de estilo)

Sigue PLAN.md de principio a fin:

  1. Tablero de evidencia y personalidad.
  2. Historia: promesa, momento emblemático, 3 ganchos → 1.
  3. Cada dial ajustado, cada uno con su razón.
  4. Singularidad frente al estudio: lee el DIRECTION.md de las otras películas › Huella digital. Las películas hechas antes de v0.2 no tienen ninguna; trátalas como house de 120 BPM en La menor con titulares alineados a la izquierda sobre una tarjeta.
  5. Escribe DIRECTION.md y SCRIPT.md al tempo elegido.

No le pidas al usuario que elija un estilo. La dirección viene de la evidencia.

3. Una aprobación

Muestra el tratamiento de 4 líneas (Sensación · Sonido · Apariencia · Momento emblemático) y una cuadrícula de tiempos compacta (tiempo · imagen · palabras · unión). Luego pregunta, con AskUserQuestion si está disponible (si no, en el chat):

  1. El plan: aprobar, o cambiar algo.
  2. Ilustraciones: "¿Debería dibujar ilustraciones para esta película?" Sí, ilustrarla / Unos pocos acentos / No, solo capturas de pantalla y tipografía. Recomienda una con una razón (PLAN.md §5).
    • Dibujarlas es gratis: Claude escribe SVGs.
    • Solo si la sesión tiene una herramienta de generación de imágenes conectada, añádelo como opción, y di que puede costar dinero.

No escribas código de escena antes de la aprobación. Un cambio aquí es barato.

4. Construir

  1. Ilustraciones (si sí): escribe los SVGs en assets/drawn/ en los colores de la marca y un grosor de línea (ENGINE.md › Ilustraciones dibujadas). Mira cada una renderizada en una hoja, y redibuja cualquier cosa torpe.
  2. scenes/Film.swift: reemplaza el esqueleto por completo. Cada valor proviene de DIRECTION.md y SCRIPT.md:
    • los tiempos van en enum T;
    • clips y uniones van en un Reel;
    • las pantallas pasan por las llamadas de encuadre (nunca recortadas en un cuadro fijo);
    • el momento emblemático se redibuja para animarse exactamente como la interfaz de usuario real. Mide primero dónde se encuentra: bash ROOT/scripts/inspect.sh <captura de pantalla> find <su color> (o row, column, pixel) da anillos, barras y bordes de texto exactos.
    • Elementos personalizados que la dirección necesita van en sus propios archivos scenes/*.swift.
  3. Sonido: la Recipe (Receta) de la dirección + Sections (Secciones) mediante s.compose, más un s.cue para cada evento de imagen, usando los sonidos emblemáticos.
  4. Verifica que compile: bash ROOT/scripts/run.sh <film> sheet (sin tiempos: la película completa más cada unión). Corrige errores de compilación (ENGINE.md › Problemas comunes).

5. Borrador, corregir, luego mostrar al usuario

Trabaja en borradores, y nunca hagas bucles infinitos:

  1. Borrador 1 es la primera compilación completa: escenas, música y cada cue. Revísalo desde la propia película (los pasos a continuación); no necesitas un archivo de video para eso. (run.sh <film> draft renderiza un MP4 pequeño y rápido si el usuario quiere un adelanto temprano.)
  2. Autorevisión: una pasada, y cada verificación.
    • run.sh <film> check: cada ✗ es una corrección obligatoria. Mantén la línea más tiempo, comiénzala antes, recorta palabras, o elimina la línea. Una línea escrita necesita su tiempo de escritura más su tiempo de lectura. Actúa también según su consejo ⚠ (fotograma 1, ritmo) a menos que DIRECTION.md diga por qué no.
    • run.sh <film> sheet: puntúa cada categoría en checklist.md, y corrige cualquier cosa por debajo de 8. Mira a tamaño completo los stills del gancho, el momento emblemático y la tarjeta final: ¿la UI es legible?, ¿algo choca?, ¿cada esquina del fotograma está haciendo algo o deliberadamente vacía?
    • Lo que los espectadores castigan (RESEARCH.md › verificación comunitaria): UI demasiado pequeña para leer, rebote en cosas grandes, tomas de una sola duración, música que suena a stock, un momento de logo lento.
    • run.sh <film> audio, luego bash ROOT/scripts/compare.sh <film>: si otra película es demasiado similar, cambia la receta por una razón.
    • Recorre toda la película: run.sh <film> sheet $(seq 0.5 1 <duración>) (un fotograma por segundo). Busca lo que los stills individuales ocultan: una escena que se vacía, un ritmo sin movimiento, una unión que choca, una línea que aparece justo cuando la escena se va.
  3. Borrador 2. Corrige todo lo encontrado en un lote, luego ejecuta check y sheet de nuevo.
    • Si algo aún falla, permite una pasada de corrección más como máximo.
    • Si aún falla después de eso, no continúes: informa al usuario qué queda y por qué.
    • Mantén un breve registro de críticas en SCRIPT.md: qué cambió y por qué.
  4. Renderiza el archivo real: run.sh <film> video, aproximadamente 45 s por 30 s.
  5. Muéstralo y pregunta (AskUserQuestion si está disponible). Envía el MP4, el tratamiento de 4 líneas y el registro de críticas, luego haz 3–4 preguntas dirigidas sobre este corte. Cada una necesita una opción recomendada, y "Otro" permite al usuario decir cualquier cosa:
    • Ritmo: se siente bien / más lento, menos líneas / más rápido, más impacto.
    • Sonido: mantenerlo / más energía / más calmado / diferentes instrumentos.
    • Gancho: mantenerlo, o el más fuerte de los otros dos candidatos de gancho del modo plan, nombrado.
    • Final: mantenerlo / un final seguro para lanzamiento (por ejemplo, sin insignia de Descarga antes de que la app esté en vivo) / añadir el precio.
  6. Revisa una vez por ronda de respuestas, volviendo a ejecutar check, audio y compare, luego muestra el nuevo corte. Después de dos rondas del usuario, ofrece detenerte o continuar; el usuario decide.

6. Almacenar insignias (solo si el producto está en vivo)

  • App Store en vivo y el usuario quiere una insignia: pide permiso para descargar la insignia oficial de Apple (aproximadamente 11 KB, negra, SVG en inglés; URL en rules.md) en assets/.
    • Dibújala con drawAppStoreBadge, estática y nunca animada; el énfasis viene de glowRing.
    • Si el usuario insiste en animarla, explica la regla de Apple una vez. Si aún la quieren, haz que sea una variante separada, claramente nombrada.
  • Google Play: su insignia solo si la app está en vivo allí y el usuario aprueba la descarga. De lo contrario, como máximo una línea de texto plano, y solo si es verdad.

7. Entregar

Con cada corte que muestres, incluye:

  • el tratamiento en unas pocas líneas;
  • lo que la autorevisión corrigió;
  • el resultado de la comparación y el veredicto de check;
  • las afirmaciones a verificar antes de publicar;
  • cómo cambiarlo: editar SCRIPT.md o DIRECTION.md, o simplemente decirlo.

Después de que el usuario esté satisfecho, ofrece las siguientes cosas útiles:

  • un corte de 15 s, u otro formato (1:1, 16:9);
  • variantes de gancho para una prueba A/B: la misma película abierta con los otros dos candidatos de gancho del modo plan;
  • un final seguro para lanzamiento (sin "Descargar" antes de que la app esté en vivo);
  • una versión solo de efectos (run.sh <film> video effects), para publicar con un sonido de plataforma o una pista con licencia.

Individual skills in this repo

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

Skills relacionados