Communitygithub.com

lhaovo/short-video-skills

Control de flujo completo de un video corto desde la planificación hasta la publicación: crea el directorio de producción, recorre las cinco etapas «guion/ storyboard → prompts → generación → entrega → publicación», cada una con su puerta de control, registra el estado del flujo y permite continuar en diferentes sesiones.

¿Qué es short-video-skills?

Este skill para agentes de IA (como Claude Code, Cursor, etc.) actúa como el centro de control de todo el flujo de producción de un video corto. Su función principal es gestionar tres cosas: cómo se crea el directorio, cómo se recorren las cinco etapas y qué se requiere para pasar de una etapa a la siguiente (usando puertas de control o gates). El skill no escribe guiones ni realiza edición de video, sino que establece un estándar de proceso y producto. Úsalo cuando quieras comenzar un nuevo video, preguntar «¿qué sigue?», retomar un video inacabado, convertir storyboards en prompts, organizar materiales y productos finales, o preparar un paquete de publicación. Su principal ventaja es la trazabilidad: al abrir un directorio, sabes exactamente en qué etapa te encuentras, qué es lo siguiente y si puedes avanzar. Soporta la continuación entre sesiones y la colaboración entre diferentes agentes especializados (planificación, prompts, generación de activos, etc.), todo ello unificado bajo una sola estructura de directorios y un archivo de estado común (`00-progreso.md`).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lhaovo/short-video-skills/tree/HEAD/short-video-flow

Preguntar en tu IA favorita

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

Documentación

Consola de Control de Video Corto

Un video, desde la idea hasta la publicación, ocurre en un solo directorio. Este skill gestiona tres cosas: cómo se crea el directorio, cómo se recorren las cinco etapas y qué se considera como aprobado en cada etapa.

No enseña a escribir guiones (eso es asunto de short-video-plan), no reemplaza los modelos de generación y no realiza la edición práctica. Lo que garantiza es: en cualquier producción, al abrir el directorio, sabes en qué paso estás, qué hacer a continuación y si puedes continuar.


I. Las Cinco Etapas

E1 Guion/Storyboard → G1 → E2 Prompts → G2 → E3 Generación → G3 → E4 Entrega → G4 → E5 Publicación → G5 → Completado
EtapaQué se haceProducto principal¿Quién lo hace?
E1 Guion/StoryboardTema, tipo, estructura, guion, storyboard de contenido01-plan-propuesta.mdshort-video-plan
E2 PromptsStoryboard → Lista de activos + Lista de generación02-lista-activos.md, 03-lista-generacion.mdshort-video-prompt
E3 GeneraciónPrimero preparar activos, luego generar videos segmentados04-materiales/short-video-assets + short-video-generate
E4 EntregaUnir segmentos, subtítulos, música, mezcla de audio05-producto-final/Herramienta de edición
E5 PublicaciónTítulo, portada, hashtags, hora de publicación, identificadores06-paquete-publicacion.mdEste skill

Solo se avanza una etapa a la vez. Saltarse etapas es la principal fuente de retrabajo: si se pasa G2 y se va a generar, los materiales producidos seguramente no coincidirán con el número de toma.


II. Normas del Directorio (Única Autoridad)

Todos los productos entran en el mismo directorio, ubicado por defecto en la raíz del proyecto outputs/. Las demás etapas no definirán sus propias reglas de directorio; todas deben cumplir con esta sección.

2.1 Estructura

outputs/
└── 2026-09-29-dormir-poco-es-como-tdah/
    ├── 00-progreso.md
    ├── 01-plan-propuesta.md
    ├── 02-lista-activos.md
    ├── 03-lista-generacion.md
    ├── 04-materiales/
    │   ├── 01-imagenes-activos/
    │   ├── 02-primer-fotograma/
    │   └── 03-segmentos/
    ├── 05-producto-final/
    │   └── producto-final-v1.mp4
    └── 06-paquete-publicacion.md

Utilidad del prefijo numérico: al abrir el directorio, los archivos se ordenan según el flujo del proceso; con un vistazo sabes en qué etapa estás y qué falta, sin necesidad de archivos de navegación adicionales.

2.2 Nombre del Directorio

Formato fijo: AAAA-MM-DD-Título

ElementoRequisito
FechaEl día en que se crea el directorio, no cambia después
SeparadorUn guion entre la fecha y el título; dentro del título también se usan guiones para separar palabras
LongitudTítulo de 8 a 15 caracteres
ProhibidoBarras normales e invertidas, dos puntos, asteriscos, signos de interrogación, comillas, paréntesis angulares, barra vertical, espacios y signos de puntuación
DuplicadosMismo día y mismo título, añade -2, -3

El título se toma de la frase más distintiva del tema seleccionado, no del nombre de la categoría:

IncorrectoCorrecto
Contenido educativoDormir poco es como TDAH
Video corto de TikTokLa comida caliente por fuera, fría por dentro
Tema del 22 de octubreEl café en termo se enfría en horas

Método de evaluación: Si solo ves el nombre del directorio tres meses después, ¿puedes recordar de qué video se trata? Los nombres de categoría seguramente no se recordarán, pero el tema sí.

2.3 Las Tres Reglas de Oro

  1. El nombre del directorio, una vez creado, no se cambia. Si se cambia, las rutas de referencia de los materiales se rompen inmediatamente. Para cambiar el título, modifica el título de publicación en 06-paquete-publicacion.md, no toques el directorio.
  2. Tampoco se cambia la fecha aunque se pase de día. Si continúas al día siguiente, el directorio sigue teniendo la fecha del día en que se creó, no abras otro directorio.
  3. Un video, un directorio. Para series o contenido en matriz, no crees subdirectorios; abre otro directorio y añade una palabra diferenciadora al título.

2.4 Primer Paso al Iniciar

Cuando el usuario diga «abrir uno nuevo», primero pregunta tres cosas, luego crea el directorio:

  • Plataforma (TikTok / WeChat Video / Xiaohongshu)
  • Duración objetivo
  • Dirección en una frase

Luego, haz cuatro cosas en orden:

  1. Genera el nombre del directorio según la sección 2.2, léelo al usuario para que lo confirme — esta es la única oportunidad de cambiar el nombre sin costo
  2. Crea el directorio y los cuatro subdirectorios: 04-materiales/01-imagenes-activos, 02-primer-fotograma, 03-segmentos, 05-producto-final
  3. Escribe 00-progreso.md: etapa actual = E1, completa la descripción del proyecto, las cinco puertas todas en «No iniciado»
  4. Pasa a E1, entrégaselo a la capa de contenido

Si no se confirma el nombre primero y se crea el directorio, el costo de cambiar el nombre posteriormente corre por cuenta del usuario.


III. Archivo de Estado

00-progreso.md es el punto de guardado de este video. Actualízalo inmediatamente después de avanzar a cada etapa, no lo acumules.

Campos obligatorios:

CampoFunción
Nombre del directorio, fecha de creación, plataforma, duración objetivoIdentificación
Etapa actualSeis opciones: E1 / E2 / E3 / E4 / E5 / Completado
Resultados de las cinco puertasG1–G5, una por una: Aprobado / No aprobado / No iniciado
Lista de productosArchivos existentes + Archivos faltantes
Bloqueos¿Dónde está atascado ahora? ¿A quién espera?
Descripción del proyectoTipo de contenido, objetivo, intención de ritmo, límite máximo de intervalo sin diálogo, método de soporte para silencios, restricciones estrictas, aprobador/condiciones de versión final
Registro de versionesUna línea por cada cambio: fecha + qué se cambió + por qué

La plantilla está en assets/flow-state-template.md.

Resuelve una cuestión muy concreta: cambiar de sesión, pasar una semana, que otra persona retome el trabajo: con leer este archivo se puede continuar. Sin él, al tercer día tendrías que revisar todos los materiales para recordar en qué punto estabas.


IV. Las Cinco Puertas

Las puertas solo tienen dos resultados: aprobado o no aprobado. Si no se aprueba, te quedas en esa etapa, no se permite «hacerlo y ya veremos».

