Communitygithub.com

adunext/adu-motion-video

Utiliza paquetes de animación completos para crear videos de movimiento editables y MP4 a 60 fps a partir de nuevas locuciones, guiones y material propio; también admite TPL ligero, continuación de dibujos a mano, subtítulos y modificación de videos existentes. Requiere un agente con acceso de lectura/escritura a archivos locales y capacidad para ejecutar comandos.

¿Qué es adu-motion-video?

Esta habilidad de agente de IA (para Claude Code, Cursor, Codex, etc.) permite la producción profesional de videos de animación dinámica a partir de locuciones, guiones y material propio del usuario. Su propósito principal es tomar una locución de voz en off ya editada, el texto correspondiente y, opcionalmente, subtítulos con marcas de tiempo, y combinarlos con plantillas de animación completas y empaquetadas para generar un proyecto de animación editable (como un archivo de proyecto de After Effects) y exportarlo a un video MP4 de 60 fps. La habilidad está diseñada para ser utilizada por agentes de IA que puedan ejecutar scripts de shell y manipular archivos locales; por lo tanto, su audiencia principal son desarrolladores y usuarios avanzados que desean automatizar flujos de trabajo complejos de postproducción de video. La habilidad se basa en un sistema de paquetes de animación con versiones explícitas (por ejemplo, `[email protected]`). El agente primero selecciona el paquete de animación adecuado según el estilo o número de plantilla solicitado por el usuario, consultando catálogos de plantillas y documentación de referencia. Luego, ejecuta un pipeline (definido en `scripts/pipeline.sh`) que incluye pasos como la planificación macro (`macro-plan`), la construcción (`macro-build`), la verificación de fotogramas (`stills`), la mezcla de audio y la renderización final. Un aspecto crítico es que no se trata de una simple superposición de texto; el agente debe adaptar las coreografías de escena completas de los paquetes a las nuevas líneas y duraciones, respetando restricciones técnicas como la velocidad original de los marcos de acción y la verificación de que los tiempos de las locuciones coincidan con los fotogramas planificados. Se enfatiza la verificación manual o asistida de la calidad final, incluyendo la revisión de subtítulos, sincronización de labios, y la ausencia de marcas de agua o datos de plantillas de origen. La habilidad también cubre casos de uso más ligeros (como plantillas TPL básicas) para videos cortos o exploración de diseños, y métodos para animación dibujada a mano. En resumen, automatiza la adaptación de complejas animaciones profesionales a nuevo contenido de voz y texto, asegurando consistencia y calidad técnica.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add adunext/adu-motion-video

Preguntar en tu IA favorita

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

Documentación

¿Qué hace adu-motion-video?

El usuario proporciona un video de locución ya editado, el guion y, preferiblemente, subtítulos con marcas de tiempo de la nueva locución. Cuando se eligen escenas que incluyen grabación de pantalla, muro de trabajos, avatar, logotipo o música de fondo, también se debe proporcionar el material que se tiene derecho a usar en esta edición. Tu tarea es adaptar la coreografía de la escena completa a las nuevas líneas y duración, generar un proyecto editable, verificarlo y exportar un nuevo MP4. Primero, lee las Reglas de producción. SKILL_DIR es el directorio de este archivo, y PL="$SKILL_DIR/scripts/pipeline.sh". El registro de producción guarda la ruta real de la Skill, la versión y el punto de entrada utilizado; el código de ejecución congelada de instalaciones antiguas con el mismo nombre, versiones del repositorio y proyectos generados puede ser diferente; no se debe usar la última versión de la documentación para confirmar proyectos antiguos.

Selección del punto de entrada

Cuando el usuario especifique un número de plantilla (por ejemplo, 01-B) o solicite elegir un estilo, primero lee el Catálogo de plantillas y estilos y asigna a una versión explícita del paquete según la asignación "plantilla de nivel 1 → estilo de nivel 2". Los estilos no publicados no pueden prometerse como paquetes publicados. Cuando se necesiten materiales de animación auxiliares, búscalos y descárgalos en el proyecto actual usando la API de materiales de animación públicos, y luego verifica los requisitos de medios y renderizado del paquete seleccionado.

Cuando el usuario añada un proyecto completado, refina un nuevo conjunto de tomas o actualice la biblioteca de plantillas, lee Incrustación continua de plantillas. Primero registra la fuente y el estado real, luego refina según el valor; recibir un proyecto no significa que ya haya una plantilla publicable. bash "$PL" packs solo lista los metadatos semánticos y de versión de los paquetes, carga el manifiesto relevante según la tarea; cuando un mismo ID tiene múltiples versiones, selecciona explícitamente id@version.

