Communitygithub.com

yazzang-homelab/motion-studio

Inicializa un proyecto cinematográfico del estudio motion-studio (renderizador seek(t), muelles, cuadrícula de ritmo, sonido sintetizado, herramientas de crítica), lo instala, configura el navegador y ejecuta el diagnóstico. Utilízalo para 'configurar el motion studio', 'nuevo proyecto cinematográfico', 'iniciar estudio'.

¿Qué es motion-studio?

Esta habilidad automatiza la creación de un proyecto cinematográfico completo con el motor renderizador seek(t) de motion-studio. Es ideal para desarrolladores y agentes de IA que necesitan un entorno de animación listo para producir. La habilidad configura el proyecto, instala dependencias, prepara el navegador (con manejo especial en Windows para evitar bloqueos de cuenta) y ejecuta un diagnóstico completo. También proporciona herramientas de crítica, previsualización en vivo y renderizado final con bucle sin costuras. Soporta la configuración de metadatos como duración, FPS, BPM, formatos de salida y URL de marca. El flujo incluye opciones para forzar actualizaciones de plantillas, fusionar archivos existentes y gestionar claves API para servicios externos como ElevenLabs o FAL.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/studio-init

Preguntar en tu IA favorita

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

Documentación

Inicio del estudio (paso 02 del curso)

Crea un proyecto cinematográfico que pueda renderizar, escuchar y mirar sus propios fotogramas. La aplicación de chat puede escribir una animación; solo un agente con un shell puede cerrar el renderizado, mirar y corregir el bucle. Ese bucle es la diferencia entre un primer intento "regular" y una película digna de publicarse.

Argumentos de la solicitud (pueden estar vacíos), mostrados una vez:

1. Elegir el directorio y la configuración

  • Directorio: el primer argumento; si no, . cuando el directorio de trabajo esté vacío; si no, preguntar (por defecto ./<slug-del-titulo>). Nunca iniciar dentro del directorio del plugin.
  • Configuración de la solicitud: título, duración, formatos, fps, bpm, bucle, URL de marca. Dejar el resto en los valores predeterminados de la plantilla (studio.json: 12 s, 60 fps, 4 subfotogramas, 120 BPM, 9x16 primario).

2. Iniciar

node "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <dir> --title "<Title>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
IndicadorEfecto
<dir>destino; se crea si no existe
--title Ttítulo en studio.json y slug del archivo de entrega
--duration S, --fps N, --bpm Ntemporización
--formats a,bsubconjunto de 9x16, 1x1, 16x9, 4x5 (o all); primaryFormat se mantiene a menos que no esté listado
--looppelícula con bucle sin costuras (morfologías de UI)
--brand-url URLalmacena la URL del producto en brand.url. user:password@ y los parámetros de apariencia secreta (query, ;matrix, fragmento: token, key, secret, password, auth, sig, session, code ...) se eliminan antes de escribir cualquier cosa; stderr nombra lo que se eliminó y --json lo lista en redacted. De todas formas, pasa una URL pública simple: un secreto que es un segmento de ruta simple (/reset/<token>) no puede ser reconocido. Una URL simple se almacena exactamente como se escribió
--installejecuta npm install en el nuevo proyecto (maneja npm.cmd en Windows)
--forceactualiza un proyecto anterior a la plantilla actual (ver la tabla a continuación)
--jsonuna línea de resultado JSON en stdout

Un directorio existente no vacío se fusiona: solo se añaden los archivos faltantes y los archivos omitidos se listan. Informa al usuario sobre la lista omitida; nunca elimines sus archivos.

--force en un proyecto existente (verificado contra init.mjs):

