OliviaPp8/minara-video-skills

/minara-video

🅖 Regla de fuente: cada video de Minara usa Geist para todo el texto

Títulos / cuerpo / números / botones / tablas - todo usa font-family: 'Geist', system-ui, -apple-system, sans-serif. No Inter, no serif de ningún tipo, y ninguna fuente predeterminada del sistema que recurra a serif. Carga: @import url('https://fonts.googleapis.com/css2?family=Geist:wght@400;500;600;700;800&display=swap'); empareja números con font-variant-numeric: tabular-nums. Escribe ambos selectores CSS, #root, [data-composition-id="root"] {}, o font-family no se aplicará y la página hereda la serif predeterminada del navegador (ver punto 1 de "Errores de estructura de composición"). No negociable ni opcional, a menos que el operador diga explícitamente "换字体" (cambiar fuente) para ese trabajo. (Establecido por el operador el 2026-06-24; promovido a regla principal el 2026-06-26.)

Este es el procedimiento operativo estándar del operador para videos de Minara, destilado de los problemas encontrados al hacer el video de lanzamiento público de Strategy Studio el 26~27 de mayo de 2026.

⚠️ Ruta primero: este es el flujo de trabajo para videos de movimiento compuestos con HyperFrames (marketing / lanzamiento / demo, donde cada fotograma se construye en código). Si la tarea es un video de guía de producto / tutorial - el operador graba la pantalla él mismo y tú solo agregas voz en off + subtítulos y entregas - usa la sub-skill minara-guide-video, no esta. Cómo distinguir: ¿hay una grabación de pantalla existente? / ¿la solicitud es "agregar voz en off y subtítulos a esta grabación"? Las dos difieren en voz, subtítulos y entrega.

⛔️ Prerrequisito de inicio: cargar HyperFrames + video-shotcraft (obligatorio)

Tan pronto como esta skill comience, usa la herramienta Skill para invocar la skill hyperframes para que todas sus reglas de composición estén en contexto, luego lee la biblioteca local de tomas video-shotcraft en su totalidad, y solo entonces continúa con el flujo de trabajo a continuación.

• Este es un prerrequisito estricto, no opcional - minara-video es solo un envoltorio de flujo de trabajo más estricto; la sintaxis de composición real / línea de tiempo / reglas de renderizado viven todas en hyperframes. Escribir HTML de escena sin cargarlo encontrará problemas conocidos (línea de tiempo en pausa, registro de window.__timelines, sin Math.random() / repeat:-1, etc.).
• Incluso si hyperframes ya se usó antes en esta sesión, invócalo de nuevo al iniciar /minara-video para que las reglas estén en el contexto actual.
• Orden de carga: Skill(hyperframes) primero → luego lee $VIDEO_WORKSPACE/video-shotcraft/SKILL.md en su totalidad → luego Lee $BRAND_DIR/design.md (sistema visual Minara v2) → luego lee las reglas de estilo fijas → luego sigue el flujo de trabajo a continuación.
• Debes leer $BRAND_DIR/design.md (obligatorio; lección del 2026-06-24): este es el sistema visual oficial de Minara v2 y la fuente de verdad para valores de color, escala tipográfica, espaciado, radio de esquina, tarjetas y diseño. Las reglas de estilo fijas de esta skill son la "capa de estado de ánimo del video"; design.md es la "fuente de verdad de los tokens de diseño" - ambos deben estar en contexto. ⚠️ El degradado de marca listado en design.md, #EB53FF/#FF538E/#FF9A32, no se usa en videos (eliminado por el operador el 2026-09-02; ver las reglas de estilo fijas a continuación). Toma solo sus tokens blanco/negro/gris, colores semánticos, escala tipográfica y espaciado de 4pt.
• Carga la carpeta de activos de marca $BRAND_DIR/logo/ por defecto (establecido por el operador, 2026-06-24): cuando necesites un logotipo / avatar / marca denominativa, usa primero los activos oficiales aquí; no dibujes tu propio SVG como sustituto. Inventario actual (ejecuta ls primero para verificar; puede cambiar):
  • Minara Avatar.png - Avatar de píxeles en blanco y negro de Minara (chica con gafas, semitono); el predeterminado para el logotipo redondo en los finales.
  • Minara Logo.png - Marca de logotipo principal de Minara.
  • MInara Text Logo Light.png / MInara Text Logo Light Dark.png - Marca denominativa de texto (versiones clara / clara y oscura).
  • Minara Avatar Japan.png - Variante de avatar para el mercado japonés.
  • 128_128.png - Icono cuadrado pequeño.
  • minara X banner.jpeg - Banner de X.
  • Uso: cp los activos que necesites en el assets/ del proyecto y refiéreles en HTML con <img src="assets/xxx.png">; HyperFrames incrusta imágenes locales en tiempo de renderizado. Al autoverificar con capturas de pantalla, también cp una copia en /tmp/<test-dir>/assets/ (las rutas relativas solo se resuelven así).