Cuando el usuario especifique 03 · 3D oscuro / 03-A · Exhibición multipantalla, lee la Plantilla 3D oscura y selecciona [email protected]. Esta conserva nueve escenas de muro de trabajos, comparación multipantalla, ampliación de enfoque y coreografía de ventana de software, con un nuevo diseño vertical nativo de 1080×1920. La versión 1.1.1 completa la verificación de color para la extracción de fotogramas HDR y la exportación SDR; las instalaciones anteriores en frío pertenecen a la versión 1.1.0, y aún se espera la confirmación audiovisual continua del autor; selecciona escenas completas según el material de esta edición, sin contar en los diecisiete grupos estables. La versión anterior 1.0.0 mantiene sus bytes originales.

  1. Por defecto, ejecuta bash "$PL" packs, selecciona una versión explícita según el propósito de la expresión, lee el README.md y manifest.json del paquete relevante, y consulta las Instrucciones de reutilización de proyectos completos. [email protected] conserva la compensación de picos, la respuesta del personaje y la estabilización, con tres grupos verificados; [email protected] conserva la transformación del mismo objeto, descomposición y cierre, con dos grupos verificados. [email protected] es un grupo de continuación de perspectiva en papel. El alcance estable se limita a macOS 1080p60 verificado, y no significa que toda la fuente o cualquier guion esté ya en plantilla; los límites de cada grupo se encuentran en la Matriz de capacidades. Las versiones candidatas antiguas se conservan, y los grupos de interferencia planificados de B aún están en estado candidato. Los anim3/anim4 antiguos tienen 12/9 escenas completas respectivamente, y aún son experimentales. Los ID de los paquetes no están relacionados con los títulos originales de los videos ni con las marcas. [email protected], [email protected] y [email protected] de C/D/E tienen tres grupos estables cada uno, que conservan respectivamente la capa frontal/trasera y la cesión de espacio del personaje, la división y cruce de columnas, y la respuesta de palabras completas y entidades. Cada ruta fue producida por un ejecutor que no participó en el refinamiento, partiendo de un paquete público congelado y la entrada de esta edición para crear una nueva película de 99.5 segundos, y el autor confirmó su validez. Los bytes originales de los candidatos antiguos se conservan; el puente de esta edición no cuenta como un grupo público estable.
  2. Cuando solo se necesite un video corto ligero o explorar diseños, usa las 9 plantillas básicas TPL; son de inicio rápido y no contienen todas las acciones del paquete de proyecto completo.
  3. Para personajes dibujados a mano o continuación de tomas con la misma lente, lee el Método de animación dibujada a mano. Actualmente no hay un paquete de proyecto completo correspondiente; no se debe llamar al documento de método como una plantilla automática.

La versión 3.3.0 añadió 02-B · Agregación de papel [email protected]: seis tipos de materiales se agregan en una red, además de dos grupos estables: siete pasos de calendario, seis tipos de capacidades, tres desempaquetados y apilamiento de tarjetas de entrega. La comparación fuente/reproducción y una muestra de 18.2667 segundos con contenido diferente han recibido confirmación audiovisual del autor. Se necesita locución/guion real de esta edición, y proporcionar explícitamente una fuente de título con SHA fijo; consulta la Descripción del paquete. Esta es una adición a nivel de grupo, no una nueva ruta de película completa; los problemas estrictos de cuadrícula se mantienen en review.json. Los quince grupos estables de la versión 3.2.0 y los candidatos antiguos mantienen sus bytes originales; actualmente hay siete estilos con un total de diecisiete grupos estables.

Flujo del paquete de proyecto completo

La versión 3.6.0 añadió la reasignación local de storyboard actual y la verificación de versiones de materiales, así como el procesamiento de color compartido para la extracción de fotogramas de video genérico. 04-A · Demostración en consola El candidato actual [email protected] añade un diseño de texto con límites; la reproducción técnica del mismo contenido de los tres grupos de la versión 0.1.1 se conserva; la verificación de un nuevo guion silencioso no reemplaza la verificación audiovisual completa de una nueva locución o la validación de reutilización independiente; consulta la Descripción de la plantilla. Las nuevas vistas previas unificadas usan el comando preview con evidencia de exportación y verificación de versión.

