Communitygithub.com

Ee1ex/elx-ezvideoedit

Crea videos subtitulados con 2ByteASR MCP: reconocimiento de 3 modelos, revisión, edición, 5 títulos, 3 descripciones, etiquetas y portadas en 3 proporciones. El material original se reubica y se entrega en carpetas individuales. Por defecto solo local; subida opcional.

¿Qué es elx-ezvideoedit?

ELX EzVideoEdit es un skill diseñado para ejecutarse dentro del entorno ELX Workbench, no como un procesador de video independiente. Facilita la creación de videos con subtítulos generados mediante el servicio 2ByteASR MCP, realizando un flujo completo: transcripción con tres modelos (MOSS, FireRed y Qwen3-ASR), revisión humana opcional, edición, generación de 5 títulos diferentes, 3 descripciones cortas, etiquetas y tres portadas en relaciones de aspecto 16:9, 4:3 y 3:4. Todo el proceso se realiza localmente por defecto, entregando cada video en una carpeta dedicada con el video subtitulado, el original, el archivo SRT y los metadatos. La etapa de subida es opcional y debe ser activada explícitamente por el usuario mediante agentes o plataformas externas. Este skill es ideal para desarrolladores y creadores que necesitan un flujo de producción de video totalmente controlado y reproducible, con robusta verificación de integridad (SHA, rutas absolutas) y sin depender de servicios en la nube a menos que el usuario lo solicite.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Ee1ex/elx-EzVideoEdit/tree/main/.agents/skills/elx-ezvideoedit

Preguntar en tu IA favorita

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

Documentación

ELX EzVideoEdit

Este Skill funciona con el ELX Workbench, no es un procesador de video independiente. El bundle-location.json instalado apunta al Workbench real; el CLI dentro del código fuente localiza automáticamente el directorio raíz, o se puede especificar con EZVIDEOEDIT_ROOT. Antes del primer uso, lea la configuración local. El usuario debe configurar los modelos locales, Python, permisos de acceso a MCP y los servicios de texto; no se heredan autorizaciones ni credenciales del autor.

Fase 1: Producción y Entrega

Por defecto se ejecuta hasta la entrega local completa. El usuario selecciona el material, el directorio de salida y el método de revisión manual de subtítulos para este lote; si no se ha seleccionado, se pregunta si se desea omitir o modificar manualmente. Si ya se ha indicado explícitamente que se omita para este lote, se leen los resúmenes frescos de cada video y se registra un skip, sin preguntar de nuevo ni afirmar que la revisión manual está aprobada. No utilice cuentas de plataforma ni conexiones de navegador como condición para la finalización local.

  1. Ejecute node .agents/skills/elx-ezvideoedit/scripts/cli.mjs help, luego verifique las capacidades reales con status. Inicie o reutilice servicios con launch. Las tareas se escriben a través del mismo servicio, no modificando directamente task.json. Consulte los campos detallados en la interfaz local.
  2. Descubra la capacidad native-production/1 mediante tools/list y get_status; tanto la versión oficial 0.9.1 como la verificada 0.9.0 se invocan según el esquema real. Verifique primero la misma instancia de perfil; si es necesario, abra la GUI con node packaging/setup.mjs native-open y luego conéctese con native-connect; la GUI y stdio comparten el mismo perfil. Si faltan modelos, API o permisos, indique la ubicación de la configuración nativa para que el usuario la maneje, sin modificar políticas ni eludir restricciones.
  3. La cadena de calidad es: transcripción principal con MOSS, línea de tiempo a nivel de carácter con FireRed, revisión independiente con Qwen3-ASR, utilizando modelos y Python ya presentes en el sistema local; la segmentación inteligente y la revisión utilizan los servicios de texto guardados de forma nativa. Reporte la ejecución real, la reutilización de caché y las degradaciones por separado; no asuma la finalización basándose en etiquetas de configuración. La corrección de tartamudeos en los subtítulos no equivale a la eliminación de audio/video.
  4. Use native-start para producción en serie, native-state para consultar el estado y native-resume para reanudar. Las herramientas independientes usan native-operation. Después de la vista previa AI, aplique con el mismo job_id, sin reenviar. Si hay tiempo de espera o resultados inciertos, primero verifique job/attempt anteriores; solo reanude después de que el usuario complete la configuración si se requiere configuration_required, no reenvíe ciegamente.
  5. El ámbito nativo scope=current solo permite el proyecto actual; crear o abrir otros proyectos requiere el ámbito library; las capacidades independientes se ejecutan según sus propios permisos. 0.9.x no llama a las interfaces de autorización continua o lotes de tokens de la antigua 0.8.7, y no agrega batch_token a apply_plan / export_subtitles oficial.
  6. Después de save_project formal, exporte el video y el SRT oficial, verificando la misma instantánea del proyecto. native-adopt solo vincula proyectos de origen con el mismo SHA de material. review-inspect lee el número real de sugerencias; si no hay permisos suficientes, mantenga el conteo desconocido. Cuando ya se haya autorizado omitir, guarde review-choice con la firma actual. Las modificaciones manuales las guarda el usuario en el programa nativo; luego review-finish solo reexporta video/SRT, sin volver a ejecutar el reconocimiento para sobrescribir cambios manuales. verification_required usa review-recover para verificar trabajos antiguos, sin reiniciar.
  7. La línea de tiempo degradada sigue las protecciones existentes del servicio. Omitir la revisión humana no equivale a ignorar fallos, errores desconocidos o falta de evidencia temporal. Solo guarde el alcance de protección cuando se haya indicado claramente que se puede continuar de forma conservadora; preserve-review se usa únicamente para revisiones de texto que ya están completas pero parciales y cuyo número de errores solicitado es 0; mantenga todo el texto original y los intervalos protegidos, sin adoptar sugerencias de ese lote, sin reenviar y conservando el recibo partial.
  8. Genere exactamente 5 títulos de diferentes estilos, 3 descripciones diferentes de no más de 50 caracteres y etiquetas independientes basadas en la transcripción real. Las portadas deben ser tres imágenes reales en 16:9, 4:3 y 3:4, verificando el texto, el contenido y la proporción de cada una; no se estiren. Se pueden recomendar combinaciones, pero no se puede falsificar que el usuario ya ha seleccionado.

