← Artículos

Cómo instalar video-shotcraft en Claude Code

· 5 min de lectura

Para instalar video-shotcraft basta con pegarle el enlace del repositorio a Claude Code y pedirle que instale la habilidad; el agente lo clona y lo enlaza solo. También puedes correr npx skills add Vincentwei1021/video-shotcraft, o clonar el repositorio y enlazarlo a mano dentro de tu directorio de habilidades. Después le pides un video de tu producto y él propone su plantilla Ink Press.

Esta guía es la parte práctica: cómo dejar video-shotcraft funcionando dentro de tu agente y sacar el primer video sin perder la tarde.

Antes de empezar

Necesitas tres cosas, y ninguna es una cuenta nueva:

Las tres vías de instalación

Vía 1: pegarle el enlace al agente

Es la que recomienda el propio repositorio y la más corta. Dentro de Claude Code o Codex, escribe:

```

Install this skill for me:

https://github.com/Vincentwei1021/video-shotcraft

```

El agente clona el repositorio y lo enlaza en tu directorio de habilidades sin que toques nada más.

Vía 2: una línea de terminal

```

npx skills add Vincentwei1021/video-shotcraft

```

Vía 3: clonar y enlazar a mano

Si quieres controlar dónde queda:

```

git clone https://github.com/Vincentwei1021/video-shotcraft.git

cd video-shotcraft

ln -s "$(pwd)" ~/.claude/skills/video-shotcraft

```

Y si trabajas con Codex, el enlace va a `~/.codex/skills/video-shotcraft`.

Tu primera petición

Empieza por la plantilla, no por inventar. Si no le nombras ninguna receta de plano, la habilidad no improvisa: te presenta su plantilla incorporada y te pregunta si la quieres usar.

```

Use video-shotcraft to make a promo for my

product with the Ink Press template.

```

Ink Press son 36,2 segundos, 1920x1080, 30 fotogramas por segundo y 10 planos, con transiciones, cartones de título y el sonido ya fijado. El agente sustituye las capturas, los textos y tu marca dentro de esa estructura.

Cuando ya quieras elegir planos

Antes de pedir nada, abre la galería pública y mira las 214 animaciones moviéndose. Anota los nombres de las que te sirvan. Después se piden así:

```

Use the deck-deal-flyin and row-embed shot

cards to present this feature.

```

Ahí es donde cambia el resultado: dejas de describir sensaciones y empiezas a pedir planos con nombre propio.

Los tres errores al correrlo en un servidor

Si lo quieres dentro de un proceso automático, sin abrir nada, el repositorio documenta las tres paredes con las que te vas a chocar:

  1. Tope de concurrencia. En máquinas de pocos núcleos el render falla pidiendo concurrencia 1. Se pasa con el parámetro de concurrencia.
  2. El modo headless viejo ya no existe. Chrome lo quitó, y apuntar a un Chromium del sistema no arranca. Hay que usar un binario de chrome-headless-shell.
  3. CDN bloqueada. Si el recurso remoto no se alcanza, la descarga automática se rechaza; se resuelve apuntando al binario local.

Con esas tres banderas el render de cuadros desde la plantilla funciona.

Qué haces con el resultado

No te quedas casado con lo que decidió la máquina. El repositorio exporta el proyecto para cargarlo en el editor de la familia CapCut, y adentro siguen siendo editables la velocidad de cada plano, los subtítulos y el audio.

Matiz importante: el README lo marca verificado sobre JianYing, que es la versión china de CapCut, y en macOS 11.2. Si usas la app internacional, pruébalo antes de prometérselo a un cliente.

El error que va a arruinarte el primer intento

Darle una frase vaga. La habilidad hace el storyboard, anima y diseña el sonido, pero no sabe qué tiene de especial tu producto. Si le pides "un video de mi app", te devuelve algo bonito que no vende nada.

Antes de pedir, decide tres cosas: qué tres pantallas prueban el valor, en qué orden van, y cuál es la frase que tiene que quedar. Eso no lo hace la herramienta.

Preguntas frecuentes

¿Cuál es la forma más rápida de instalar video-shotcraft?
Pegarle el enlace del repositorio a tu agente y pedirle que instale la habilidad. Es la vía que recomienda el propio repositorio: Claude Code o Codex clona el proyecto y lo enlaza en tu directorio de habilidades sin que tengas que abrir una terminal ni copiar rutas a mano.
¿Necesito instalar Remotion aparte?
No instalas Remotion como paso separado, pero sí necesitas Node en tu máquina, porque Remotion es el motor de render que la habilidad usa por debajo. La habilidad aporta el oficio y las recetas de plano; el render de los cuadros lo hace Remotion sobre Node.
¿Qué le pido al agente después de instalarla?
Empieza pidiéndole un promocional de tu producto con la plantilla Ink Press. Si no nombras ninguna receta de plano, la habilidad no improvisa: te propone esa plantilla validada de 36,2 segundos y 10 planos, y sustituye dentro las capturas, los textos y la marca de tu producto.
¿Por qué falla el render en un servidor sin pantalla?
Por tres motivos documentados en el repositorio. El tope de concurrencia obliga a pasar concurrencia 1 en máquinas de pocos núcleos, el modo headless viejo de Chrome ya no existe y hay que apuntar a un binario chrome-headless-shell, y si la CDN está bloqueada la descarga automática se rechaza y hay que usar el binario local.
¿Puedo editar el video después en CapCut?
Sí. El repositorio exporta el proyecto para cargarlo en el editor de la familia CapCut, y una vez dentro siguen siendo editables la velocidad de cada plano, los subtítulos y el audio. Ojo al matiz: el README marca esa salida como verificada sobre JianYing, la versión china, y en macOS 11.2.

Fuentes

MÁQUINA IA

La comunidad donde dejas de usar IA y empiezas a dirigirla.

Entrar a la comunidad →