Para un nuevo guion, primero forma un brief.json según el Mecanismo de adaptación del sistema, luego ejecuta bash "$PL" macro-plan IDPaquete@versión /ruta/brief.json /ruta/nuevoDirectorioPlan. Este punto de entrada filtra según la fase semántica, la cantidad, la ventana de acción a velocidad original y las dependencias de escenas anteriores/posteriores, y luego reduce la repetición de efectos dentro de combinaciones válidas. Los 26 grupos completos de 8 paquetes de estilo ya tienen perfiles de adaptación verificados con código, pero la capacidad sigue siendo adaptation-experimental. La salida es spec.json/report.json/report.md/profile.json; el código de salida 0 significa que la verificación de vinculación fue exitosa, 2 significa que se guardó un borrador pendiente o bloqueado, y 1 significa entrada no válida. Si faltan marcas de tiempo para palabras clave de medios o contenido real, modifica el brief y vuelve a planificar; no completes marcas de tiempo de demostración de origen. macro-spec se conserva como punto de entrada de receta histórica/manual; no proporciona esta capa de diagnóstico semántico y de adyacencia; las nuevas producciones deben priorizar el plan con adaptation, y la construcción lo volverá a verificar.

Cuando se añadan nuevos materiales a un plan existente, ejecuta macro-rematch según la Reasignación local de storyboard, verifica las sugerencias y guarda en un nuevo directorio mediante macro-apply-rematch. Fija la semántica, el tiempo y otros storyboards del segmento original, y vuelve a verificar los medios y las costuras bilaterales; si la línea base o los materiales han cambiado, rechaza la aplicación. Si no hay un nuevo grupo compatible, conserva el grupo original; no intercambies efectos al azar ni adivines asignaciones de texto de otras plantillas. Esta interfaz es para ser llamada por herramientas de producción; aún no está integrada en la interfaz de arrastrar y soltar de ADuDir.

  1. Ejecuta bash "$PL" doctor para verificar Node, Python, FFmpeg y Chrome; si faltan dependencias y se permite la instalación, ejecuta bash "$PL" setup. Mantén el proyecto fuente y el video final original como solo lectura, y la salida debe ser en una nueva ruta que no exista.
  2. Primero, bloquea la fuente de plantilla especificada por el usuario. Otros anim, nuevos proyectos o videos finales antiguos en el directorio de materiales no se convierten automáticamente en borradores de animación; no se puede insertar solo unos pocos fragmentos de plantilla y afirmar que todo el video usa la plantilla especificada. Registra el paquete de origen y el ID de escena para cada escena; para la mezcla de paquetes completos, consulta Origen y orquestación de múltiples paquetes. Alinea la nueva locución y el guion, obteniendo el tiempo preciso de las líneas clave. Cuando el SRT solo tiene tiempo de oración completa, no adivines el tiempo de una palabra dentro de la oración; usa datos de alineación palabra por palabra o anotación manual. Lee role, cues, motionWindows y slots del paquete, y selecciona, reordena o repite escenas completas según el significado. Primero, lista el storyboard y los materiales faltantes.
  3. Escribe un brief según la nueva locución, ejecuta bash "$PL" macro-plan IDPaquete@versión /ruta/breif.json /rutaPadreExistente/nuevoDirectorioPlan; revisa el informe, si faltan elementos, completa el brief y vuelve a planificar, y usa el spec.json generado para la construcción. Antes de renderizar, verifica la fase con el diálogo real, los puntos de impacto de eventos clave, la identidad del material y la repetición en todo el video, según la Verificación de contenido antes de la reutilización. El planificador verifica la estructura declarada, pero no juzga si la fase ingresada es fiel al diálogo. Usa macro-spec solo para mantener recetas históricas manualmente; sus cues están vacíos, y el texto de ejemplo y la duración del video original son solo para familiarizarse con la interfaz; debes completar el contenido de esta edición y las marcas de tiempo reales, y no agregar mecánicamente el mismo desplazamiento a cada grupo repetido. brand se completa con la cuenta de esta edición. La música de esta edición se puede especificar con music:{mode:"track",path,offset}; si no se especifica, se recompone según la estructura de composición original. La ventana del personaje usa por defecto Vision en macOS para rastrear la cara de la nueva locución; si no se puede rastrear automáticamente, se debe configurar explícitamente un faceTracking:{mode:"fixed",cx,cy,h} verificado. Cualquier dato de demostración de origen o texto de ejemplo debe ser reemplazado o marcado claramente como "ilustrativo". Las rutas vacías de materiales representan elementos faltantes; las limitaciones de medios y capacidad se consultan en el README.md del directorio del paquete.
  4. bash "$PL" macro-build IDPaquete@versión /ruta/nuevoDirectorioPlan/spec.json /ruta/locuciónEditada.mp4 /ruta/nuevoProyecto [--subs-js /ruta/subtítulos.js]. La duración de la nueva locución debe ser coherente con el número total de fotogramas planificados. El adaptador bloquea las ventanas de acción clave a la velocidad original; para párrafos más largos, solo extiende las zonas de permanencia permitidas; si el tiempo es insuficiente, reportará un error, requiriendo cambiar el storyboard o la longitud del segmento, sin recurrir a un estiramiento lineal de todo el video. También reportará un error si faltan texto, números, medios o cues clave.
  5. bash "$PL" stills /ruta/nuevoProyecto 0,4,12,... para muestrear el primer fotograma, el antes/después de cada cue, el texto más largo, las costuras de escena y el final; en ventanas pequeñas, se deben ver ambos ojos, la boca y la barbilla; el parámetro fixed debe determinarse a partir del material de esta edición y verificar posturas extremas como inclinación hacia abajo o hacia arriba; luego, reproduce todos los intervalos de movimiento complejos y compáralos con el proyecto original. Verifica la fuente, la proporción/recorte de medios, la sincronización de labios real, los subtítulos, los efectos de sonido y la música. Revisa la configuración o el proyecto y vuelve a verificar.
  6. bash "$PL" audio /ruta/nuevoProyecto → bash "$PL" mix /ruta/nuevoProyecto → bash "$PL" render /ruta/nuevoProyecto /ruta/nuevoVideo_v1.mp4 → bash "$PL" check /ruta/nuevoVideo_v1.mp4. Visualiza y escucha completamente el archivo codificado final; el recuento de fotogramas, la decodificación y el volumen de check no pueden reemplazar la verificación visual y de contenido. Las nuevas vistas previas se publican de manera unificada mediante bash "$PL" preview /ruta/nuevoProyecto /ruta/nuevoVideo_v1.mp4 /rutaPadreExistente/nuevoDirectorioPreview, vinculando el SHA real del video final, mostrando la versión de reproducción y sugiriendo actualizar las pestañas antiguas. Los riesgos de HDR/DV, profundidad de bits de origen y metadatos deben dejar evidencia de comparación real según Color de materiales y vista previa, no solo verificar etiquetas.