RutaCon --force
studio.json, film/**, docs/**, assets/fonts/fonts.jsonse mantienen y listan como kept; uno faltante aún se crea. Indicadores como --bpm aún modifican studio.json
package.jsonfusionado, nunca reemplazado: establece type: module, añade private, engines y cada script o dependencia de plantilla que falte en el proyecto. Un script de plantilla cuyo comando difiere se restablece al comando de la plantilla (init imprime cada uno como was ..., now ... y los devuelve en packageReset). Las versiones de las dependencias nunca se cambian, incluidas las dependencias de la plantilla: un rango existente se mantiene, ya sea más nuevo, más antiguo o fijado. El nombre, la versión, otros scripts y otros campos se mantienen
.gitignorefusionado: las líneas de plantilla faltantes se añaden debajo de # motion-studio, no se elimina nada
todo lo demás (CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, fuentes incluidas)sobrescrito y listado como overwritten. Las ediciones locales de estos archivos se pierden: haz commit o cópialos primero
tus propios archivos adicionalessin cambios

Sin --force, package.json y .gitignore se fusionan de la misma manera, excepto que un script que difiere mantiene tu comando. Init lista cada script y versión de dependencia que difiere de la plantilla bajo kept your package.json values, which differ from the template (packageKept en el resultado --json): esos npm run ejecutan TU comando, y --force restablece los scripts de la plantilla (nunca las versiones de las dependencias). Una sección scripts, devDependencies u optionalDependencies que no es un objeto se deja intacta con una advertencia. Dado que docs/** se mantiene, un documento de plantilla más nuevo nunca llega a un proyecto existente: compara con el template/docs/ del plugin manualmente después de una actualización.

3. Instalación, navegador, diagnóstico

  1. Sin --install, ejecuta npm install dentro del proyecto. playwright es la única dependencia requerida; ffmpeg-static es opcional y puede fallar al descargar detrás de un proxy.
  2. Navegador (npm run setup:browser es el mismo comando que la línea npx):
    • Windows: ejecuta npx playwright install chromium-headless-shell (aproximadamente 115 MB de descarga, 270 MB en disco). studio.json browser: "auto" inicia solo ese shell headless incluido, nunca el Chrome o Edge instalado. Razón: un Chrome o Edge instalado iniciado con un perfil nuevo (cada ejecución de herramienta) hace que Chrome pruebe la cuenta de Windows en busca de una contraseña en blanco, lo que cuenta como un inicio de sesión fallido. El portátil medido bloquea la cuenta después de 10 inicios de sesión fallidos en 10 minutos y registró 464 en 24 h. No cambies browser a chrome o msedge, ni establezcas MOTION_CHROME_PATH a un chrome.exe o msedge.exe, a menos que el usuario lo solicite y acepte el riesgo: imprime una advertencia por cada inicio y el cuarto inicio en 10 minutos es rechazado, 3 pasan (el guardián de inicio). El shell no está firmado, por lo que un antivirus en tiempo real puede hacer que cada ejecución de herramienta sea de 15 a 25 s más lenta (medido): díselo al usuario una vez; una exclusión de antivirus para %LOCALAPPDATA%\ms-playwright es su decisión o la de TI.
    • macOS y Linux: auto intenta primero con Chrome instalado, luego con Edge, luego con el navegador incluido, sin advertencia. Si no hay ninguno instalado, ejecuta npx playwright install chromium-headless-shell (Linux: npx playwright install --with-deps chromium-headless-shell), o establece MOTION_CHROME_PATH en un ejecutable de la familia Chromium.
  3. npm run doctor. Corrige cada fila FAIL antes de entregar, y en Windows también una fila WARN del navegador (se eligió un Chrome o Edge instalado: límpialo e instala el shell headless); las correcciones por SO están en references/troubleshooting.md. Python con librosa es opcional (el motor de ritmo JS lo cubre). Node 22+ es necesario solo para las herramientas de la ruta B.
  4. Pruébalo: npm run stills, luego abre out/review/9x16/contact.png (una película larga está paginada: contact.png es la página 1, luego contact-2.png ..., ninguna página supera los 1800 px de altura; abre cada página) y mírala. La demostración de 12 s incluida debe mostrar un fotograma compuesto en 0 s y un cambio en cada tiempo fuerte. npm run preview abre la vista previa en vivo (Espacio reproducir/pausar, flechas avanzar fotogramas, F cicla formatos, G guías de área segura).

4. Explicar el proyecto al usuario

Resume en unas pocas líneas, luego señala las referencias:

  • Diseño y quién edita qué: references/project-layout.md
  • Todos los comandos: references/commands.md
  • Cada firma y valor predeterminado de lib/: docs/API.md en el nuevo proyecto (la referencia completa es docs/ARCHITECTURE.md en el repositorio del plugin)
  • Las reglas de la casa viven en el CLAUDE.md del proyecto, que Claude Code lee en cada ejecución allí.

Si init imprimió una línea con estrella ★ (starHint en el resultado --json; aparece una vez por máquina, en el primer nuevo proyecto), termina tu resumen con esa línea tal como está escrita. Nunca marques con estrella el repositorio ni ejecutes gh para el usuario.

ComandoHace
npm run previewvista previa en vivo en el navegador
npm run stillsun fotograma por tiempo fuerte como hoja de contactos
npm run critiquecontacto, tira, prueba de teléfono, métricas, bloque de registro de revisión
npm run gatepuerta de crítica: 3 rondas, todos los ejes >= 8, sin P0
npm run render:finalcada formato, calidad final (puerta aplicada)
npm run sfx / npm run mixsintetizar efectos de sonido de referencia / mezclar a -14 LUFS y multiplexar
npm run delivercomprobaciones de entrega y paquete out/deliver/
npm run buildpuntuación si falta, efectos de sonido, renderizado final, mezcla, entrega

5. Esfuerzo y rutas

TrabajoEsfuerzoEstablecer con
pequeñas correcciones, re-renderizadosmedio/effort medium
una nueva películamuy alto/effort xhigh (la habilidad motion-reel lo establece por ti)
primeros 3 segundos emblemáticos de un lanzamientomáximo/effort max

/model también ofrece la elección de esfuerzo al seleccionar Opus 5.5. La Ruta A (este motor) es la predeterminada. Usa Remotion o HyperFrames solo cuando el usuario nombre uno; /motion-studio:seek-engine tiene la transferencia, incluida la puerta de licencia de Remotion.

6. Claves

Copia .env.example a .env solo cuando se necesite una clave (voz: ELEVENLABS_API_KEY; ruta C imágenes/video: FAL_KEY). Dile al usuario que pegue el valor en .env él mismo. En los mensajes y registros, refiérete solo al nombre de la variable. .env ya está en el .gitignore del proyecto.

7. Acompañantes opcionales

Menciona estos solo cuando sean relevantes. Comandos de instalación y advertencias: references/companions.md.

AcompañanteUso paraNota
claude-animation (buildwithhanif)dibujo a mano, pincel, apariencia de libro de cuentosMIT; renderizador de lienzo Node separado
HyperFrames (heygen-com)composiciones HTML + GSAPApache-2.0; Node 22+
Remotionseries y plantillas Reactlicencia de empresa para organizaciones con fines de lucro de más de 3 empleados

Siguiente: prueba el motor con /motion-studio:showreel, o haz una película real con /motion-studio:motion-reel.

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

Skills relacionados