Communitygithub.com

datassthou64-source/blue-motion-kit

Convierte el audio de voz en off del creador en gráficos en movimiento HyperFrames investigados y visuales. Úsalo cuando se proporcionen uno o más archivos de audio para un video de creador y se pida transcribir, analizar, investigar conceptos o productos en línea, construir o revisar gráficos en movimiento puros, previsualizar localmente o renderizar en el estilo establecido de gradiente azul continuo.

¿Qué es blue-motion-kit?

Blue Motion Graphics es un skill de agente de IA diseñado para creadores de contenido que desean transformar su voz en off en gráficos animados profesionales, visualmente ricos y basados en hechos. El skill se centra en un enfoque "visual primero, texto después", donde cada entidad nombrada (como empresas, productos o repositorios) debe representarse con un activo real, como el logotipo oficial o una captura de interfaz de usuario, en lugar de texto genérico o tarjetas abstractas. El flujo de trabajo comienza con la transcripción del audio y la descomposición del discurso en "tiempos semánticos" (rangos de tiempo y significado). Luego, se investigan conceptos desconocidos y marcas actuales antes de dibujar, priorizando fuentes oficiales. La composición se realiza mediante plantillas configurables que generan geometría a partir de un bloque de configuración, o adaptando patrones existentes. El skill también incluye herramientas para previsualizar localmente (`npm run dev`), renderizar pasajes específicos (con un script que verifica formato y genera un XML para integrar en Premiere o DaVinci Resolve), y gestionar activos como logotipos. El skill está diseñado para plataformas como Claude Code (a través de un repositorio de skills) y se describe en un completo archivo SKILL.md que detalla la estructura del proyecto, el flujo de trabajo paso a paso, las reglas de estilo y las no negociables. Su principal ventaja es la automatización de un proceso que de otra forma requeriría mucho tiempo manual: desde la investigación de marcas hasta la renderización, manteniendo una coherencia visual estricta y un estilo "gradiente azul" continuo, sin cortes abruptos en la línea de tiempo.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/blue-motion

Preguntar en tu IA favorita

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

Documentación

Gráficos en movimiento Blue Motion

Construye una explicación visual basada en hechos alrededor de la voz en off. Favorece objetos reconocibles, el lenguaje visual de la interfaz de producto, logotipos oficiales y transformaciones en lugar de leyendas o tarjetas de texto abstractas.

Carga primero /motion-visual-sourcing. Este archivo contiene las dos leyes de las que depende este estilo: visual primero, texto después (borra cada palabra; la idea debe seguir llegando) y cada entidad nombrada merece un activo real y con fuente (obtén el logotipo real, la interfaz de usuario auténtica o una captura del sitio para cualquier empresa, producto, sitio o repositorio que la voz en off mencione — nunca una caja genérica o el nombre como texto simple). El gradiente azul de este skill gobierna su apariencia; esas leyes gobiernan lo que aparece en pantalla.

Dónde está todo

Todas las rutas a continuación son relativas a KIT, la raíz del repositorio blue-motion-kit. bash <carpeta-de-este-skill>/scripts/kit-root.sh lo imprime (resuelve enlaces simbólicos, por lo que es correcto tanto si este skill se cargó desde el repositorio como a través de un enlace).

RutaQué es
library/design.mdLa única especificación visual: paleta, tipografía, objetos, verbos de movimiento, reglas de honestidad y el mapa de forma de argumento -> escena. Gana cualquier conflicto. Léelo antes de hacer el storyboard.
library/scenes/13 plantillas basadas en configuración de la compilación aprobada de Grok Bot. Copia los archivos .html + .motion.json en compositions/ y edita el bloque CFG al principio de su <script>; la geometría se regenera a partir de él.
library/patterns/Los primitivos estáticos anteriores. Siguen siendo válidos.
library/PATTERNS.mdÍndice de ambos.
library/assets/logos/Marcas oficiales congeladas y verificadas (Grok, Grok Bot, xAI, X, Cursor, Claude, Slack, Instantly, HeyReach, HubSpot, GitHub…). SOURCES.md es la tabla de procedencia. Revisa aquí antes de obtener.
reference/grok-bot/La compilación de referencia aprobada: código fuente de escenas, hojas de contactos y dos renders terminados. Mira, no copies directamente.
brand/creator.mdQuién mira y cómo habla el creador.
KIT/editor.local.mdLas preferencias del editor de esta máquina de la primera entrevista (carpeta de proyectos, NLE, puertas de aprobación). Léelo si existe.
references/build-recipe.md (este skill)El contrato de composición y los errores que pasan la comprobación check correctamente. Léelo al crear o depurar.
references/scene-patterns.md (este skill)Dispositivos creados a mano que no son plantillas.
scripts/ (este skill)bootstrap-project.sh (nuevo proyecto), render_passages.py (exportación), hlg_to_sdr.py (corrección de metraje HDR), fetch-logo.py (resolvedor de logotipos), kit-root.sh.

Una plantilla proporciona la coreografía, la suavización, la paleta y la seguridad de búsqueda. No proporciona nada sobre si es la idea correcta para este momento. Cambia el texto y la metáfora para que coincidan con lo que realmente se dice; vuelve a investigar cada producto recién nombrado y usa sus activos oficiales actuales. Nunca publiques el marcador de posición de una plantilla.

