Motion Skills
← Guías

Cómo instalar un skill en Claude Code, Codex o Cursor

Un skill es una carpeta con un archivo SKILL.md (instrucciones para el agente) más plantillas y scripts. Instálalo una vez y tu agente lo usará cada vez que una petición encaje. La misma carpeta funciona en Claude Code, Codex, Cursor y Gemini CLI; solo cambia dónde va.

Las ubicaciones de las carpetas proceden de la documentación de cada agente, verificadas el 29 de octubre de 2026.

Qué es un skill

Los skills siguen el formato abierto Agent Skills. Un skill es una carpeta, con el nombre del skill, que contiene:

  • SKILL.md: las instrucciones. Una cabecera breve indica el name del skill y una description de cuándo usarlo; el agente lee la descripción para decidir si una petición encaja, y el resto cuando encaja.
  • Referencias: notas más largas a las que remiten las instrucciones, que solo se leen cuando hacen falta.
  • Plantillas y scripts: los archivos que el agente copia o ejecuta, como una plantilla de vídeo, un archivo de brief o una comprobación.

No se instala nada a nivel de sistema ni se crea ninguna cuenta: el agente lee la carpeta y los comandos del skill se ejecutan en tu proyecto.

La forma más rápida: pídeselo a tu agente

Copia el prompt de instalación de cualquier página de skill y pégalo en tu agente:

Read https://claude-motion.com/skills/<slug>/install.md and follow it to install the "<slug>" skill, then make a first video with it.

El agente lee la guía y ejecuta un solo comando: npx motion-skills install <slug>. La primera vez se abre una página en tu navegador: inicia sesión con Google y aprueba el código que muestra tu terminal. Si es un skill de pago que aún no tienes, en la misma página puedes comprarlo y la instalación termina sola. Después el agente hace un primer vídeo. (Si el comando no puede ejecutarse, la guía pasa a una descarga en tu navegador.)

Instalación manual

  1. Descarga el ZIP desde la página del skill.
  2. Descomprímelo de forma que la carpeta conserve su nombre (<slug>/SKILL.md):
    • Claude Code: ~/.claude/skills/<slug>/, o .claude/skills/<slug>/ dentro de un proyecto
    • Codex: ~/.agents/skills/<slug>/
    • Cursor: .cursor/skills/<slug>/ dentro del proyecto
    • Gemini CLI: ~/.gemini/skills/<slug>/
  3. Inicia una nueva sesión del agente para que cargue el skill.
mkdir -p ~/.claude/skills
unzip -o ~/Downloads/kinetic-type-title.zip -d ~/.claude/skills/

Lo que necesitas en tu máquina

  • Node.js 22 o superior
  • FFmpeg (brew install ffmpeg en macOS)
  • Google Chrome (el renderizador lo controla en modo headless)

Los skills de vídeo completo y el skill gratuito Motion Director funcionan con nuestro motor abierto motion-skills (mo), que se instala solo a través de npx la primera vez que renderiza; las plantillas de movimiento usan la CLI de HyperFrames, que se instala igual. No hace falta ninguna clave de API.

Usar un skill

Con una plantilla de movimiento, solo pídelo: "Haz una tarjeta de título en 9:16 que diga Ship faster, sleep better." El agente copia la plantilla, escribe un brief.json, ejecuta hyperframes check, revisa fotogramas de muestra para detectar problemas de diseño y luego renderiza el MP4 y te dice dónde está.

Con un skill de vídeo completo, dale tu material a tu agente y dile para qué es el vídeo. Te muestra tres direcciones como fotogramas reales, escribe una hoja de ritmo y una banda sonora original, pasa las comprobaciones de mo y una revisión, y luego renderiza el MP4 en tu propio Chrome.

Para una guía completa con un vídeo de ejemplo real, consulta Cómo hacer un vídeo con Claude Code. Para Codex, Cursor o Gemini CLI, con todas las carpetas que lee cada uno, consulta Cómo hacer vídeos con Codex, Cursor o Gemini CLI.

Solución de problemas

  • El agente no usa el skill. Inicia una nueva sesión después de instalarlo; los agentes leen sus skills al empezar una sesión (en Gemini CLI, /skills reload lo hace sin salir). Después vuelve a pedirlo nombrando el skill: "use the changelog-video skill". Revisa también la carpeta: SKILL.md tiene que estar directamente dentro de <slug>/, no un nivel más abajo después de descomprimir.
  • "FFmpeg not found". Instálalo (brew install ffmpeg en macOS) y abre una terminal nueva para que esté en tu PATH.
  • "Chrome not found". Instala Google Chrome; el renderizador lo controla en modo headless. Los skills de vídeo completo lo comprueban antes por ti con mo doctor, y las plantillas de movimiento con node kit/doctor.mjs.
  • La página de inicio de sesión no se abre. La terminal muestra la dirección y el código; abre tú la dirección e introduce el código.

Preguntas

¿Dónde pongo un skill para Claude Code?

En ~/.claude/skills/<slug>/ para todos tus proyectos, o en .claude/skills/<slug>/ dentro de un proyecto. La carpeta conserva el nombre del skill y contiene su SKILL.md. Inicia una nueva sesión de Claude Code para que cargue el skill.

¿Qué es SKILL.md?

Un archivo de instrucciones para el agente, dentro de la carpeta de un skill junto con plantillas y scripts. Su cabecera nombra el skill y dice cuándo usarlo; el agente lo lee cuando una petición encaja.

¿Los skills funcionan en Codex, Cursor y Gemini CLI?

Sí. La misma carpeta funciona en cada uno; solo cambia la ubicación: ~/.agents/skills/<slug>/ para Codex, .cursor/skills/<slug>/ en el proyecto para Cursor y ~/.gemini/skills/<slug>/ para Gemini CLI.

¿Necesito una clave de API?

No. Los skills se ejecutan en tu ordenador con Node.js, FFmpeg y Chrome, y los motores se instalan solos a través de npx. El único inicio de sesión es una cuenta gratuita de Google en este sitio, para descargar.