Communitygithub.com

Akira Video

Ingresa y avanza de forma continua en un proyecto de producción de video con IA; lee o establece VIDEO.md, y según el guion actual, materiales reutilizables, tomas, resultados generados y el estado de la postproducción, enruta al Skill de video canónico correspondiente sin meter todas las reglas de producción en un solo prompt.

¿Qué es Akira Video?

Akira Video es el enrutador principal del ecosistema Akira Video Skills. Su función es gestionar la entrada al proyecto de video, mantener el archivo `VIDEO.md`, evaluar la tarea de producción actual y delegar el trabajo especializado a los skills canónicos adecuados (como `video-script`, `video-shot`, `video-generation`). Esto evita que un solo prompt de sistema tenga que abarcar todas las reglas de producción, manteniendo el conocimiento modular y actualizable. Es compatible con cualquier agente que pueda ejecutar skills (Claude Code, Cursor, Codex, etc.) y está diseñado para trabajar con proyectos existentes sin reiniciar pasos previos. Su funcionamiento se basa en una jerarquía de prioridades (protección de hechos del usuario → intención narrativa → identidad de personajes/objetos → continuidad espacio-temporal → estética visual → efectos llamativos) y una serie de referencias documentales (`VIDEO-HOME.md`, `PRODUCTION-FLOW.md`, `AUTHORITY.md`, etc.) que guían cada decisión. El router solo maneja el resumen de responsabilidades; al entrar en una rama especializada, el skill cargado es la única autoridad para ese método profesional. Además, gestiona el ciclo de vida de los paquetes de generación externa y define los límites de parada y reenrutamiento.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/akira-video

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Akira Video?

akira-video es el Enrutador Principal de Akira Video Skills. Posee la entrada de producción de video, VIDEO.md, la evaluación de la tarea de producción actual, el enrutamiento a Skills especializados y los límites de parada; el guion específico, los materiales reutilizables, las tomas, los paquetes de generación, la revisión y los métodos de postproducción completa son responsabilidad del Skill especializado correspondiente. Las dependencias del proyecto completo y la transición humano-máquina se rigen por references/workflow/PRODUCTION-FLOW.md; los proyectos existentes continúan desde el estado actual real, sin repetir mecánicamente pasos anteriores.

Toda la producción protege siempre, en este orden: usuario y hechos fuente → intención narrativa/de toma (cuando aplique) → identidad y estructura de personas/objetos → hechos del producto (en publicidad) → continuidad espacial y temporal → estética visual → efectos llamativos. Los niveles específicos, la verificación de conflictos y las excepciones de "salida real adoptada" se rigen por references/workflow/AUTHORITY.md; los objetivos posteriores no pueden comprometer las restricciones anteriores.

1. Entrar o retomar un proyecto

Primero, lee el archivo VIDEO.md en la raíz del proyecto. Si no existe, crea un proyecto de video mínimo siguiendo references/project/PROJECT-LAYOUT.md; la definición del proyecto y el estado actual se rigen por references/project/VIDEO-HOME.md, y la nomenclatura por references/project/NAMING.md. Solo crea los directorios y archivos realmente necesarios; no generes categorías vacías por adelantado. La primera vez que se necesite un paquete de generación único, asegúrate de que el .gitignore del proyecto ignore .tmp/.

Si el usuario ya ha proporcionado imágenes, videos, audio, un montaje preliminar o un producto terminado de referencia, primero evalúa su uso real en el proyecto actual según references/project/IMPORT-MEDIA.md; los resultados reutilizables no requieren repetir el proceso de diseño o generación.

Luego, según la tarea actual, lee solo el contenido mínimo necesario:

  • Guion y resumen de tomas: video/script/;
  • Materiales reutilizables entre tomas: video/materials/;
  • Toma actual: video/shots/<shot-id>/;
  • Si ya se ha iniciado la postproducción completa: video/edit/;
  • Fuentes previas (novelas, capítulos, materiales de marca, etc.): lee siguiendo el puntero real del proyecto, no dupliques la fuente original.

Criterio de finalización: poder explicar el objetivo del video, los requisitos de entrega, el contenido de producción en curso, los materiales reutilizables existentes, el estado actual de las tomas/postproducción y los bloqueos reales.

Antes de iniciar una producción costosa, ejecuta solo las compuertas de producción ligeras aplicables al proyecto actual según references/workflow/PRODUCTION-GATES.md; las compuertas no generan archivos de estado adicionales. Si el proyecto actual es demasiado grande para una vista general, o si es necesario comparar versiones creativas, entonces lee references/project/SCALING-VERSIONS.md; no asumas directorios de largometraje. Al limpiar resultados fallidos, paquetes únicos, caché o medios antiguos, primero verifica según references/project/MEDIA-LIFECYCLE.md que el archivo no sea la única entrada, el resultado adoptado actual o la única dependencia de la ingeniería de postproducción.

Para saber cómo registrar decisiones importantes, cuándo actualizar VIDEO.md y por qué los resultados de las tomas solo se escriben en SHOT.md, consulta references/project/RECORDING.md; el historial del chat y los paquetes de generación únicos no son registros de proyecto a largo plazo.

2. Mantener VIDEO.md

VIDEO.md es la página de inicio de producción de video para lectura directa por humanos y el próximo agente; solo conserva la información que sigue siendo útil. Enfócate en:

  • Objetivo del proyecto y del video;
  • Requisitos de entrega;
  • Progreso actual de la producción;
  • Trabajo actualmente en curso;
  • Bloqueos;
  • Decisiones clave que aún afectan el futuro;
  • Navegación al guion, materiales reutilizables, tomas y postproducción.

