Communitygithub.com

editar

La etapa de edición: los bloques renderizados se convierten en la película terminada, en el programa que indica `config.json` (`editor.id`). Úsalo para "/edit", "editar la película", "montarla", "abrirla en Resolve", "hacer el video final". `none` = el agente edita solo con ffmpeg (la habilidad `assemble`). Cualquier programa = editar EN ese programa: MCP para las operaciones precisas Y uso de computadora para mirar la pantalla y verificar, juntos, nunca solo MCP. Lee `editor.mcp` / `editor.computer_use` y pregunta antes de tomar el control de la pantalla. Nunca genera material, nunca agrega música.

¿Qué es editar?

La habilidad 'editar' transforma los clips renderizados en la película final, trabajando directamente en el programa de edición especificado en `config.json` (`editor.id`). Es útil porque permite una edición profesional en herramientas como DaVinci Resolve, Premiere Pro, Final Cut Pro o CapCut, combinando el control preciso de MCP con la verificación visual del uso de computadora. Admite dos modos principales: si `editor.id` es `none`, el agente edita automáticamente con ffmpeg usando la habilidad 'assemble'; si se especifica un programa, el agente utiliza MCP para operaciones exactas (crear proyecto, importar clips, añadir marcadores) y el uso de computadora para confirmar visualmente cada paso, asegurando que no haya errores. La habilidad verifica siempre que todos los clips existan antes de comenzar, y por diseño nunca agrega música ni genera nuevo material, dejando esas tareas al autor. Es ideal para flujos de trabajo profesionales donde la edición final debe realizarse en una NLE real, con la flexibilidad de funcionar incluso sin MCP o sin uso de computadora, generando un archivo EDL como alternativa.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bidah/storyseam/tree/HEAD/.claude/skills/edit

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

/edit — clips → película, en el programa que la historia nombre

La película se monta donde el autor seguirá trabajando en ella. config.json indica dónde:

"editor": { "id": "davinci_resolve", "mcp": true, "computer_use": true }
ClaveSignificado
idnone — editas solo con ffmpeg. O el programa: davinci_resolve, premiere_pro, final_cut_pro, capcut, o cualquier otro nombre que el autor dé.
mcptrue cuando el servidor MCP de ese programa está instalado y conectado en tu cliente.
computer_usetrue cuando puedes manejar la pantalla (uso de computadora de Claude, o el equivalente de tu herramienta).
notesTexto libre opcional: la versión del programa, edición, ubicación del proyecto.

La ausencia de la clave editor equivale a { "id": "none" }.

Paso 0 — verificar los clips (cada ruta)

Haz primero el Paso 1 de la habilidad assemble, sea cual sea el editor: cada bloque tiene un clip, en orden, en su duración real. Una edición construida sobre un bloque faltante es una película con un agujero.

Ruta A — editor.id: "none": tú eres el editor

Sigue la habilidad assemble. La salida es renders/final/film.mp4. Esa es toda la etapa.

Ruta B — un programa: editar en él

B1. Comprueba lo que puedes alcanzar, luego dilo

Antes de tocar nada, confirma lo que config.json afirma:

  • MCP: llama a una herramienta de solo lectura en el servidor del programa (para DaVinci Resolve, la lista de proyectos o líneas de tiempo). Si falla, imprime la línea de instalación de ese servidor desde config.json mcp_servers (npx storyseam mcp --agent <el_tuyo>; para Resolve, npx davinci-resolve-mcp setup) y espera. Establece editor.mcp a false solo después de que el autor confirme que el servidor no debería estar allí. Nunca lo instales tú mismo.
  • Uso de computadora: toma una captura de pantalla y confirma que el programa está abierto, o que se puede abrir.

Luego dile al autor en una línea en qué modo trabajarás, y pregunta antes de tomar el control de la pantalla: el uso de computadora mueve su ratón y teclado.

B2. Trabaja MCP y uso de computadora JUNTOS

Ninguno es suficiente por sí solo, y los mejores resultados provienen de usar ambos en cada paso:

  • MCP hace el trabajo preciso y repetible: crea el proyecto y la línea de tiempo en la resolución y velocidad de fotogramas de la historia, importa renders/clips/block_NN.mp4 en orden de bloque, coloca cada uno en V1/A1 consecutivamente, añade marcadores por bloque desde shotlist/shotlist.json, configura los ajustes de renderizado e inicia el renderizado. Valores exactos y sin clics erróneos.
  • El uso de computadora son tus ojos, y tus manos donde la API se queda corta: captura de pantalla después de cada paso de MCP para confirmar que hizo lo que reportó, recorre cada unión en el visor y mira los fotogramas a ambos lados, comprueba los medidores de audio, y maneja cualquier cosa que el MCP no exponga (un diálogo, un panel, un arrastre, un ajuste sin API).
  • Nunca confíes en un mensaje de éxito de MCP que no hayas mirado. Un clip importado a la velocidad de fotogramas incorrecta, una línea de tiempo en la resolución incorrecta, o una cola de renderizado vacía, todos reportan éxito.

Cuando solo uno está disponible:

mcpcomputer_useCómo trabajas
truetrueAmbos, como arriba. El predeterminado y el mejor.
truefalseSolo MCP. Di que la edición no está verificada visualmente y pide al autor que revise las uniones ellos mismos.
falsetrueSolo uso de computadora. Es más lento, así que informa al autor, y mantén los pasos pequeños con una captura después de cada uno.
falsefalseNo puedes manejar el programa. Escribe renders/edit/timeline.edl (CMX 3600, un evento por bloque en orden, desde shotlist.json y las duraciones reales de los clips), dile al autor cómo importarlo, y también produce renders/final/film.mp4 mediante la habilidad assemble para que haya una película de todas formas.

B3. La edición

  1. Un proyecto con el nombre del title de storyseam.md, en la resolución y velocidad de fotogramas reales de los clips (ffprobe a un clip; no asumas).
  2. Una línea de tiempo. Los bloques en V1 y su audio en A1, en orden, sin espacios ni superposiciones.
  3. Un marcador por bloque, nombrado con su id de bloque y primer plano.
  4. Deja una pista de música vacía (A2) para el autor. Nunca agregues música. La banda sonora es del autor, en assets/audio/music/.
  5. Renderiza a renders/final/film.mp4 (H.264, AAC, la resolución de la línea de tiempo), y guarda el archivo de proyecto del propio programa donde el programa lo guarde. Registra esa ruta en editor.notes.

B4. Notas sobre programas

  • DaVinci Resolve. Su servidor MCP maneja la API de scripting de Resolve. El scripting externo es solo para Studio; en la edición gratuita, el puente dentro de la aplicación (Workspace › Scripts) es la vía de entrada, y en la versión gratuita 21.1+ la funcionalidad de scripting de Python ha desaparecido, así que espera apoyarte en el uso de computadora allí. Usa la página de Edición para la línea de tiempo y la página de Entrega para renderizar; confirma la cola de renderizado en una captura de pantalla antes de iniciarla.
  • Cualquier otro programa. Busca primero su servidor MCP. Si no hay ninguno, es la fila mcp: false de arriba. No instales software, complementos ni servidores MCP por tu cuenta; dile al autor qué le ayudaría y deja que él lo haga.

Último paso — informe

La ruta a la película, su duración y resolución reales, el archivo de proyecto del programa, en qué modo trabajaste (MCP + uso de computadora, solo uno, o EDL), cualquier cosa que no pudieras verificar visualmente, y que no hay música por diseño.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados