Communitygithub.com

0xsline/openchatcut

Útil para verificar si los cambios realizados por el agente se reflejan en el proyecto y editor de OpenChatCut.

¿Qué es openchatcut?

Este skill proporciona un marco de verificación para confirmar que las ediciones realizadas por un agente de IA en el proyecto OpenChatCut se reflejan correctamente. Define tres niveles de verificación (L0, L1, L2) con requisitos de evidencia crecientes, desde comprobaciones estáticas hasta ejecuciones completas de la aplicación de escritorio. El skill enfatiza el uso de herramientas como `read_project` para inspeccionar la estructura de la línea de tiempo y `view_timeline_frames` o `view_asset_frames` para obtener evidencia visual renderizada. Además, incluye pautas para la inspección de transcripciones de agentes reales, clasificación de brechas de verificación y manejo de casos donde la evidencia visual está bloqueada. Está diseñado para agentes que operan en el editor OpenChatCut a través de herramientas de línea de comandos, sin acceso directo al sistema de archivos local.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xsline/openchatcut/tree/HEAD/src/agent/skills/verification

Preguntar en tu IA favorita

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

Documentación

Verificación

Utilice el nivel de verificación más bajo que demuestre el resultado solicitado:

NivelEvidencia requerida
L0Comprobaciones estáticas como el script de verificación enfocado, npx tsc --noEmit, pruebas y compilación.
L1Una ejecución real del agente contra el editor en localhost:5199, seguida de evidencia estructural y renderizada.
L2La aplicación de escritorio empaquetada completando el escenario del usuario, incluyendo revisión visual humana donde la automatización sea insuficiente.

Los cambios en el comportamiento en tiempo de ejecución requieren L0 + L1. Los cambios solo de lanzamiento y de escritorio también requieren L2 cuando la aplicación empaquetada es el comportamiento bajo prueba.

Prefiera dos señales:

  1. read_project para la estructura: activos, pistas, elementos, colocación de fotogramas, duración de la línea de tiempo.
  2. Una ruta de captura visual para evidencia renderizada en fotogramas exactos.

Utilice view_timeline_frames para obtener evidencia de la línea de tiempo compuesta. Esto verifica la línea de tiempo editada de OpenChatCut: recortes, capas, subtítulos, efectos, marcadores, marcadores de posición, recortes, transiciones y diseño.

Para la inspección de fotogramas de activos de origen sin procesar, elija la ruta más económica según dónde residan los bytes:

  • El agente en esta compilación no tiene acceso al sistema de archivos local; todos los bytes de origen residen en el almacén de medios del proyecto (/media/uploads/). Utilice view_asset_frames con el ID del activo del proyecto; el servidor toma automáticamente una ruta rápida de hoja de contacto de ffmpeg, por lo que ya es la ruta de fotogramas de origen más económica.
  • view_timeline_frames renderiza la línea de tiempo compuesta (la comprobación de la verdad del editor); view_asset_frames muestrea fotogramas de origen sin procesar. Elija según lo que esté verificando.
  • No existe una herramienta get_contact_sheet separada en esta compilación: la hoja de contacto es lo que view_asset_frames / view_timeline_frames ya devuelven.

Utilice artefactos de fotogramas de origen locales/remotos solo para la comprensión de la fuente, selección de momento y decisiones de recorte aproximado, no como resultado editado o prueba de la línea de tiempo.

Para medios solo locales o en proceso de carga, la prueba de la línea de tiempo compuesta puede estar bloqueada hasta que el activo tenga bytes disponibles para el renderizador. La inspección de fotogramas de origen a través de view_asset_frames aún funciona mientras los bytes del activo estén en el disco (/media/uploads/).

Si ambas rutas de prueba visual están bloqueadas, pida al usuario que inspeccione el editor de OpenChatCut directamente e informe el bloqueador explícitamente.

Verificaciones útiles:

  • Después de la importación: read_project({ "view": "assets", "assetId": "<prefijo>" })
  • Después de mover/recortar: read_project({ "view": "timeline" })
  • Después de superposición visual o MG en cualquier medio de la línea de tiempo: view_timeline_frames({ "frames": [30, 45, 75] }), luego revise los fotogramas devueltos.
  • Para selección de fuente solicitada por el usuario o elección de momento visual: muestree imágenes fijas con view_asset_frames e inspecciónelas. Utilice esto solo para elegir archivos fuente, momentos y recortes aproximados. Construya la edición visible como elementos de la línea de tiempo de OpenChatCut. No trate la inspección de fuente sin procesar como verificación de la línea de tiempo ni como permiso para producir el video editado en otro lugar.
  • Para la inspección de fotogramas de origen: llame a view_asset_frames({"assetId":"...","sourceTimesMs":[...]}) después de que read_project({"view":"assets"}) confirme el ID/tipo de activo. Prefiera esto sobre pedir al usuario que vuelva a adjuntar el archivo.
  • Para verificación visual solo local: cargue/registre medios legibles en la nube antes de confiar en la prueba visual del conector.
  • Para validación sin fuente: confirme que el manifiesto de la herramienta expuso los parámetros que utilizó, luego registre la prueba visible en el registro de seguimiento.