El historial de prompts comunes, todos los resultados de generación, los registros de generación y las decisiones antiguas reemplazadas por el historial de Git no entran en VIDEO.md.

Para instrucciones detalladas, consulta references/project/VIDEO-HOME.md.

3. Enrutar trabajo especializado

Según el objetivo actual del usuario y el contenido del proyecto, selecciona el siguiente trabajo de producción real. Un proyecto completo no requiere pasar por todas las capacidades mecánicamente; si ya hay un guion, se puede ir directamente a las tomas; si ya hay tomas y materiales, se puede preparar un paquete de generación; al recibir los resultados, se pasa directamente a la revisión.

Carga el Skill canónico según la tarea actual:

  • Formar/revisar el guion de video, la actuación de personajes, la escena o el resumen de tomas a partir de novelas, capítulos, briefs u otro contenido fuente → video-script;
  • Si los personajes o escenas solo tienen una descripción funcional, sin un diseño de apariencia/vestimenta/material/espacio/iluminación específico → video-design;
  • Si se necesita un timbre de voz estable para un personaje entre tomas, referencia de sonido, o si el proyecto necesita planificar diálogos, sonido ambiental, efectos de sonido y los límites de audio de la pieza completa → video-audio;
  • Planificar o mantener prompts y materiales de referencia para personajes, escenas, accesorios y productos que se reutilizan entre tomas → video-materials;
  • Expandir el resumen de tomas en SHOT.md, manejando la acción, cinematografía, sonido y continuidad con las tomas adyacentes → video-shot;
  • Escribir los prompts de generación actuales, seleccionar el conjunto de referencia mínimo, preparar el paquete de generación único y devolver los resultados de generación del usuario → video-generation;
  • Cuando el usuario trae imágenes o resultados de generación, decidir la adopción, ajustar pasos posteriores, reparar en postproducción, regenerar o reescribir → video-review;
  • Cuando varias tomas adoptadas entran en postproducción completa con Premiere Pro, After Effects, DaVinci Resolve, etc. → video-editing;
  • Si el mismo video necesita subtítulos multilingües, narración, doblaje o versiones finales formales → primero lee references/workflow/LOCALIZATION.md; el contenido de la traducción se asigna a video-script, el sonido a video-audio, y los subtítulos/gráficos/exportación final a video-editing; no dupliques el proyecto completo;
  • Si se necesita verificar la función del producto, estructura, materiales oficiales y límites de la expresión publicitaria para marcas, colocación de productos o anuncios → carga el opcional video-advertising según sea necesario; si el objetivo actual no está instalado, usa la coordenada explícita akira-tl/akira-video-skills/video-advertising, pásala al Router akira / Skiloom para generar un plan candidato e instalarlo después de la autorización.

El Router solo guarda el resumen de responsabilidades anterior; al entrar en cualquier rama, el Skill autoritario cargado es la única fuente de autoridad para ese método profesional.

Si el objetivo requiere adaptaciones específicas para modelos de video, primero lee references/workflow/MODEL-ADAPTERS.md para seleccionar el paquete de adaptación mínimo disponible en el repositorio actual; si no está instalado, pasa la coordenada explícita al Router akira / Skiloom para generar un plan candidato e instalarlo. No codifiques parámetros de modelo o detalles del proveedor en akira-video. La generación de imágenes actualmente usa las reglas generales de video-design + video-materials, sin mantener un adaptador de modelo de imágenes separado.

Cuando la generación externa ya se ha entregado al usuario y se necesita esperar entre sesiones, registra en VIDEO.md solo la ruta del paquete de generación, el retorno esperado, el siguiente paso y los bloqueos reales según references/workflow/WAITING-RESUME.md; en la siguiente ronda, prioriza la reanudación del paquete/resultados existentes, sin repetir el empaquetado debido al cambio de sesión.

4. Límite humano-máquina para la generación externa

Por defecto, se permite al usuario realizar la generación real en modelos de imagen/video externos. Cuando se necesita generación externa, el Skill de generación especializado prepara un paquete de generación único a partir del contenido formal del proyecto:

Contenido formal del proyecto → paquete de generación único en .tmp/ → generación externa del usuario → devolución de resultados → archivo en directorio formal → eliminación del paquete temporal.

El paquete de generación único es un derivado, no se convierte en fuente de hecho del proyecto a largo plazo; los prompts a largo plazo permanecen en el directorio de material o toma correspondiente; el paquete temporal solo copia el contenido realmente necesario para la generación actual.

5. Reenrutamiento y límites de parada

Después de que cada Skill especializado complete una acción con límites definidos:

  1. Archiva los materiales formales devueltos, resultados de generación, decisiones de toma o ingeniería de la pieza completa en el directorio correspondiente;
  2. Actualiza VIDEO.md con la información que aún afecta la producción;
  3. Según el objetivo del usuario y el producto actual, decide el siguiente trabajo de producción.

Solo se detiene cuando se completa el alcance limitado por el usuario, el siguiente paso requiere esperar la generación externa del usuario o la provisión de materiales, existen bloqueos reales, o la entrega actual está completa. Al esperar la generación externa del usuario, proporciona claramente el paquete de generación único y los requisitos de nomenclatura para la devolución; no continúes simulando que ya se han producido materiales.

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把小说、章节、故事梗概、品牌 brief 或其他上游内容转换成当前视频自己的脚本层;当需要编写或修订 SCRIPT.md、视频人物表演定义、场景定义、对白或镜头总表时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Skills relacionados