Flujo de trabajo

  1. Lee brand/creator.md, y editor.local.md si existe.

  2. Usa los skills obligatorios de HyperFrames, gráficos en movimiento, uso de medios y CLI.

  3. Inspecciona solo el audio proporcionado. Ignora el trabajo anterior para ese audio a menos que el editor pida explícitamente reutilizarlo.

  4. Crea la estructura del proyecto: bash SKILL_DIR/scripts/bootstrap-project.sh PROJECTS_DIR/<slug-del-video> AUDIO... (PROJECTS_DIR proviene de editor.local.md; por defecto KIT/projects). Copia el iniciador, gradiente, logotipos y ambas generaciones de plantillas, e imprime la duración de cada archivo de audio.

  5. Transcribe cada archivo con marcas de tiempo por palabra (npx hyperframes transcribe assets/audio-01.<ext> --dir . o la ruta de uso de medios actual). Lee la transcripción para verificar y corrige errores obvios de nombres propios (Clay, n8n, Instantly, HeyReach, Prospeo, Apify, Grok, Cursor, Claude Code, Codex, MCP).

  6. Para múltiples archivos, conserva los originales y colócalos secuencialmente en una línea de tiempo. Usa ffprobe para los desplazamientos exactos.

  7. Convierte la transcripción en tiempos semánticos: rango de tiempo, significado, tema visual, acción y necesidad de investigación.

  8. Investiga conceptos desconocidos y la marca actual del producto antes de dibujar. Prefiere fuentes oficiales, guarda los activos resueltos localmente y registra las fuentes en RESEARCH.md. Logotipos: python3 SKILL_DIR/scripts/fetch-logo.py --manifest logos.txt assets/logos, luego abre cada archivo que devuelva.

  9. Haz un storyboard del audio completo antes de crear (STORYBOARD.md). Apunta a una escena visual completa por cada 4–8 segundos. Si editor.local.md solicita la aprobación del storyboard, detente aquí y muéstralo.

  10. Coloca el video con gradiente azul en la línea de tiempo principal, un clip ininterrumpido por cada pasaje de gráficos en movimiento, y mantén cada escena transparente para que el fondo nunca se reinicie en los cortes.

  11. Adapta el patrón semánticamente coincidente más pequeño. No fuerces un tema en una plantilla solo porque existe.

  12. Ejecuta npx hyperframes check, luego captura la imagen final de cada escena y mira las imágenes. Los errores de geometría (un objeto que aterriza en las coordenadas incorrectas, un elemento que se desliza sobre otro) pasan la comprobación check en silencio y solo se ven en un fotograma.

  13. Abre la vista previa local (npm run dev) y da al editor la URL. No renderices hasta que el editor lo apruebe explícitamente (a menos que editor.local.md diga renderizado automático).

  14. Después de la aprobación, exporta con el script predeterminado. No ejecutes un renderizado de línea de tiempo completa.

    python3 SKILL_DIR/scripts/render_passages.py PROJECT_DIR
    

    Renderiza cada pasaje de gráficos en movimiento a renders/MGNN-<etiqueta>.mp4. Convierte cualquier metraje HLG a SDR primero, y verifica cada archivo para 1920×1080, 30 fps, número de fotogramas, audio y SDR BT.709. Luego escribe premiere-cuts.xml, que coloca cada archivo en su posición real en la línea de tiempo de la voz en off (se importa en Premiere y DaVinci Resolve). Usa --dry-run para listar pasajes, --only 3,8 para volver a renderizar algunos, y --xml-only para reconstruir el XML. Luego mira un fotograma de cada archivo; las comprobaciones del script no pueden ver una capa faltante. Detalles y por qué: references/build-recipe.md §7.

  15. Termina con una breve entrega: ruta del proyecto, los renders, el XML y cualquier activo que no hayas podido verificar.

SKILL_DIR es la carpeta de este skill: KIT/.claude/skills/blue-motion.

Velocidad y disciplina de tokens

  • Reutiliza el gradiente exacto, los tokens de estilo y los primitivos de escena verificados.
  • Investiga solo los sustantivos que afectan a las imágenes fácticas: productos, logotipos, interfaces, flujos de trabajo u objetos físicos.
  • Prefiere una fuente autorizada para un hecho simple; añade más solo cuando sea ambiguo.
  • Mantén concisos BRIEF.md, RESEARCH.md y STORYBOARD.md.
  • Reutiliza geometría precisa para portátiles, ventanas de repositorios, mosaicos de aplicaciones y rutas.
  • Muestra capturas de pantalla o la vista previa local en lugar de narrar las elecciones de CSS.

No negociables

El aspecto y las reglas de honestidad son los párrafos 9–10 de library/design.md: sin cámara de rostro, sin leyendas ni tarjetas de frases, etiquetas de 1 a 3 palabras, marcas reales con fuente en las placas, y nada fabricado. Además de esto:

  • Las pantallas de portátiles se mantienen cerca de 16:9 y los dispositivos establecidos nunca palpitan ni cambian de dimensiones.
  • Los objetos en movimiento viajan de forma continua. No hagas una pausa a menos que la narración describa una parada. Usa un movimiento de ping-pong suave para ideas de ir y venir.
  • Haz que cada escena tenga una idea visual dominante con un cambio de estado claro, usando un verbo tangible: dividir, copiar, sincronizar, tirar, empujar, buscar, ensamblar, enrutar, desbloquear, comparar, transformar.

Cambiar el kit en sí mismo

Una nueva regla duradera (una decisión de estilo, un activo predeterminado, una nueva trampa) va a su único hogar — las reglas de aspecto en library/design.md, las trampas/procedimientos en este skill, los datos del creador en brand/creator.md — nunca en las notas de un proyecto o en la memoria del agente. Luego haz commit para que cada editor lo reciba (consulta CONTRIBUTING.md en la raíz del kit).

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados