Communitygithub.com

Akira-TL/akira-video-skills

Convierte novelas, capítulos, resúmenes argumentales, briefs de marca o cualquier otro contenido upstream en la capa de guion del video actual. Úsalo al escribir o revisar SCRIPT.md, definiciones de actuación, escenas, diálogos o la tabla de planos.

¿Qué es akira-video-skills?

Este Skill está diseñado para traductores técnicos y agentes de IA que trabajan en la producción de videos narrativos. Su función principal es transformar contenido fuente (novelas, capítulos, resúmenes, briefs) en una capa de guion independiente, evitando duplicar información y manteniendo punteros claros a los originales. Soporta la creación y modificación de cuatro archivos clave: SCRIPT.md (estructura narrativa), CHARACTERS.md (actuación y voz de personajes), SCENES.md (espacio y mundo visual) y SHOTS.md (planificación de tomas). El Skill garantiza que la narrativa sea causal, coherente y que los diálogos estén ajustados temporalmente, priorizando la acción sobre la redundancia explicativa. Es ideal para proyectos donde se necesita un guion listo para producción visual sin arrastrar toda la documentación upstream, y funciona con cualquier plataforma que admita archivos markdown como Claude Code, Cursor o Codex.

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

Preguntar en tu IA favorita

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

Documentación

Guion de Video

Esta Skill solo posee las definiciones de producción de video dentro de video/script/. Las novelas, universos, capítulos, archivos completos de personajes, datos del cliente u otras fuentes continúan perteneciendo a sus fuentes originales; aquí solo se guardan las conversiones y selecciones realizadas para la actuación, escenas y producción de tomas del video actual.

1. Leer la Fuente Upstream y el VIDEO.md

Primero, lee VIDEO.md y la fuente upstream especificada por el usuario. Cuando la fuente es una novela, capítulo u otro texto narrativo largo, lee primero references/ADAPTATION.md. Extrae únicamente los hechos, relaciones entre personajes, trama, escenas, productos o restricciones que el video actual realmente necesita; conserva punteros, no copies el contenido completo de la fuente upstream en la capa de guion de video.

Si hay conflictos entre las fuentes o faltan hechos clave, primero identifica las carencias; no inventes hechos upstream para completar el guion.

2. Establecer la Capa Mínima de Guion de Video

Las responsabilidades de los cuatro archivos de guion comunes se mantienen separadas según references/SCRIPT-FILES.md, evitando copiar el diseño visual, la fotografía y los parámetros de generación de vuelta a la capa de guion; para la escritura real, usa las plantillas mínimas de references/SCRIPT-TEMPLATES.md, creando solo los archivos que el proyecto actual necesita.

Crea solo los archivos que el proyecto actual necesita:

  • SCRIPT.md: historia, estructura, escenas, acciones y diálogos del video actual;
  • CHARACTERS.md: requisitos de actuación, apariencia, diálogos y voz de los personajes en el video actual;
  • SCENES.md: escenarios, espacios, representación del mundo y continuidad utilizados en el video actual;
  • SHOTS.md: vista general de todas las tomas del video.

Los proyectos con tomas de producto simples, videos sin personajes o guiones ya completos pueden omitir cualquiera de estos archivos. No crees archivos vacíos solo por completar la plantilla.

3. Trama y Personajes

Si el video actual incluye una trama completa, arco de personajes, diálogos o chistes, lee primero references/NARRATIVE.md. Cuando los cambios emocionales de los personajes, reacciones importantes o conflictos de relación necesitan realmente plasmarse en la actuación de las tomas, lee references/PERFORMANCE.md para convertir las palabras emocionales en ritmos corporales, de mirada, acciones y comportamiento observables. A continuación, solo se conservan las reglas mínimas necesarias para todos los proyectos narrativos.

Cuando hay trama, prioriza asegurar que la cadena causal y el comportamiento de los personajes sean coherentes, antes de buscar espectáculos visuales:

  • Los eventos son impulsados por condiciones existentes, elecciones de personajes o eventos anteriores;
  • Los personajes actúan y hablan solo basándose en la información que conocen en ese momento;
  • Los giros importantes provienen de elecciones de los personajes o reglas ya establecidas;
  • Las acciones, información o elementos visuales que deben resolverse al final deben haber sido establecidos de manera realista antes;
  • Los productos o accesorios no pueden resolver problemas que no hayan aparecido antes.

La definición de personajes no se limita a etiquetas de personalidad. Cuando el video actual realmente lo necesita, registra objetivos, preocupaciones, formas típicas de actuar, reacciones bajo estrés, ritmo de diálogo, características vocales, rango emocional permitido y cambios durante el video. Si un personaje necesita mantener una identidad vocal consistente entre tomas, entrega las referencias detalladas de tono y voz a video-audio, no copies un segundo conjunto de especificaciones de voz en la capa de guion.

4. Diálogos

Cuando una toma incluye personajes que hablan visiblemente, diálogos largos, conversaciones con múltiples personajes o sincronización labial, lee references/DIALOGUE-TIMING.md y primero verifica que las líneas se puedan decir de forma natural dentro de la duración objetivo antes de pasar a la generación de tomas.

El diálogo sirve al comportamiento actual del personaje, no es responsable de explicar el mundo en nombre del autor. La narración en off / voz en off también pertenece al contenido del guion, pero solo se usa cuando realmente se necesita un punto de vista narrativo, compresión temporal o información que es difícil de expresar de forma natural a través de imágenes; la producción de sonido se entrega a video-audio según sea necesario, no uses la narración en off como una capa de explicación universal para parchear tramas poco claras. Prioriza que la línea anterior, la acción anterior o la nueva información introduzcan naturalmente la siguiente línea; la información que se pueda expresar con acciones no debe repetirse con diálogos.

Después de completar los diálogos, revisa rápidamente toda la conversación en orden cronológico continuo para detectar cambios bruscos de tema, explicaciones redundantes, transiciones emocionales faltantes o que todos los personajes usen las mismas estructuras de oraciones. El diálogo natural no implica insertar jerga de internet forzadamente.

Cuando VIDEO.md especifica una duración total / límite estricto, lee references/DURATION-BUDGET.md y primero haz un presupuesto aproximado de duración basado en los segmentos de la historia y SHOTS.md, para evitar descubrir que la longitud total del video está fuera de control después de completar la generación.

5. Escenas y Vista General de Tomas

SCENES.md solo registra los espacios, reglas visuales y del mundo que el video actual necesita. Para maquinaria compleja, dispositivos desconocidos o relaciones espaciales clave, coloca las explicaciones detalladas en un archivo de documentación junto al activo reutilizable correspondiente, no apiles todas las reglas de baja frecuencia en SCENES.md.

SHOTS.md se utiliza para leer rápidamente la disposición de todas las tomas del video de principio a fin. Cada entrada debe incluir al menos un ID de toma, duración objetivo, imagen / acción y propósito de la toma; los requisitos detallados de producción se entregan al SHOT.md de video-shot.

En proyectos largos, solo agrega capítulos o un nivel superior de organización cuando la tabla de tomas existente ya sea difícil de leer; no presupongas una jerarquía de nivel cinematográfico.

Criterios de Finalización

La capa de guion de video debe permitir que el siguiente paso sepa claramente: de qué trata este video, cómo actúan los personajes actuales, cómo se presentan las escenas y qué tomas se necesitan; al mismo tiempo, no ha copiado la fuente upstream en una segunda base de datos de hechos.

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

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

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

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

Skills relacionados