Continúe dentro del alcance aprobado; cualquier nuevo servicio externo, costo, directorio o cambio de permiso debe ser confirmado según los requisitos actuales del usuario. Al pausar, conserve el video original, el proyecto, la salida y el recibo; al reanudar, primero realice una verificación de solo lectura. Por defecto, ejecute en serie en el diálogo actual; solo delegue a un nuevo diálogo o subagente si el usuario lo solicita explícitamente; el modelo es elegido por el usuario y el anfitrión. "Entregar a Codex" en la web solo guarda la tarea pendiente, no significa que el anfitrión la haya ejecutado.

Entrega en Carpetas

Por cada video, una carpeta llamada <NombreOriginal>_Entrega con los siguientes archivos directamente en la raíz: VideoFinal_ConSubtitulos.mp4, video original (con nombre de archivo original), Subtitulos.srt, TextoParaPublicacion.txt, Portada_16por9.png, Portada_4por3.png, Portada_3por4.png y InstruccionesDeEntrega.txt. Coloque solo el proyecto editable y las dependencias de referencia reales en una subcarpeta "Proyecto".

  • Después de verificar los materiales, mueva el único material original a su lugar con el nombre de archivo original; verifique SHA y ruta absoluta antes y después del movimiento, actualice y valide la referencia del proyecto. No copie un duplicado para hacerlo pasar por el video original de entrega; si ya existen copias duplicadas, liste las rutas, cantidades, tamaños e impacto, y solo procese después de obtener confirmación de eliminación; no sobrescriba el único video original.
  • El proyecto debe corresponder a la misma instantánea del video final/SRT y las dependencias deben estar disponibles; incluya solo los materiales referenciados realmente, no copie toda la caché o proyectos históricos. Las instrucciones de entrega deben combinar el número de cortes, las advertencias de modelo/subtítulos y las conclusiones de verificación; el recibo completo queda en el Workbench.
  • scripts/package-stage1.py --help es el punto de entrada de empaquetado simplificado; tomo la ruta de la tarea, el texto y la portada guardados por el servicio, y el video original se mueve desde el mismo disco de original-root. Deténgase si hay conflictos entre discos o nombres duplicados; no copie de forma implícita y luego elimine. La importación del Workbench aún copiará los materiales de trabajo; no elimine copias de trabajo basándose en esto.
  • Solo considere la entrega completa después de verificar los materiales, resúmenes, códigos de tiempo, proporciones de imagen y dependencias del proyecto. Si no hay candidatos para cortar, reporte 0 real; no finja haber eliminado audio/video. Verifique los paquetes de actualización antes de aplicarlos; conserve las modificaciones del usuario y el historial; no sobrescriba directamente.

Fase 2: Subida Opcional

Por defecto, el usuario utiliza su propio MultiPost existente o la entrada normal de la plataforma. Al final de la Fase 1, proporcione la ruta de entrega y el texto; si aún no se ha indicado la elección de subida, recuerde que se puede subir manualmente; si ya se ha indicado que no se subirá, termine sin preguntar de nuevo. Consulte los límites de la subida opcional para más detalles.

Solo cuando el usuario solicite explícitamente que un Agente lo active, utilice la entrada normal del plugin existente, verificando la cuenta real y la autorización, y deteniéndose justo antes de la publicación final. Si el plugin, inicio de sesión, código de verificación o control fallan, conserve la escena y entregue el control; no use Computer Use automático, inyección de parches ni modificación del plugin. Confirme antes de ejecutar pagos, registros, publicaciones, envío de mensajes o cambios de permisos de cuenta. Que el Workbench prepare un recibo no significa que la subida o publicación se haya realizado con éxito.

Skills relacionados