andyluu98/VideoMotion

Verifica e instala todo lo que VideoMotion necesita (Node.js, ffmpeg, HyperFrames, entorno Python, voz VieNeu, Whisper). Úsalo cuando un usuario instala el plugin por primera vez, escribe "/vm-cai-dat", "instalar video", "verificar máquina para video", o cuando un paso de creación de video informa que falta una herramienta.

¿Qué es VideoMotion?

Este skill automatiza la verificación e instalación de todas las dependencias necesarias para el plugin VideoMotion, que se integra con Claude Code. Es especialmente útil en sistemas Windows (con soporte para PowerShell, CMD y Git Bash) y macOS/Linux, y está diseñado para ser usado con la configuración del plugin Claude MotionFly. El skill ejecuta primero un script de diagnóstico (`doctor.py`) que detecta qué componentes faltan: Node.js 22+, ffmpeg/ffprobe/loudnorm, HyperFrames, el entorno Python con paquetes como `vieneu` y `faster-whisper`, y los modelos de voz. Luego, guía al usuario en la instalación de los componentes del sistema (como Node.js y ffmpeg) proporcionando enlaces de descarga, y para los componentes de Python y modelos, ejecuta una instalación automática en segundo plano que crea un entorno virtual, instala las bibliotecas y descarga los modelos (aproximadamente 2-3 GB). Finalmente, sugiere instalar el skill HyperFrames para Claude para mejorar la generación de composiciones de video. El skill está pensado para ser invocado cuando el usuario escribe comandos como "/vm-cai-dat" o "instalar video", o cuando un paso de creación de video detecta una herramienta faltante.

Compatible con✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/andyluu98/VideoMotion/tree/HEAD/skills/vm-cai-dat

Documentación

Instalación de VideoMotion

VideoMotion comparte el entorno Python y los modelos con MotionFly en ~/.motionfly: si la máquina ya ejecuta MotionFly, no es necesario volver a descargar nada.

Variables compartidas para todas las habilidades del plugin (se ejecutan en Bash):

VV="${CLAUDE_PLUGIN_ROOT}"
PY="$HOME/.motionfly/venv/Scripts/python.exe"; [ -x "$PY" ] || PY="$HOME/.motionfly/venv/bin/python"
export PYTHONUTF8=1 HF_HUB_DISABLE_PROGRESS_BARS=1

Paso 1. Verificación

Ejecuta con cualquier Python del sistema (3.10 o superior):

python "$VV/tools/setup/doctor.py"

Lee la tabla de resultados. Las filas con FALTA en el grupo obligatorio (Node.js 22+, ffmpeg, ffprobe, ffmpeg loudnorm, HyperFrames) indica que el usuario debe instalarlos por su cuenta, incluyendo el enlace en la columna de notas. No instales software del sistema por tu cuenta.

Paso 2. Instalación de componentes Python y modelos

Si falta "Entorno Python" o "Voz VieNeu", pregunta al usuario una confirmación (se descargarán aproximadamente 2 a 3 GB: paquetes Python, modelo VieNeu, modelo Whisper large-v3-turbo), y luego ejecuta en segundo plano:

python "$VV/tools/setup/doctor.py" --install > "$HOME/.motionfly/install.log" 2>&1

Este comando crea un entorno virtual en ~/.motionfly/venv (usando uv si está disponible), instala vieneu, faster-whisper, soundfile, numpy, scipy, descarga los modelos, y corrige automáticamente el error de symlink del caché de Hugging Face (ONNX Runtime reporta "External data path escapes model directory").

Paso 3. Skill HyperFrames para Claude

Si la fila "Skill HyperFrames para Claude" aparece como opcional (no instalado), sugiere al usuario ejecutar npx [email protected] skills. Tener estos skills permite escribir composiciones más estandarizadas en el paso de renderizado; sin ellos, aún se puede trabajar gracias al contrato técnico en agents/vm-canh.md.

Finalización

Vuelve a ejecutar el Paso 1. Si ves LISTO, informa al usuario que escriba /videomotion junto con la solicitud de video.

Nota para máquinas sin tarjeta NVIDIA: la voz VieNeu funciona en CPU (aproximadamente 0,4 segundos por cada segundo de voz en una máquina de gama media), la música de fondo usa archivos proporcionados por el usuario o música generada mediante código.