Para una experiencia rápida con plantillas básicas, usa bash "$PL" demo /nuevoDirectorioQueNoExiste. Para combinar TPL desde cero para una locución real, hazlo según el Directorio de plantillas y el Esquema de subtítulos, y aún se requiere una verificación completa.

Verificaciones obligatorias

  • La captura de fotogramas de la locución debe basarse en el reloj de salida objetivo; la animación de la escena fuente se ejecuta según el reloj de coreografía original mapeado. La escena original no debe controlar la sincronización de labios real, ni se deben usar fotogramas congelados de la persona real para compensar la duración faltante.
  • Si el primer fotograma es el inicio de la locución, se debe ver a la persona real y el tema; verifica el color del borde, el tamaño de fuente y las zonas seguras de los subtítulos; no se deben dejar la marca, la fecha, los valores numéricos o el texto de marcador de posición del video de plantilla original en el nuevo video.
  • Verifica los segmentos continuos de cada ventana de protección de acción, no solo una imagen fija; verifica la grabación de pantalla, el mosaico de nueve cuadros y el muro de trabajos con el material real de esta edición. La música y los efectos de sonido se recomponen según la nueva línea de tiempo, no se acelera/desacelera directamente la pista de audio del video final antiguo.
  • No se garantiza que el nuevo guion se adapte automáticamente sin pérdida. Si un segmento corto no puede contener la acción, se rechaza, se divide o se cambia de escena; los segmentos largos solo se extienden en las posiciones de permanencia permitidas. Las nuevas escenas aún deben diseñarse para el contenido de esta edición, no encajar mecánicamente oraciones en macro escenas.
  • Se genera un nuevo proyecto y un nuevo video final; no se sobrescribe el proyecto original del usuario; se informa el alcance real de la verificación. anim3 y anim4 se mantienen como experimental hasta que se complete la verificación fotograma a fotograma del nuevo guion completo y la verificación audiovisual del video final; no se debe afirmar que están completamente verificados.

Más detalles: Reutilización de proyectos completos · Reglas de producción · Subtítulos · Música · Dibujos a mano · Solución de problemas.

Skills relacionados