🎬 Reglas de carga de la biblioteca local de tomas video-shotcraft (2026-07-21)

• Ruta de biblioteca local fija: $VIDEO_WORKSPACE/video-shotcraft/. Cada vez que /minara-video se inicia, lee su SKILL.md en su totalidad. No lo uses basándote solo en nombres de tarjetas o memoria.
• El método fijo para traducir tarjetas está en la "Sección B de lecciones de tomas de cliente 'creciente / autoescritura'" a continuación (fotogramas de tarjeta × TEMPO, clip-path en lugar de máscaras de color de papel, PageCam2D integrado en keyframes, zoom ≥ 1, enfoque fijado al lienzo).
• Su función predeterminada es una biblioteca de referencia; no cambia la pila tecnológica automáticamente: minara-video todavía se centra en las composiciones seguras para búsqueda de HyperFrames, vistas previas por escena y flujo de renderizado; video-shotcraft proporciona lenguaje de toma, recetas de movimiento de cámara, estructuras de ritmo, diseño de sonido, demos aprobados y activos. Al adoptar una de sus implementaciones de Remotion, primero traduce el método a una línea de tiempo HyperFrames determinista y buscable. No copies Date.now(), Math.random() o animaciones no seguras para búsqueda directamente.
• No actives las indicaciones de plantilla de la skill independiente: al cargar esta biblioteca dentro de /minara-video, no preguntes cada vez si usar Ink Press, y no interrumpas el flujo de trabajo bloqueado de Minara por ello. Solo cuando el operador nombre explícitamente Ink Press o Remotion, o pida replicar esa plantilla, lee template/TEMPLATE.md en su totalidad y cambia a la ruta de la plantilla.
• Lee la fuente de verdad de cualquier tarjeta de toma que uses: una vez que decidas usar una tarjeta de toma, lee references/shots/<card-name>.md y la implementación fuente de demos/<card-name>/ correspondiente en su totalidad; lee references/sequences/ cuando necesites estructura de película completa, y references/sound-design.md y assets/audio/ATTRIBUTION.md cuando necesites sonido. No cargues las 106 tarjetas en el contexto a la vez.
• Copia solo los activos que necesites: copia desde assets/lib/, assets/audio/ o demos/ al proyecto de video actual; no permitas que el proyecto dependa de las rutas relativas de esta biblioteca en tiempo de ejecución. Al usar audio, conserva y verifica la atribución de licencia.

🧰 Reglas de la biblioteca local de componentes Remotion Remocn (2026-08-13)

