Communitygithub.com

yazzang-homelab/motion-studio

Escribe una especificación de estados XML de seis partes para una película de morphing de una sola forma (entradas, dirección, estructura, construcción, advertencias, inicio): estados en tiempos fuertes, cambios guiados por el cursor, bucle sin fisuras, puerta de aprobación. Útil para 'morph de UI', 'lista de estados'.

¿Qué es motion-studio?

Esta habilidad guía al usuario en la creación de una especificación detallada de morphing de interfaz de usuario (UI) en formato XML, compuesta por seis secciones esenciales. Permite definir una secuencia de estados (como botón, cargador, reproductor o tarjeta) que transicionan suavemente en una sola forma continua, controlada por clics del cursor. La habilidad automatiza la generación de la lista de estados sincronizada con una rejilla musical (BPM), calcula tiempos exactos, verifica el bucle, y exige una validación manual antes de comenzar a codificar. Es compatible con plataformas como motion-studio y se integra con herramientas de línea de comandos para proyectos de animación. Su utilidad principal es evitar errores comunes en morph loops (como cortes visibles o datos de prueba) y garantizar un resultado profesional y repetible.

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

Preguntar en tu IA favorita

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

Documentación

Especificación de morph de UI (paso 06 del curso, nivel L3)

Escribe la lista de estados, no la vibra. El prompt más marcado como favorito de la semana de lanzamiento de Opus 5.5 no fue una frase corta: el bucle de morph de UI de @twoclipping y la película MakerMap de @verbove usaron una especificación XML con entradas a solicitar, una dirección, una lista de estado por tiempo fuerte, reglas de construcción y advertencias. La idea detrás de ellos: una forma que nunca corta. Un solo elemento cambia de tamaño, radio y color de estado a estado (botón, cargador, reproductor, gráfico, paleta de comandos), un cursor provoca cada cambio con un clic real, y el último fotograma es igual al primero para que la película se repita.

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

