# Plugin de agente Source: [Plugin de agente]() Documentation index: [llms.txt]() Last updated: 2026-07-13 El plugin de agente de ChatCut es el paquete público de npm `@chatcut/skill` (actualmente v0.2.1), que instala una skill de Claude Code llamada “chatcut” más una herramienta de línea de comandos `chatcut` que crea videos editados con IA a partir de un prompt de texto y una lista de URLs de assets o rutas de archivo locales. ## ¿Cómo lo instalo? Ejecuta `npm install -g @chatcut/skill` (`pnpm add -g` y `yarn global add` funcionan igual), y luego reinicia Claude Code. Se requiere una instalación global — la skill invoca el binario `chatcut` directamente desde tu PATH, así que `npx @chatcut/skill submit` no funciona. El paso de postinstalación de la instalación copia SKILL.md a `~/.claude/skills/chatcut/SKILL.md` para que Claude Code detecte la skill automáticamente; ese registro se hace en modo “mejor esfuerzo” y nunca hace fallar la instalación de npm, así que si Claude Code no detecta la skill después, ejecuta `chatcut install` para registrarla manualmente. ## ¿Qué necesito para ejecutarlo? El CLI `chatcut` requiere Node.js 18 o más reciente (`engines.node >=18` en package.json). ## ¿Qué puede hacer el CLI? El comando `chatcut` expone nueve subcomandos: `install` (con una opción `--link`), `update`, `login`, `logout`, `pick`, `submit`, `status `, `watch ` y `help`. El principal es `submit`, que toma un `--prompt ` obligatorio, una o más banderas repetibles `--asset ` (el tipo es `audio`, `gif`, `image` o `video`), y opcionalmente las banderas `--name `, `--resolution <480p|720p|1080p>`, `--format `, `--codec `, `--max-turns ` y `--model `. Si aún no tienes rutas de assets a mano, `chatcut pick` abre un diálogo nativo de selección de archivos e imprime líneas `path:type` que puedes pasar directamente a `submit --asset`. ## ¿Cómo crea un video `chatcut submit`? Apunta `submit` a un prompt y tus medios, y ejecuta todo el pipeline por ti: describes la edición en lenguaje natural y proporcionas los assets como URLs públicas o rutas de archivo local absolutas — ambas se aceptan igual — el CLI las transcodifica localmente y las sube, el agente de ChatCut arma la línea de tiempo del lado del servidor, el video se renderiza en la nube, y recibes de vuelta una URL de descarga firmada. Si no defines `--resolution` ni `--format`, el CLI añade automáticamente una instrucción de exportación a tu prompt que por defecto es video en 1080p. Enviar un trabajo es una operación de pago, así que si el agente alteró tu redacción antes de enviarlo, está obligado a detenerse y mostrarte el texto exacto de `--prompt` para tu aprobación primero. ## ¿Cuánto tarda, y dónde veo el progreso? `chatcut submit` bloquea hasta que el trabajo está completamente terminado — la transcodificación, la subida, el ciclo de edición del agente y el renderizado en la nube se ejecutan todos antes de que retorne — transmitiendo progreso legible a stderr todo el tiempo. Por detrás, consulta el estado del trabajo cada 3 segundos y se rinde con un error de tiempo de espera agotado si el trabajo no ha terminado en 40 minutos. ## ¿Dónde terminan los resultados? Cada ejecución de `chatcut submit` crea un nuevo proyecto de ChatCut — nómbralo con `--name`, o acepta el predeterminado — e imprime de vuelta el `projectId` de ese proyecto junto con el `jobId` del trabajo y una `outputUrl` firmada para el archivo renderizado, como una sola línea JSON en stdout una vez que la ejecución termina. ## ¿Necesito ejecutar `chatcut login` primero? No — si `submit` no encuentra una clave de API guardada, abre tu navegador para iniciar sesión automáticamente y continúa con el trabajo una vez que termines, así que no se requiere un paso separado de `chatcut login` antes de tu primer submit. Ese inicio de sesión abre una ventana del navegador apuntando a la página de inicio de sesión de ChatCut; después de que lo apruebas, el CLI intercambia el resultado por una clave de API de larga duración por detrás, y todo el flujo se agota tras 5 minutos si se deja incompleto. ## ¿Es lo mismo que el “plugin de Codex”? No tal como está hoy — `@chatcut/skill` es exclusivamente una skill de Claude Code: el CLI se registra bajo `~/.claude/skills/chatcut`, y nada en el paquete se integra con OpenAI Codex. Consulta también: [Cómo está organizado el editor de ChatCut](https://pr-444-preview.chatcut.dev/docs/editor-overview). ## ¿Cómo instalo e inicio sesión en el plugin de agente de ChatCut? Instala el plugin globalmente con `npm install -g @chatcut/skill` — `pnpm add -g` y `yarn global add` funcionan igual — y luego reinicia Claude Code. Requiere Node.js 18 o más reciente. Instalarlo también registra `SKILL.md` en `~/.claude/skills/chatcut/` para que Claude Code detecte la skill automáticamente; si ese registro no ocurre (por ejemplo con `--ignore-scripts`), ejecuta `chatcut install` para hacerlo manualmente. Se requiere una instalación global — `npx @chatcut/skill` no funciona desde dentro de Claude Code. No necesitas un paso de inicio de sesión separado: el primer `chatcut submit` abre tu navegador a un intercambio de autorización basado en PKCE, y el flujo se agota tras 5 minutos si no lo completas. Para iniciar sesión de antemano en su lugar, ejecuta `chatcut login`. Consulta también: [Cómo inicio sesión en ChatCut](https://pr-444-preview.chatcut.dev/docs/sign-in-and-account#how-do-i-sign-in-to-chatcut). ## ¿Qué puede hacer el plugin de agente de ChatCut, y cuáles son sus límites? El plugin de agente de ChatCut — el CLI `chatcut`, una skill de Claude Code — crea un proyecto, sube tus medios, ejecuta un trabajo de edición con IA en lenguaje natural, y devuelve una URL de descarga firmada en un solo comando. `chatcut submit` toma un prompt más assets (URLs o rutas de archivo locales); transcodifica el video localmente solo cuando el códec no es compatible con navegadores, la tasa de fotogramas supera los 30fps, o el bitrate supera los 8Mbps, limitando la salida a 1920px en el lado más largo — de lo contrario sube el archivo sin tocarlo. Luego bloquea hasta que el agente del lado del servidor de ChatCut termina de editar y de renderizar en la nube, transmitiendo progreso a stderr y una línea JSON final de `jobId`/`projectId`/`outputUrl` a stdout. Límites: submit consulta cada 3 segundos, agotándose tras 40 minutos. `chatcut status ` verifica un trabajo una vez; `chatcut watch ` consulta hasta 20 minutos. El CLI verifica si hay una versión más reciente cada 24 horas (en caché) y solo avisa — nunca bloquea un comando. Consulta también: [Cómo instalo e inicio sesión en el plugin de agente de ChatCut](https://pr-444-preview.chatcut.dev/es/docs/agent-plugin#c%C3%B3mo-instalo-e-inicio-sesi%C3%B3n-en-el-plugin-de-agente-de-chatcut).