• Ruta de biblioteca local fija: $VIDEO_WORKSPACE/remocn/. Es una biblioteca de componentes copiar-pegar estilo shadcn para Remotion, no un plugin de HyperFrames ni una dependencia en tiempo de ejecución de proyectos de video.
• Carga bajo demanda; no es parte de cada inicio: solo cuando el storyboard necesite un movimiento / transición / simulación de UI listo de Remocn, o el operador nombre explícitamente Remocn / Remotion, lee el skills/remocn/SKILL.md local en su totalidad. Para una película completa, luego lee skills/remocn/references/anatomy.md y los references/archetypes/<type>.md correspondientes; no cargues cada arquetipo a la vez.
• HyperFrames sigue siendo la pila predeterminada: en trabajos ordinarios de /minara-video, trata Remocn solo como una referencia de toma / movimiento, y traduce la lógica de movimiento del componente elegido a una línea de tiempo GSAP/DOM de HyperFrames buscable y determinista. No pongas TSX de React/Remotion directamente en HTML de escena, y no cambies de pila solo porque exista un componente listo.
• Úsalo directamente solo cuando Remotion sea elegido explícitamente: en un proyecto Remotion existente, si falta components.json, ejecuta npx shadcn@latest init primero; luego instala solo los componentes que el storyboard seleccionó: npx shadcn@latest add @remocn/<name>. shadcn resuelve dependencias recursivamente; modifica el código después de que se copie en el proyecto actual. No instales todo, y no permitas que la película final haga referencia a la ruta del repositorio local de Remocn.
• Los parámetros de los componentes siguen la documentación en vivo: primero lee https://remocn.dev/llms-components.txt para filtrar, luego lee la página específica .../<component>.md a la que apunta la tabla; no adivines props, valores predeterminados o duraciones. Para investigar una implementación, vuelve a la fuente registry/ de la biblioteca local y a content/docs/.
• Adáptalos a las reglas de Minara; no copies la apariencia predeterminada: la estructura de toma, el movimiento y el tiempo de Remocn se pueden reutilizar, pero la fuente debe cambiarse a Geist, y el color, tamaño de tipo, densidad de información, el easing característico y las transiciones de ≤0.5s aún siguen las reglas de esta skill. Length en la documentación de Remocn es el fotograma donde termina la acción propia del componente, no la duración total de la escena; agrega tiempo de espera según el guión por segundo. Su 1280×720 @ 30fps predeterminado tampoco anula la especificación de salida del proyecto Minara actual.
• Distingue los dos tipos de API: el nivel de animación está impulsado por fotogramas y acepta speed; los primitivos remocn-ui están impulsados por estado de línea de tiempo y no tienen prop speed. Ambos deben ser reproducibles fotograma por fotograma, y Math.random() / Date.now() / animación impulsada por intervalo siguen prohibidos.

📸 Reglas de la biblioteca local de componentes de demostración de producto Remotion snapcn (2026-09-04)

