/video-setup
Obtén el banco de trabajo desde un clon nuevo hasta passed N, failed 0 en un solo paso. setup.sh hace el trabajo; tu labor es explicarlo, obtener un sí, ejecutarlo y convertir cada línea FAIL en su solución.
Primero, encuentra el banco de trabajo (esto funciona desde el banco de trabajo y desde una carpeta de producto):
PVS_HOME="$(cd "$(cd "${CLAUDE_SKILL_DIR}" && pwd -P)/../.." && pwd)"
Habla con el usuario en su idioma. Sé breve: quieren una configuración funcional, no un recorrido.
Con el argumento check
Ejecuta bash "$PVS_HOME/setup.sh" --check y muestra el resultado. No instala nada, no descarga nada y no escribe nada. Para cada línea FAIL, da su solución (la línea termina con ella). Detente ahí.
De lo contrario
1. Reporta la máquina
Ejecuta primero bash "$PVS_HOME/setup.sh" --check. Imprime una línea por elemento: ok, warn o FAIL con la solución exacta.
- Si una línea bajo Máquina falla (node 22+, python 3.9+, ffmpeg, git), la configuración no puede continuar. Dale al usuario la solución que aparece en la línea (por ejemplo
brew install ffmpeg) y pídele que la ejecute en su terminal, luego ejecuta la verificación de nuevo. Instalar paquetes del sistema es decisión del usuario, así que no ejecutesbrewniapta menos que te lo pidan. - Un
warnen Claude Code es solo informativo. - Las líneas FAIL bajo Toolchain son lo que la configuración instalará. Eso es esperado en la primera ejecución.
2. Di qué se descargará, y pregunta una vez
Dile al usuario, en una lista corta, solo las piezas que la verificación reportó como faltantes:
| Pieza | Tamaño | Dónde |
|---|---|---|
| CLI de HyperFrames en la versión anclada, con sus dependencias | unos 128 MB | node_modules/ |
| La compilación de Chrome con la que renderiza HyperFrames | unos 195 MB (omitido si está en caché) | la caché de HyperFrames |
| Skills de agente de HyperFrames desde el mismo tag de versión | unos pocos MB | vendor/hyperframes/skills/ |
| Paquetes Python, principalmente torch para voz a texto | unos 339 MB | .venv/ |
El modelo de voz small.en de whisper que usa el QA | 484 MB | ~/.cache/whisper/ |
Pregunta una pregunta cerrada: "¿Instalar esto ahora? (sí / no)". La configuración debe ocurrir en un solo paso desde el primer /video-setup, así que no la dividas en varias confirmaciones.
3. Ejecútalo
Ante un sí, ejecuta bash "$PVS_HOME/setup.sh" --yes (el --yes es la respuesta del usuario, ya dada). Tarda unos minutos en la primera ejecución y segundos cuando todo está en caché; usa un tiempo de espera de al menos 10 minutos. Es idempotente: ejecutarlo de nuevo solo rehace lo que falta.
4. Maneja cada FAIL
Cada línea FAIL nombra su solución. Las comunes:
| FAIL | Qué hacer |
|---|---|
npm install failed | Problema de red o registro. Muestra las últimas líneas del registro que nombra, luego ejecuta la configuración de nuevo |
hyperframes browser ensure failed | Ejecuta npx hyperframes browser ensure --force desde el banco de trabajo, luego la configuración de nuevo |
could not clone heygen-com/hyperframes | Problema de red o acceso a GitHub. Verifica git ls-remote https://github.com/heygen-com/hyperframes, luego la configuración de nuevo |
python3 -m venv failed | En Debian o Ubuntu: sudo apt install python3-venv (el usuario lo ejecuta) |
pip install -r requirements.txt failed | Muestra el final del registro. Un Python más nuevo que las versiones ancladas puede necesitar una rueda más reciente; infórmalo en lugar de editar los anclajes |
hyperframes doctor: ... | La línea nombra la verificación que falla y su solución. Las comprobaciones de versión, Docker y las opcionales de voz local y música se ignoran intencionadamente |
tests/run.sh: passed N, failed M | Ejecuta bash "$PVS_HOME/tests/run.sh" y muestra las pruebas que fallan con su salida |
Nunca "arregles" un FAIL ejecutando hyperframes upgrade o hyperframes skills update. El banco de trabajo ancla una versión de HyperFrames y toma sus skills del mismo tag, porque un CLI y skills de diferentes versiones no se ponen de acuerdo sobre el contrato de composición. Un cambio de versión es un pull request que pase tests/run.sh. El hook de guardia bloquea ambos comandos de todos modos.
5. La clave de voz
La configuración crea .env a partir de .env.example y te dice si la clave de ElevenLabs está establecida, sin imprimirla. Si está vacía, dile al usuario:
- Abre
.env(en la carpeta del banco de trabajo) en su propio editor y pega la clave después deELEVENLABS_API_KEY=. Nunca en el chat: cualquier cosa en el chat se almacena en la transcripción. Si la pegan aquí de todos modos, diles que la roten. - Sin clave,
voice.provider: sayen elproduct.yamlde un producto usa las voces gratuitas de macOS, suficientemente buenas para borradores y pruebas.
Nunca abras, leas ni imprimas .env tú mismo. La configuración lo niega y el hook de guardia lo bloquea, y los scripts cargan la clave a través de lib/pvs.py por su cuenta.
6. Cierre
Confirma que las últimas líneas de la salida digan passed N, failed 0 y Setup done. Luego da el siguiente paso en una línea: /product-new <slug> para traer su producto, o /video-ask para ver cómo están las cosas.