Communitygithub.com

motion-qa

Revisa los fotogramas de un carrete de papercut contra el Style DNA y el storyboard. Genera hojas de contacto en varios momentos, ejecuta la lista de verificación completa y luego escribe el resumen de entrega. Úsalo para 'QA del carrete', 'revisa que mis escenas se vean como papel', 'esto está listo para publicar'.

¿Qué es motion-qa?

La habilidad **Papercut QA** automatiza la revisión visual de animaciones en papel recortado (papercut). Compara fotogramas clave contra el Style DNA del proyecto y el storyboard, verificando no solo estilo (grano, sombras, bordes de papel) sino también elementos narrativos como banners, leyendas, sincronización de voz, humor y densidad visual. Se ejecuta por escena durante la construcción y sobre el carrete completo antes del render final. Está diseñada para proyectos que usan Remotion con Python (numpy, Pillow) para generar hojas de contacto, y también soporta proyectos kyfram mediante su propio script `qa.sh`. La salida principal son hojas de contacto en `out/qa/` más un informe detallado de cada escena. Los fallos se corrigen volviendo a la escena o al kit en la biblioteca, y se finaliza con un render limpio. La habilidad enfatiza la eficiencia: no más de dos rondas de corrección por escena, y recomienda abrir solo los archivos necesarios para ahorrar tokens.

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

Preguntar en tu IA favorita

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

Documentación

Papercut QA

Compara fotogramas por estilo, no por contenido, contra el Style DNA y el storyboard. Ejecútalo por escena mientras construyes y una vez sobre el carrete completo antes del render final.

Preflight

  • Instalación: Estándar o Completa. Los fotogramas necesitan un proyecto andamiado con Remotion, y las hojas de contacto necesitan Python con numpy y Pillow ($MOTION_PY). Piezas faltantes: ./install.sh --doctor, luego motion-setup.
  • Un proyecto kyfram no necesita Remotion: invoca la habilidad kyfram antes de inspeccionar o arreglar la salida de escenas Kyfram. qa.sh extrae sus fotogramas de los segmentos de escena en caché (core/tools/kyfram_qa.py), así que renderiza una vez con core/tools/render.sh antes del QA. Todo lo siguiente aplica sin cambios.
  • Biblioteca: $MOTION_LIB, o la línea MOTION_LIB= en ~/.config/motion-explainer/config.env, o preguntar una vez.
  • Lee primero: Style DNA en $MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md sección 2, y la hoja de fondo style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg. Cada imagen cuesta aproximadamente 0.7-1.5k tokens, así que abre solo lo que necesite el paso.
  • Para densidad, $MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md ("Estadísticas de ritmo" al final): las escenas promedian 2.8 s, 2-4 eventos visuales discretos por escena, uno cada 0.4-0.8 s en una palabra acentuada, una nueva página de leyenda aproximadamente cada 0.6 s. Copia la densidad, no el contenido.

1. Renderizar fotogramas

Desde la carpeta video/ del proyecto:

$MOTION_LIB/core/tools/qa.sh NOMBRE DESDE-HASTA CADA [ESCALA=0.3] [COLS=9]
  • Usa 4-6 marcas de tiempo por revisión. Para una escena, CADA es aproximadamente su longitud en fotogramas dividido entre 4. Omite DESDE-HASTA para el carrete completo y aumenta CADA.
  • La salida es out/qa/NOMBRE_0.jpg (y _1, _2 para rangos más largos), como máximo 45 fotogramas por hoja. Lee la hoja; mantén las hojas pequeñas.
  • Un comando de QA por escena, y nunca dos renders a la vez. Mantén las correcciones en dos rondas por escena.
  • Revisa contra el storyboard: el fotograma 0 de la escena, sus eventos clave en sus palabras, nada recortado, nada cubriendo el banner o las bandas de leyenda.

