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,9x16primario).
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]
| Indicador | Efecto |
|---|---|
<dir> | destino; se crea si no existe |
--title T | título en studio.json y slug del archivo de entrega |
--duration S, --fps N, --bpm N | temporización |
--formats a,b | subconjunto de 9x16, 1x1, 16x9, 4x5 (o all); primaryFormat se mantiene a menos que no esté listado |
--loop | película con bucle sin costuras (morfologías de UI) |
--brand-url URL | almacena 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ó |
--install | ejecuta npm install en el nuevo proyecto (maneja npm.cmd en Windows) |
--force | actualiza un proyecto anterior a la plantilla actual (ver la tabla a continuación) |
--json | una 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):
| Ruta | Con --force |
|---|---|
studio.json, film/**, docs/**, assets/fonts/fonts.json | se mantienen y listan como kept; uno faltante aún se crea. Indicadores como --bpm aún modifican studio.json |
package.json | fusionado, 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 |
.gitignore | fusionado: 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 adicionales | sin 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
- Sin
--install, ejecutanpm installdentro del proyecto.playwrightes la única dependencia requerida;ffmpeg-statices opcional y puede fallar al descargar detrás de un proxy. - Navegador (
npm run setup:browseres el mismo comando que la líneanpx):- Windows: ejecuta
npx playwright install chromium-headless-shell(aproximadamente 115 MB de descarga, 270 MB en disco).studio.jsonbrowser: "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 cambiesbrowserachromeomsedge, ni establezcasMOTION_CHROME_PATHa unchrome.exeomsedge.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-playwrightes su decisión o la de TI. - macOS y Linux:
autointenta primero con Chrome instalado, luego con Edge, luego con el navegador incluido, sin advertencia. Si no hay ninguno instalado, ejecutanpx playwright install chromium-headless-shell(Linux:npx playwright install --with-deps chromium-headless-shell), o estableceMOTION_CHROME_PATHen un ejecutable de la familia Chromium.
- Windows: ejecuta
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.- Pruébalo:
npm run stills, luego abreout/review/9x16/contact.png(una película larga está paginada:contact.pnges la página 1, luegocontact-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 previewabre 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.mden el nuevo proyecto (la referencia completa esdocs/ARCHITECTURE.mden el repositorio del plugin) - Las reglas de la casa viven en el
CLAUDE.mddel 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.
| Comando | Hace |
|---|---|
npm run preview | vista previa en vivo en el navegador |
npm run stills | un fotograma por tiempo fuerte como hoja de contactos |
npm run critique | contacto, tira, prueba de teléfono, métricas, bloque de registro de revisión |
npm run gate | puerta de crítica: 3 rondas, todos los ejes >= 8, sin P0 |
npm run render:final | cada formato, calidad final (puerta aplicada) |
npm run sfx / npm run mix | sintetizar efectos de sonido de referencia / mezclar a -14 LUFS y multiplexar |
npm run deliver | comprobaciones de entrega y paquete out/deliver/ |
npm run build | puntuación si falta, efectos de sonido, renderizado final, mezcla, entrega |
5. Esfuerzo y rutas
| Trabajo | Esfuerzo | Establecer con |
|---|---|---|
| pequeñas correcciones, re-renderizados | medio | /effort medium |
| una nueva película | muy alto | /effort xhigh (la habilidad motion-reel lo establece por ti) |
| primeros 3 segundos emblemáticos de un lanzamiento | má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ñante | Uso para | Nota |
|---|---|---|
| claude-animation (buildwithhanif) | dibujo a mano, pincel, apariencia de libro de cuentos | MIT; renderizador de lienzo Node separado |
| HyperFrames (heygen-com) | composiciones HTML + GSAP | Apache-2.0; Node 22+ |
| Remotion | series y plantillas React | licencia 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.