G1 · Aprobación del Guion/Storyboard (E1 → E2)

  • 01-plan-propuesta.md completo con las cinco secciones, las ocho preguntas de autoevaluación aprobadas
  • La duración total del storyboard se desvía de la duración objetivo en ≤30%
  • Cada toma dura de 2 a 6 segundos, los números de toma son continuos y no se saltan
  • Autoevaluación de línea roja aprobada: sin eficacia no comprobada, sin testimonios inventados, sin lenguaje absolutista, sin información personal
  • El usuario ha confirmado el tema y el guion
  • La descripción del proyecto está completa; si la plataforma, duración objetivo o restricciones estrictas no están confirmadas, registra los valores por defecto autorizados por el usuario; de lo contrario, se queda en E1
  • La descripción del proyecto declara el límite máximo del intervalo sin diálogo; los proyectos que permiten silencios largos deben especificar el método de soporte para la sección silenciosa
  • Cada toma debe tener especificada su función, percepción del público, dependencias previas, hechos visibles clave e intención de duración; las tomas sin diálogo deben explicar su soporte mediante acción, sonido, música o ambiente
  • Si se utiliza el skill de planificación, ejecuta su script scripts/check_plan.py para eliminar errores mecánicos de campos, duración y números de dependencia; si solo se instala el skill de flujo, verifica manualmente según la lista de G1 y registra que el script no se ejecutó

G2 · Aprobación de la Lista de Generación (E2 → E3)

  • Cada prompt tiene su correspondiente número de toma, sin ningún segmento de más
  • La duración total de todos los segmentos difiere de la duración total del storyboard en ≤1 segundo
  • Los números de activos referenciados en la lista de generación están todos definidos en la lista de activos, sin referencias pendientes
  • El modo principal está fijado: Primer y último fotograma o imagen de referencia, una de las dos opciones; la generación solo por texto se usa solo para tomas sin sujeto
  • Toma como parámetros de producto, empaque, logotipo, etc., ya están etiquetados como «debe usar imagen real», no se entrega a generación de video solo por texto
  • En los segmentos con diálogo, el texto original del diálogo ya está escrito en el prompt, coincidiendo palabra por palabra con el diálogo del storyboard (la narración ya no se dobla por separado; si se omite este segmento, no habrá sonido)
  • La tabla de «Campo de imagen» de cada prompt especifica: sujeto, estado, acción, entorno, iluminación, plano, ángulo de cámara, movimiento de cámara y dependencias/hechos visibles; los elementos no aplicables deben explicar el motivo
  • Los hechos visibles clave, dependencias previas e intención de duración del storyboard se han mapeado al primer fotograma o a la acción dentro del segmento

G3 · Aprobación de Materiales (E3 → E4)

  • Cada segmento tiene una versión utilizable; los que faltan se escriben en los bloqueos
  • La geometría del producto no se deforma, las etiquetas son legibles sin alterar el texto
  • Los segmentos adyacentes pueden unirse: mismo producto, misma dirección de iluminación, mismo formato de imagen
  • Los puntos de identificación icónicos y su cantidad en la lista de características de IP/personajes se han verificado toma por toma en la versión final
  • Si una misma toma tiene múltiples candidatos, la versión seleccionada ya está escrita en la lista
  • Los segmentos con diálogo se han revisado frase por frase auditivamente: no hay frases omitidas, las palabras clave no se pronuncian mal
  • La conclusión del diálogo de la versión final se ha registrado en 04-materiales/00-dictado-final.json; la transcripción de palabras clave ambiguas sirve solo como ayuda para la revisión auditiva humana
  • Se ha realizado una revisión manual de todos los materiales del video en orden cronológico, comprobando causalidad entre segmentos, estado de personajes/accesorios, continuidad espacial y ritmo; el storyboard de primer fotograma previo a la generación no puede sustituir este paso
  • Si existe la línea de tiempo de diálogo de la versión final, primero se hace una verificación de ritmo; si no hay subtítulos del producto final, se registra para probarlo en E4, sin tomar la verificación previa como conclusión del producto final
  • Los elementos posteriores como efectos de sonido, superposiciones de texto, etc., de la lista de generación, tienen un plan de ejecución en E4, sin promesas pendientes

