Communitygithub.com

jayfirke/motion-studio

Verificar, capturar vistas previas, renderizar borradores y verificar un proyecto de video en este espacio de trabajo, luego escribir VERIFY.md. Usar antes de mostrar un borrador al propietario, antes de cualquier renderización final, o cuando pregunten si un video está listo.

¿Qué es motion-studio?

Esta habilidad automatiza el proceso completo de revisión de calidad de proyectos de video basados en motion design. Está diseñada para ser utilizada antes de mostrar un borrador al cliente o antes de un render final, garantizando que el video cumpla con estándares técnicos y creativos. Es compatible con herramientas como HyperFrames, Remotion, Diffusion Studio, y otras basadas en Node.js. El flujo incluye chequeos estáticos (lint, TypeScript, verificación de escenas), captura de imágenes en puntos clave (snapshots), un renderizado de borrador con calidad baja, medición de sonoridad (LUFS), y un bucle de crítica donde se evalúan aspectos como hook, legibilidad, motion, composición, profundidad, marca, sincronización de audio y pulido. Cada ronda de crítica identifica los 3 peores elementos, los corrige y repite hasta que todas las puntuaciones sean ≥ 8 tras al menos 3 rondas. Finalmente, se genera un archivo VERIFY.md con todos los comandos ejecutados, resultados, rutas de snapshots, mediciones y tabla de crítica por ronda, y se solicita la aprobación del propietario para proceder con el render final, sin ejecutar nunca dos renders simultáneamente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/motion-render-review

Preguntar en tu IA favorita

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

Documentación

motion-render-review

  1. Lee el archivo BRIEF.md y SHOTLIST.md del proyecto.
  2. Verificaciones estáticas: HyperFrames npx [email protected] lint y check (0 errores requeridos); Remotion y video-shotcraft npx tsc --noEmit; motion-reel node scripts/render.mjs --verify --all; Diffusion Studio diffusion check <sceneId>; onetake verify_promo.py.
  3. Capturas (snapshots) en el punto medio de cada escena y en cada corte −0.1 s / +0.2 s (hyperframes snapshot --at …, remotion still, diffusion capture). Revísalos: áreas seguras, superposiciones en las uniones, fuentes de respaldo, contraste.
  4. Renderizado de borrador con --quality draft --workers 1 en renders/draft.mp4. Confirma duración, resolución, fps y audio con ffprobe.
  5. Sonoridad: mide con ffmpeg ebur128. Si no está alrededor de −14 LUFS (pico verdadero ≤ −1 dBTP), crea renders/final.mp4 con el método de ganancia + limitador descrito en AGENTS-tooling.md. Si hay voz: verifica que la voz esté claramente por encima de la música.
  6. Bucle de crítica (AGENTS.md → Review loop): a partir del MP4 de borrador, genera una hoja de contactos a 2 fps, una tira de 12 fotogramas alrededor de la acción más rápida, una prueba de teléfono de 360 px y una verificación de bucle; puntúa hook, legibilidad, motion, composición, profundidad, marca, sincronización de audio y pulido (1–10); corrige los 3 peores y vuelve a renderizar. Repite hasta que cada puntuación sea ≥ 8 después de ≥ 3 rondas; un subagente crítico nuevo da el veredicto final.
  7. Escribe VERIFY.md: comandos ejecutados, resultados, rutas de snapshots, LUFS medido, tabla de crítica por ronda, problemas abiertos. Escribe solo lo que realmente verificaste.
  8. Pregunta al propietario: ¿renderizar final ahora o qué cambios? Nunca ejecutes un render final sin su aprobación, y nunca ejecutes dos renders a la vez.

Individual skills in this repo

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

jayfirke/motion-studio

Audit asset licences for a MotionGraphics project or the _shared library against the ledger in _shared/ASSETS.md. Use before rendering a final, before adding any new sound, music, image, icon, font or Lottie file, or when the owner asks if a video is safe to post.

jayfirke/motion-studio

Scaffold a new video project in projects with the right engine, template files, fonts and audio. Use when the owner asks to start, make or create a new video, reel, promo, intro or motion graphic in this workspace.

jayfirke/motion-studio

Plan a film as its director and show it to the owner as a playable previs page (animatic with real voice, music and foley, a timeline, three swappable options on every decision, time-anchored notes, versions and an Approve button) before anything is rendered. Use for every new film over 10 s, when the owner asks to "see it first", "previs", "storyboard", "animatic", or "visualize before you render", and when they leave notes on a previs page. Produces approved-video-spec.json for the engine skills; never renders the final itself.

jayfirke/motion-studio

Set up this motion-studio workspace on a new machine for its owner - check the tools, install what is missing (with their OK), write OWNER.md from a few plain questions, have them store their own API keys safely (Keychain on macOS, secret store or a private file on Linux and WSL 2), and write the local setup marker. Use when the session-start note says FIRST RUN, when someone says "set up motion-studio", "set up this workspace", "install everything", "add my API keys", "it doesn't work on my computer", or right after cloning the repo.

Skills relacionados