Crédito: la disposición de seis secciones sigue la plantilla pública de @twoclipping (https://x.com/twoclipping/status/2103273003555402193; el XML está en la publicación principal, no en una respuesta al hilo como dice el curso) y la especificación MakerMap de @verbove (https://x.com/verbove/status/2103483957266268381). La plantilla en esta habilidad está escrita en las propias palabras de motion-studio: assets/spec-template.xml.

1. Solicitar las entradas

Pregunta en una sola ronda de AskUserQuestion (los subagentes no pueden preguntar; tú sí):

EntradaValor predeterminadoRegla
Producto + URLrequeridocapturar la UI real y copiarla con /motion-studio:product-reel etapa 3 cuando haya una URL
8 a 12 estados en orden narrativologo, CTA, campo de email, cargador, verificación, tarjeta, gráfico, paleta de comandosuno por tiempo fuerte
Datos reales por estadopreguntaretiquetas, números, nombres del producto; sin marcadores de posición
Colores de marca, fuentes, un acentode la captura o studio.jsonun acento
Pista de audiosintetizar minimal a 120 BPMuna pista suministrada debe permitir este uso y comenzar en un tiempo fuerte
Formatos9x16, 1x1, 16x9misma línea de tiempo, reencuadrada
Buclesíel último estado se transforma de nuevo en el primero

2. Completar la especificación

Copia la plantilla en el proyecto como docs/spec.xml y completa cada [...] con las respuestas. Mantén las seis secciones: <inputs>, <direction>, <structure>, <build>, <gotchas>, <start>. El subagente motion-director (motion-studio:motion-director) puede redactarla a partir de tu resumen; solo escribe bajo docs/.

3. Colocar los estados en la rejilla de tiempos

  1. Proyecto: inicializar con --loop si es necesario (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Producto> morph" --loop --duration <S> --install; en una instalación solo de habilidades usa node "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ... con las mismas banderas, o invoca la habilidad studio-init).

  2. Rejilla: node tools/score.mjs --style minimal --bpm 120 --dur <S>, o mide la pista suministrada con node tools/beats.mjs audio/<track>.

  3. Lista de estados con tiempos exactos de tiempo fuerte, verificaciones de bucle y advertencias:

    node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "logo,CTA button,email field,loader,check,card,chart,palette" --out docs/statelist.md
    
    BanderasUso
    --states "a,b:2,c" o --file list.txtestados en orden; :2 mantiene un estado durante dos compases
    --beats audio/beats.jsonrejilla medida (predeterminado cuando el archivo existe); --beats none la ignora
    --bpm N, --beats-per-bar Nanular la rejilla
    --no-loopuna película que termina en lugar de repetirse
    --jsonuna línea JSON con el inicio, fin y duración de contenido de cada estado

    Advierte cuando la longitud del bucle difiere de studio.json duration, cuando el primer estado no está en 0 s (una entrada en la pista), o cuando un estado dura menos de 1 s. Corrige la duración o recorta la pista antes de continuar.

  4. Completa las columnas de acción del cursor, datos y sonido de docs/statelist.md, y copia la tabla en docs/shotlist.md.

4. La puerta

Muestra la lista de estados en la rejilla de tiempos y espera la confirmación del usuario antes de escribir cualquier código de película (la sección <start> lo dice, y también el curso). Una lista rechazada se reescribe, no se programa alrededor. Registra la decisión en la línea Status: de docs/shotlist.md.

5. Construir a partir del ejemplo verificado

Copia assets/morph-loop.film.js a film/film.js y adáptalo: es un bucle funcional de 16 s, 8 estados a 120 BPM que se renderiza en todos los formatos. Reemplaza STATES (tamaños en unidades de 1080 px, token de relleno), COPY y los pintores de content con la lista aprobada y los datos reales; mantén los mecanismos:

MecanismoAPIRegla
tiempos de estadogrid.bar(i)nunca segundos escritos
tamaño del contenedor, radio, canales de color, zoom de cámaraloopTrack(t, keys, dur, spring)claves en [0, duration]; el cambio de unión una vez, como clave en el primer tiempo fuerte (este ejemplo) o en t = duración
contenido dentro y fueraswapAlpha(t, start, nextStart)dentro después de que comience el morph, fuera antes del siguiente
cursorloopTrack en x e y, cursor(g, x, y, { pressed })hace clic en el elemento actual en el tiempo fuerte
pestañas y resaltados de listaindicator(t, stops, { width })bordes con diferentes muelles
sonidoscues de grid.bar y grid.beatclic en presiones, swoosh bajo morphs
granulado y otro ruido indexado por fotogramagrain(g, W, H, c.frame % LOOP_FRAMES, ...) con LOOP_FRAMES = Math.round(dur * fps)la crítica compara hash(0) con hash(duration, { wrap: false }); el ruido sembrado por el índice de fotograma bruto hace que el final difiera del fotograma 0 y falla la verificación del bucle

Cada patrón con su razonamiento: references/morph-recipes.md. Establece studio.json "loop": true y duration a la longitud del bucle, luego npm run lint.

6. Crítica y entrega

Ejecuta el bucle de crítica desde /motion-studio:motion-reel (al menos 3 rondas, todos los ejes >= 8, sin P0 abiertos; cada ronda construye la mezcla renderizada y ambas pasadas de evidencia primero, consulta su manual de ejecución). Para bucles de morph también verifica out/review/<fmt>/loop.png (solo pasada en vivo; la pasada video/ no tiene panel de bucle) y la métrica de "costura de bucle" (hash(0) igual a hash(duration, { wrap: false }), relación de continuidad <= 1.5; el panel |end - first| debe ser negro, que el granulado indexado por fotograma rompe a menos que su índice se envuelva), etiquetas durante cada intercambio en strip.png, y la posición del cursor en cada tiempo fuerte en contact.png. Un salto en la costura es un P0. Luego npm run build.

Reglas para películas de morph

  • Un contenedor, nunca se corta. Los estados difieren solo en tamaño, radio, relleno y contenido.
  • Un cursor provoca cada cambio; ningún estado cambia por sí mismo.
  • Algo se mueve en cada tiempo fuerte: una presión, escritura, un contador, un dibujo de línea, un paso de resaltado.
  • Solo datos reales del producto. Muelles con como máximo un indicio de sobrepaso; ninguno en escritura.
  • Prohibido: easing rebotante, brillos, degradados en cromo de UI, ráfagas de partículas, tiempos fuertes muertos.
  • Nunca will-change (ni ningún truco de rasterización) en nada que la cámara escale.

Siguiente: /motion-studio:springs para ajustar la sensación; /motion-studio:ship-formats para el reencuadre y entrega por formato.

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

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

Skills relacionados