2. Lista de verificación

  • Cada objeto se lee como papel: grano, borde áspero, sombra paralela, sombreado de piezas apiladas, sin contornos ni degradados.
  • La cámara del mundo se mueve suavemente. Solo el banner y las etiquetas hierven (escalonado, sutil).
  • El banner está fijo en posición y pegado, 3-7 palabras, un hecho cada uno, nunca repite la VO. Los banners solos se leen como una hoja de datos.
  • Cada set ilustra una palabra concreta en su línea de VO, los números son accesorios físicos, y hay un set de referencia antes del CTA.
  • Cada número y etiqueta de UI remite a la lista de hechos. El guion tiene al menos una limitación honesta y una pila de características de exactamente tres.
  • Leyendas: una etiqueta por palabra, inclinada, apareciendo al inicio, páginas de 1-3, en la banda 68-80%, nunca sobre una cara.
  • Saturación solo en personajes, leyendas y señales.
  • Un evento visual en cada palabra acentuada, con movimiento ambiente siempre activo.
  • Cortes en cambios de banner (sets 1.5-3 s en tours y noticias, hasta 5 s en un compás metafórico), 20% inferior despejado.
  • El bloque HOOK (SAY / WRITE / SHOW / ALIGN) está en pantalla exactamente como está escrito: el fotograma 0 muestra el momento SHOW en mitad de la acción con el título WRITE sobre él, y la primera línea de VO es SAY.
  • Cada escena tiene un movimiento de cámara, como máximo un giro de página o rasgadura, un tirón de cinta o látigo hacia el CTA, y cada transición tiene su SFX.
  • Pase de humor visible en pantalla: un formato en todo el video, un accesorio de disfraz por idea, un compás de lucha, el accesorio del fotograma 0 regresa cambiado en el set del CTA, y cada gag se lee en menos de 1 s y nunca cubre el banner, las leyendas ni el número clave.
  • El vocabulario en la VO y los banners coincide con el nivel de audiencia en SERIES.md.
  • La voz en off, las leyendas y los eventos están sincronizados (revisa en el Studio cada corte).

Para un elemento fallido, arregla el archivo de la escena (o el kit en la biblioteca, nunca src/lib/ en el proyecto) y vuelve a ejecutar la escena. Reconstruye una escena con motion-build.

3. Entregar

Abre la vista previa del Studio, lista las escenas con tiempos y di qué es provisional: voz, música, SFX, activos. Si la voz es provisional, di cómo volver a ponerle voz (motion-voice). Después de publicar, los números van a motion-strategy para la autopsia.

Pase de principios

Revisa una escena a 5 fps y verifica contra $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md: anticipación antes de cada movimiento grande (2), todo suavizado (6), algo rezagado después de impactos (5), un accesorio focal (3), un compás exagerado (10), sombreado apilado y una sombra consistente (11).

Transferencia

Las correcciones vuelven a motion-build (escena o sonido) o motion-voice (sincronización). Un pase limpio termina el carrete: renderiza con $MOTION_LIB/core/tools/render.sh cuando el usuario lo pida.

Individual skills in this repo

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

bang-motion

Render a reel in the Bang Motion style: high-end cinematic motion graphics with a multi-layer glowing-horizon background, floating colour-mesh blobs, living film grain, frosted-glass UI cards, editorial kinetic typography, a breathing camera, and anti-PPT pacing. Use when the user says cinematic motion graphic, promo opener, product launch reel, kinetic typography, SaaS product tour, glassmorphic UI, anti-slides, or asks for a video that moves like footage instead of a deck. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin meren...

isometric

Render a reel in the Isometric style: calm precise product line art in 2:1 dimetric isometric on a white or dark ground, drawn only with constant 2px hairlines, white-filled faces so nearer objects hide farther lines, rounded slabs with visible thickness, stacked layers, repeated-part grids, and one tiny dark accent per frame. Use when the user says isometric, product line art, technical illustration, exploded hardware view, or asks for a clean documentation-grade diagram look.

motion-build

Build and render a papercut episode from a storyboard with the library. Scaffolds the project, builds scenes with parallel agents, assets and audio, renders the mp4, then harvests reusables. Use for "build the reel", "scaffold an episode", "rebuild scene 4", "render it".

motion-explainer

Make a papercut reel, video or explainer end to end. Short vertical (9:16) cut-paper explainers from a link (repo, product page, announcement), idea to mp4. Also routes partial asks to the stage skills and hands out the style prompt for other tools.

motion-script

Turn a link into a papercut reel script. Researches a sourced facts list, writes the 75-95 word script on the 10-beat spine, a banner fact track, a staging table with one set per banner, and the humour pass. Use for "write the script", "research this repo for a reel".

motion-storyboard

Storyboard a papercut script before any code. Writes the Camera / Cut table, one block per scene with frame-level events on each stressed word, the SFX plan and the proof beat. Use for "storyboard this script" or "plan the camera moves and cuts".

motion-voice

Voice a papercut reel and time it to the picture. Three paths, local Qwen3-TTS, your own recording or another TTS, or a placeholder voice. Covers delivery rules, voice.json, captions and scene timing. Use for "set up the voice", "re-voice this", "time the script".

papercut

Render a reel in the Papercut style: layered construction paper brought to life with paper grain, torn edges, stacked shade strips, drop shadows, rigid cut-out animation, a slow camera push, taped headline banners and word-by-word torn-tag captions. Use when the user says cut paper, papercraft, paper cutout, paper collage, construction paper, or asks for the default handcrafted explainer look.

Skills relacionados