G4 · Aprobación del Producto Final (E4 → E5)

  • La duración real se desvía de la duración objetivo en ≤10%
  • Usa los subtítulos del producto final y la duración real para ejecutar el script scripts/check_rhythm.py de este skill; el informe y la conclusión de la revisión auditiva se adjuntan en 00-progreso.md; los espacios en blanco en los subtítulos son solo un indicador proxy de segmentos sin diálogo
  • Los subtítulos coinciden con lo que realmente se oye en el diálogo (no con el original — si se pronuncia mal, se toma lo que se oye)
  • La voz humana es clara, la música de fondo no opaca la voz
  • El formato de imagen, la resolución y la velocidad de fotogramas cumplen con los requisitos de la plataforma objetivo
  • El intervalo máximo sin diálogo del producto final se determina mediante revisión auditiva humana, con ayuda del informe de espacios en blanco de subtítulos para localizarlo; si supera el valor declarado en la descripción del proyecto y no se ha declarado como segmento no verbal en el storyboard, se devuelve
  • Los intervalos en los que se permite un silencio largo se especifican en el storyboard con soporte de acción, sonido, música o ambiente, y en el producto de entrega se señalan los archivos y puntos de tiempo correspondientes
  • Todos los elementos posteriores prometidos en la lista de generación están completos y se puede ubicar el producto, o hay una exención explícita del aprobador

G5 · Aprobación antes de Publicar (E5 → Completado)

  • Las categorías fuertemente reguladas (medicamentos, suplementos, dispositivos médicos, finanzas, educación) han sido revisadas por separado
  • El contenido generado por IA se ha etiquetado según los requisitos de la plataforma
  • Título, portada, hashtags y hora de publicación están listos
  • Sin información personal, sin retratos no autorizados ni locaciones

V. Tarjeta de Traspaso

Las etapas solo se comunican entre sí a través de archivos, no por «lo que estábamos diciendo hace un momento». Al final de cada etapa, completa una tarjeta y escríbela en la sección de «Traspaso» del archivo de estado:

TraspasoLa tarjeta debe contener
E1 → E2Tabla resumida del storyboard (seis columnas) y detalles toma por toma (percepción/dependencias/hechos visibles/intención de duración), nombre real y especificaciones del producto, información que debe presentarse de forma real
E2 → E3Tarea de generación de cada segmento: número de segmento, duración, prompt, número de imagen de referencia, modo, número de candidatos
E3 → E4Lista de materiales: nombre de archivo, número de segmento, duración, disponibilidad; si el diálogo se ha revisado auditivamente segmento por segmento, si se ha seleccionado la música de fondo
E4 → E5Archivo del producto final, duración, formato de imagen, material de portada, puntos de venta y palabras de hashtag

Los campos completos se encuentran en references/stage-specs.md.


VI. Continuar un Video Inacabado

Cuando el usuario diga algo como «continúa con el video de dormir poco»:

  1. Enumera los directorios bajo outputs/, busca por nombre; si no hay coincidencia, pregunta, no adivines
  2. Lee 00-progreso.md, primero solo mira la etapa actual y los bloqueos, no te apresures a leer todos los productos
  3. Reporta tres líneas: en qué etapa estás, qué te bloquea, qué hacer a continuación
  4. Solo después de la confirmación, entra en la etapa correspondiente

No rehagas todo desde el principio. Tampoco te saltes el archivo de estado para inferir la etapa directamente: si te equivocas, volverás a abrir una puerta que ya estaba aprobada.


VII. Relación con los Skills Hijos

Capa¿Quién?¿Qué gestiona?
Capa de flujoEste skillDirectorio, etapas, puertas, estado, traspaso
Capa de contenidoshort-video-planTema, tipo, estructura, guion, storyboard de contenido
Capa de promptsshort-video-promptTabla de storyboard → Lista de activos + Lista de generación
Capa de activosshort-video-assetsLista → Imagen: programación, candidatos, aceptación, almacenamiento
Capa de generaciónshort-video-generateLista → Segmentos: crear tareas, descarga por sondeo, revisión multimedia, registro
Capa de entregaHerramienta de ediciónUnión, subtítulos, música, mezcla de audio

Tres reglas:

  • La capa de contenido no define directorios, solo entrega el producto final en la ubicación especificada por la capa de flujo
  • La capa de prompts no reorganiza el contenido, solo lo traduce; este skill no copia su método de trabajo
  • La capa de activos no modifica el contenido ni los prompts, solo se asegura de que la imagen esté hecha, coincida y sea aceptable
  • La capa de generación no modifica el diseño visual, solo hace que las imágenes ya definidas se muevan y deja un registro de tareas trazable
  • La capa de flujo no reescribe las normas de escritura de ninguna capa, solo juzga si pasa o no la puerta