Al hablar de segundos, verifique los fps desde read_project o use herramientas adaptadoras que resuelvan fps internamente.

Al informar la ubicación de un elemento de la línea de tiempo, utilice solo la estructura más reciente de read_project para el alias de pista, ID de elemento, inicio, duración e ID de activo. No informe pistas planificadas/predeterminadas ni la intención de llamada a la herramienta como ubicación verificada.

No trate una respuesta JSON de línea de comandos por sí sola como suficiente cuando el usuario pregunta si el editor refleja el resultado. Utilice la URL del editor o prueba visual cuando sea práctico.

Verificación de transcripción de agente real

Después de cada ejecución del agente L1, inspeccione el registro de chat completo antes de informar éxito:

  1. Lea la respuesta final del asistente y cada fila de herramienta creada por la ejecución.
  2. Expanda las filas fallidas o de advertencia y registre el error exacto.
  3. Verifique si hay turnos abortados, reintentos repetidos, propuestas obsoletas, trabajos incompletos y resultados de herramientas que la respuesta final describe incorrectamente como exitosos.
  4. Compare el resultado más reciente de read_project con la línea de tiempo visible.
  5. Para ediciones visuales, inspeccione los fotogramas de la línea de tiempo devueltos en lugar de confiar en el resumen del asistente.

Una ejecución con una línea de tiempo de aspecto correcto pero un error de herramienta no informado no es una aprobación limpia. Corrija la causa o informe el error restante explícitamente.

Si la verificación falla, clasifique la brecha antes de cambiar herramientas:

  • la descripción o el esquema de la herramienta eran insuficientes
  • las instrucciones del skill omitieron un paso
  • read_project no expuso suficiente estado
  • la autorización del editor no se completó
  • la canalización de medios/transcripción falló
  • la renderización en la nube/observación del editor estaba bloqueada

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

0xsline/openchatcut

Connect an MCP-capable coding agent to OpenChatCut and edit local video projects. Use when the user asks to install, connect, or set up OpenChatCut; inspect or edit an OpenChatCut project; work with its timeline, transcript, captions, media, generation, motion graphics, audio, color, or export tools; or recover from an OpenChatCut MCP error.

0xsline/openchatcut

Use when acquiring or importing media into a OpenChatCut project asset library for video editing or creation, including local/attached videos, user-provided paths, public media URLs, web video/audio/image assets, upload fallback decisions, and deciding between import_media, download_media, or manual user action.

0xsline/openchatcut

Use when a OpenChatCut video editing or creation workflow needs export, render, download, share, final delivery, subtitle-file export, render choice, local-only asset handling, or export fallback explanation.

0xsline/openchatcut

AI image generation via Fal.ai, gpt-image-2, nano-banana, MiniMax image-01, and xAI Grok Imagine. Use when the user wants to generate or create an image / picture / still.

0xsline/openchatcut

Use when a OpenChatCut tool call fails or returns an unexpected shape.

0xsline/openchatcut

Music generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.

0xsline/openchatcut

OpenChatCut product knowledge — UI layout, editor features, and how generation providers are configured. Use when the user asks about the product interface, how to use a feature, where to find something, or needs GUI guidance for something the agent cannot do directly. Also use as fallback when a task fails and the user needs to complete it manually in the UI. NOT for live project-state queries ("where are my folders?", "what's on my timeline?", "where is clip X?") — those are answered by `read_project`, not by this skill.

0xsline/openchatcut

AI shader generator for WebGL video effects, transitions, masks, and color grading (LUT / 调色 / 电影感 / film look). Use when the user wants a video effect (滤镜 / 特效), a transition (转场 / crossfade / wipe / cube / 3d), a mask (蒙版 / 遮罩 / reveal), a zoom / push-in (推近 / 推镜头), or a color grade — try the built-in effects (zoom, builtin LUTs) before generating a new shader.

0xsline/openchatcut

AI video generation via Fal.ai, Seedance 2.0, Kling, MiniMax Hailuo, xAI Grok Imagine, and OFox. Use when the user wants to generate a video clip — text-to-video, image-to-video, first/last-frame transitions, reference-guided generation, multi-shot, or generatively editing / extending an existing clip.

0xsline/openchatcut

Text-to-Speech (TTS), voiceover, narration placement/sync, and custom sound effects (SFX) generator. Use when the user wants generated speech from text, wants to add/replace/align narration or voiceover for an existing video/timeline, wants to keep existing voiceover synced after visual retiming edits, needs voice audition/selection, or explicitly wants a newly generated/custom sound effect that is not available in the Sound Effects library.

0xsline/openchatcut

Use when the agent should ask the user for structured input with an in-chat form, including single-select, multi-select, text fields, style pickers, or voice audition choices.

Skills relacionados