• Ruta de biblioteca local fija: $VIDEO_WORKSPACE/snapcn/ (GitHub snapcndev/snapcn, MIT). Mismo tipo que Remocn - una biblioteca de componentes copiar-pegar estilo shadcn para Remotion - pero enfocada en tomas de demostración de productos de software: flujos de chat de IA, entrada de indicaciones, terminales, marcos de dispositivos, subtítulos. No es un plugin de HyperFrames ni una dependencia en tiempo de ejecución de proyectos de video.
• División del trabajo con Remocn: Remocn se inclina hacia movimiento general / transiciones / arquetipos; snapcn se inclina hacia "poner la UI del producto en la toma". Minara es un copiloto de trading de IA, por lo que el grupo AI Chat Input de snapcn (search-typing / prompt-zoom / answer-stream / prompt-send / answer-highlight / agent-steps) y Screens & Devices (phone-frame / laptop-frame / terminal-simulator / screen-recording / cursor-track) son las referencias preferidas. Para escenas como "Indica Tu Estrategia", respuestas del Copiloto, o pasos de ejecución de Autopilot, mira aquí primero.
• Carga bajo demanda; no es parte de cada inicio: solo cuando el storyboard necesite las tomas de demostración de producto anteriores, o el operador nombre explícitamente snapcn / Remotion, lee el skills/snapcn/SKILL.md local. Elige componentes a través de la tabla de enrutamiento en skills/snapcn/references/components/index.md (con Usar para / Evitar para / Longitud / Ambiente), y abre solo los references/components/<name>.md seleccionados; no los leas todos. Para estructura de película, consulta references/anatomy.md (Gancho → Posicionamiento → Revelación del producto → Características → Prueba → Llamada a la acción) y references/archetypes/.
• HyperFrames sigue siendo la pila predeterminada: en trabajos ordinarios de /minara-video, trata snapcn solo como una referencia de toma / movimiento / tiempo, y traduce la lógica de movimiento del componente elegido a una línea de tiempo GSAP/DOM de HyperFrames buscable y determinista; para detalles de implementación mira la fuente registry/snap-cn/<name>/. No pongas TSX de React/Remotion directamente en HTML de escena, y no cambies de pila solo porque exista un componente listo.
• Úsalo directamente solo cuando Remotion sea elegido explícitamente: npx shadcn@latest add @snapcn/<name> (@snapcn ya está en el directorio de registro de shadcn, por lo que no se necesita configuración de registries). El proyecto Remotion necesita un components.json primero, y el alias @/ configurado tanto en tsconfig.json como en remotion.config.ts - el empaquetador de Remotion no lee las rutas de tsconfig. Instala solo los componentes que el storyboard seleccionó; no instales todo; la película final no debe hacer referencia a la ruta del repositorio local de snapcn.
• Los parámetros de los componentes siguen la documentación: documentación en vivo en https://snapcn.dev/llms.txt (versión completa llms-full.txt); no adivines props / valores predeterminados / duraciones. Length es la longitud de fotograma natural de la acción propia del componente (ej. answer-stream 150f, search-typing 420f), no la duración total de la escena; agrega tiempo de espera según el guión por segundo. Si está por debajo del presupuesto se trunca; por encima del presupuesto es silencio.
• Tres reglas que vale la pena adoptar directamente (ya apuntan en la misma dirección que las reglas de esta skill): ① el modelo de cámara en MOTION.md - las tomas no son cortes sino una cámara virtual que se desplaza / gira por el mismo mundo: movimiento de salida rápido 8–14f + aterrizaje con resorte 10–16f + retención de texto 30–45f, el mismo origen que la receta de "seguimiento de cámara con empuje" de esta skill; ② los valores predeterminados anti-sopor de IA en skills/snapcn/references/design.md - sin espaciado decorativo entre letras, sin mayúsculas completas, sin texto degradado, sin sombras brillantes, consistente con la eliminación de degradado del 2026-09-02; ③ escala el texto con la línea base como pivote + text-rendering: geometricPrecision, que redujo la vibración de 0.284px a 0.014px (la regla motion-quality); úsalo para animaciones de escalado de texto grande.
• Adáptalos a las reglas de Minara; no copies la apariencia predeterminada: la fuente debe cambiarse a Geist; color, tamaño de tipo (UI grande legible en teléfonos), densidad de información, el easing elástico característico y las transiciones de ≤0.5s aún siguen las reglas de esta skill. Su 1280×720 @ 30fps predeterminado no anula la especificación de salida del proyecto Minara actual.
• Distingue los dos tipos de API: el nivel de animación snapcn está impulsado por fotogramas y tiene speed; los primitivos snap-cn-ui (input / caret) están impulsados por estado de línea de tiempo y no tienen speed. Ambos deben ser reproducibles fotograma por fotograma; el parpadeo del cursor usa Math.floor(frame/15) % 2, los pasos de desplazamiento del terminal en lugar de eases, y Math.random() / Date.now() / intervalo siguen prohibidos.

🎵 Toda la música y los efectos de sonido pasan por /minara-music (2026-10-14)

Después de que el guión por segundo esté confirmado, usa la skill minara-music para escribir el ambiente de cada sección y las acciones en pantalla en cues.json. Muestra al operador la hoja de pautas primero; después de que esté confirmada, renderiza BGM + SFX localmente (cuando haya voz en off, también genera una versión con volumen reducido). No descargues música de la web por capricho.

📱 Regla de escena de UI - UI grande, minimalista, no copies el producto (establecido por el operador