En caso de conflicto: el directorio y los nombres de archivo siguen a este skill; la decisión de contenido sigue a short-video-plan.


VIII. Límites

  • No escribe normas de guion: el tema, la estructura, el guion y la escritura del storyboard están en la capa de contenido; este skill no las repite
  • No reemplaza los modelos de generación: escribe las tareas y los estándares de aceptación, no garantiza que una generación en particular tenga éxito
  • No realiza la edición práctica: define el estándar del producto final; la unión específica se hace en la herramienta de edición
  • No promete tráfico: las cinco puertas garantizan «el flujo no tiene fugas, los materiales pueden unirse, la publicación cumple con las normas», no garantizan datos
  • No reemplaza las reglas de la plataforma ni la revisión legal: las políticas y regulaciones de las plataformas pueden cambiar; las categorías fuertemente reguladas deben ser confirmadas por separado

IX. Referencias (Cargar según sea necesario)

Archivo¿Cuándo leerlo?
references/stage-specs.mdAntes de cada etapa, cuando se deba completar la tarjeta de traspaso
references/delivery-and-publish.mdEn E4 para unir el producto final, en E5 para crear el paquete de publicación
references/regression-cases.mdDespués de modificar scripts o criterios de puerta, para pruebas de regresión
assets/flow-state-template.mdAl crear un nuevo flujo, cada vez que se actualice el estado
assets/publish-pack-template.mdEn E5, al completar el paquete de publicación

El método de trabajo de E2 no está dentro de este skill, lo realiza short-video-prompt. Este skill solo se encarga de: antes de entrar en E2, verificar G1; después de que se genere una nueva lista, pasar por G2.

Individual skills in this repo

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

lhaovo/short-video-skills

为视频生成准备可用的图——把资产清单变成能直接喂给图生视频的素材:排生产顺序、定资产级别、出候选图、做一致性验收、按编号落盘、回写清单状态。支持三种来源:实拍、AI 生成、官方素材,不强制实拍。当用户说「准备素材」「出资产图」「首帧图」「角色三视图」「产品图跑一下」「资产对不上」「这条要哪些图」时使用。只管把图做出来并验收,不写分镜,不直接生成视频。

lhaovo/short-video-skills

把已过 G2 的生成清单落成真实视频片段——按段建 KIE Seedance 任务、轮询、下载、媒体体检、抽帧质检、听声核台词,并把每段的状态与请求指纹写进生成台账。三种模式互斥(文生 / 首帧图生 / 首尾帧图生)。旁白由模型直接念,台词照稿写进提示词,不走独立 TTS 配音。当用户提到视频生成、出片段、跑 Seedance、首帧图生、首尾帧、原生音频、台词念错、任务查询、片段下载、生成失败重试时使用。只管「把已定的画面和台词变成成段素材」,不重新设计视觉、不改台词文本、不做字幕、不做剪辑。

lhaovo/short-video-skills

把「我想拍点什么」变成一条想清楚的片子——先定主题(出 5 个候选、标明类型、给出推荐与淘汰理由),再定结构与分段剧本,最后切成镜头级内容分镜。支持两种入口:一句话主题(需要发散选题)与已有拆解剧本(跳过选题,先问复刻需求与复刻强度再判定改写)。当用户提到选题、定主题、短视频策划、写剧本、写大纲、分镜、镜头脚本、不知道拍什么、内容怎么排、科普干货、剧情软广、钩子怎么写、复刻别人的剧本时使用。只管内容层(讲什么、怎么讲),不碰执行层;内置的内容红线只防明显自伤,不替代合规审查。

lhaovo/short-video-skills

把已定稿的分镜表翻成可直接执行的两份清单——资产清单(要准备哪些图、每张图的图像提示词)与生成清单(每段视频的时长、模式、素材引用与提示词)。覆盖画面化、资产编号、切分生成单元、Seedance 视频提示词写法、首帧方案、一致性与失败诊断。当用户说「把分镜变成提示词」「写视频提示词」「这条片子要哪些图」「生成清单」「某个镜头生成不出来」时使用。只做翻译与清单,不重新编排内容,不直接出图出片。

Skills relacionados