Communitygithub.com

lhaovo/short-video-skills

Traduz uma storyboard finalizada em duas listas executáveis – Lista de Ativos (quais imagens preparar e seus prompts) e Lista de Geração (duração, modo, referências de assets e prompts para cada segmento de vídeo). Cobre visualização, numeração de ativos, divisão em unidades de geração, redação de prompts para Seedance, estratégia de primeiro frame, consistência e diagnóstico de falhas.

O que é short-video-skills?

Esta skill atua como uma camada de tradução entre uma storyboard (destinada a humanos) e uma lista de geração executável para produção de vídeos curtos com IA. Ela recebe a storyboard e a descrição do produto da fase de planejamento, extrai e visualiza cada cena em 8 campos obrigatórios (sujeito, estado, ação, ambiente, iluminação, enquadramento, ângulo, movimento de câmera), identifica recursos visuais (assets) que precisam ser preparados (como produtos, cenários e personagens), divide o storyboard em segmentos de 5 a 10 segundos respeitando a capacidade do modelo, e monta prompts de vídeo no formato de 6 blocos, com foco em consistência de identidade visual. A saída são dois documentos markdown: a 'Lista de Ativos' (02-assets-list.md) especificando cada asset necessário com prompts de imagem, e a 'Lista de Geração' (03-generation-list.md) com a tabela de visão geral e prompts completos para cada segmento, incluindo modo de geração (primeiro frame, frame inicial+final, ou texto-para-vídeo), referências de assets e diálogo word-for-word. É ideal para times que precisam de consistência entre múltiplos segmentos de vídeo, especialmente para demonstrações de produtos. A skill funciona de forma independente ou integrada ao ecossistema 'short-video', fornecendo prompts prontos para ferramentas como 'short-video-assets' (geração de assets) e 'short-video-generate' (geração de vídeo). As plataformas alvo incluem Seedance (padrão) e outros modelos, com suporte a resolução de falhas através de scripts de verificação automática.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Estação de Prompts de Vídeo

Uma storyboard que se lê e uma lista de geração que roda – entre elas há uma camada de tradução. Esta skill faz essa tradução.

Produz dois arquivos: a Lista de Ativos (quais imagens preparar) e a Lista de Geração (como gerar cada segmento).

Ela não reescolhe temas, não altera a estrutura do roteiro, não julga a qualidade do conteúdo – isso é upstream. Também não gera imagens ou vídeos diretamente; apenas traduz para algo diretamente executável.


1. Cinco Regras de Ouro

Escritas primeiro porque cada uma corresponde a um tipo de falha.

  1. Ativos primeiro. Sem numeração, nada de prompts. Se um mesmo produto na 3ª cena se transforma em outro, a causa raiz é quase sempre a falta de um ativo.
  2. Um prompt de vídeo descreve apenas um momento contínuo. Troque de cenário, divida em segmentos – não deixe o modelo fazer a transição sozinho.
  3. Reutilize o sujeito literalmente com "anchor phrase". Trocar por sinônimo é trocar de pessoa.
  4. Defina a fonte do produto antes de escrever o prompt. Se houver material real ou oficial, use-o; se não, pode gerar com IA, mas fixe geometria, impressão e logotipo. Cenas com parâmetros ou alegações de eficácia só podem usar material real ou oficial.
  5. Prompt de vídeo escreve-se no modo positivo; prompt de imagem usa seção negativa. Essas duas sintaxes não se trocam, veja a seção 8 de references/prompt-syntax.md.

2. Entrada

Obrigatório

ItemDe onde vemSe faltar
StoryboardSeção 4 do plano, tabela curta de 6 colunas + detalhes cena a cenaSem número de cena, duração numérica ou campo de transição chave, recuse, não adivinhe
Nome real e especificações do produtoSeção 1 do planoSe não tiver, pergunte; se não conseguir, marque como "a confirmar"
Modelo alvoUsuário especifica, padrão SeedanceUse o padrão, não precisa perguntar

Tabela curta de seis colunas: Número da cena / Duração (s) / O que essa cena mostra / Locução / Texto na tela / Função da cena. Detalhes por cena: percepção do público / dependências prévias / fatos visíveis chave / intenção da duração.

Opcional

  • Proporção de tela (padrão 9:16), resolução do vídeo (padrão 480p, consistente com o gerador)
  • Limites de duração por segmento (padrão 5–10 segundos)
  • Se incluir áudio (obrigatório ativar. A narração é lida pelo modelo; desligar equivale a ficar sem som; só desligue se for uma cena vazia confirmada)

Dois Modos de Entrada

ModoProcessamento
Modo padrãoLeia a seção 4 do plano, campos completos, vá direto ao passo 3
Modo flexívelApenas uma tabela markdown externa; primeiro analise, exiba ao usuário para conferência, destaque campos faltantes

A análise flexível deve informar explicitamente "Esta é uma análise reduzida, por favor confira". Errar em silêncio é pior do que relatar um erro.


3. Oito Passos

1 Ler tabela → 2 Visualizar → 3 Extrair ativos → 4 Dividir segmentos → 5 Primeiro frame → 6 Montar prompt → 7 Gerar listas → 8 Autoverificação

Passo 1 · Ler Tabela

Corresponda a tabela curta com os detalhes cena a cena pelo número da cena, e lembre-se das informações do produto. Este passo é apenas de verificação, não de criação. Se a skill de planejamento estiver instalada, execute seu script scripts/check_plan.py --plan <caminho_do_plano>; se instalada isoladamente, verifique cena por cena conforme a lista de campos de entrada. Tabelas antigas de 5 colunas, sem campo de transição, retornem para preenchimento.

Três verificações:

  • Números de cena contínuos, duração positiva
  • Duração de cada cena entre 2–6 segundos (sinalize as exceções)
  • A storyboard tem "O que esta cena mostra", não apenas locução

Passo 2 · Visualizar

Este é o único passo criativo em toda a skill, e o mais fácil de pular.

A storyboard dá uma descrição do conteúdo ("explica por que fora está quente e dentro frio"), mas o prompt precisa da imagem. Cada segmento deve preencher os seguintes campos:

ItemO que perguntarExemplo
SujeitoO que há na imagemMarmita de cerâmica branca, tampa aberta
EstadoQual o estado atual do sujeitoTampa aberta, marmita sobre a mesa
AçãoQuem está fazendo o quê, uma açãoUma colher sendo inserida no centro
AmbienteOnde, o que há ao redorMesa de escritório, micro-ondas ao fundo
IluminaçãoDe onde vem a luz, qual temperatura de corLuz branca quente do topo, complemento da janela esquerda
EnquadramentoQual a escala da imagemClose-up
Ângulo/Posição da câmeraOnde a câmera está em relação ao sujeitoAltura da mesa, 30 graus frontal-lateral
Movimento de câmeraComo se move (escolha apenas um)Câmera fixa, aproximação lenta

Nenhum campo pode faltar. Cada segmento deve listar explicitamente sujeito, estado, ação, ambiente, iluminação, enquadramento, ângulo/posição e movimento de câmera; quando não aplicável, explique o motivo. Se faltar, primeiro tente preencher; se não conseguir, pergunte ao usuário – não deixe vazio no prompt, pois o modelo inventará.

Os "fatos visíveis chave" e "dependências prévias" da storyboard devem ser marcados na Lista de Geração: se são estado visível no primeiro frame ou ação que ocorre dentro do segmento de vídeo. Ações processuais não podem ser representadas por um único primeiro frame que mostre antes, durante e depois.

Passo 3 · Extrair Ativos

Siga references/assets.md para quatro ações: numerar, dividir, definir fonte, gerar tabela.

  • Prefixo de número: PR Produto / SC Cenário / CH Personagem / SP Acessório
  • Critério para entrar na lista: referenciado por dois ou mais segmentos, ou exige identidade consistente
  • Três níveis de fonte: Real / Material oficial (use se houver), Gerado por IA (se não houver material real, fixe geometria e impressão), A complementar

Passo 4 · Dividir Segmentos

Interseção de três restrições:

  1. Duração do segmento ≥ número de palavras da locução ÷ 4 palavras/segundo (o modelo lê chinês a cerca de 4–5 caracteres/segundo, use o menor valor)
  2. Segmento individual 5–10 segundos (limite do modelo, ver prompt-syntax.md)
  3. Uma ação por segmento

A regra 1 usa 4 e não 6.5 por um motivo: o modelo não acelera a fala; ele simplesmente pula a segunda metade da frase. Segmentos cortados com otimismo resultam em frases faltando na geração, o que é muito mais trabalhoso do que cortar mais um segmento.

Locução por segmento limite de 36 caracteres. Acima disso, divida o segmento; não force a barra comprimindo o texto.

Para cenas muito longas, use extensão + frame de transição: escreva claramente qual é o estado visual do último frame do segmento anterior, não "continua do segmento anterior".

Passo 5 · Primeiro Frame

Nem todo segmento precisa de primeiro frame. Julgue pela sensibilidade:

Obrigatório ter primeiro framePode ser texto-para-vídeo diretamente
Close-up de produto, ação com as mãos, aparecimento de logotipo ou textoCena vazia, atmosfera, transição, puro efeito de luz

A imagem do primeiro frame é escrita com prompt de imagem (veja seção 4 de assets.md com 7 módulos), princípio: "produto real como base + cenário gerado por IA".

Passo 6 · Montar Prompt

Escreva seguindo os 6 blocos de references/prompt-syntax.md:

[Estilo e proporção] → [Referência de ativo] → [Sujeito fixo] → [Linha do tempo] → [Locução e som] → [Restrições de qualidade]

Quatro itens obrigatórios: movimento de câmera único, lista Motion:, texto da locução (exatamente como está, sem mudar palavras), No subtitles.

O quinto bloco agora carrega a própria locução – não há mais etapa separada de dublagem; a fala é entregue ao modelo por este bloco. A coluna de locução da storyboard deve ser copiada palavra por palavra, sem adicionar marcações de tom, parênteses extras ou alterar uma palavra. Se mudar, a legenda não vai sincronizar com o áudio.

Passo 7 · Gerar Listas

Preencha os dois modelos, salvando no diretório especificado upstream (padrão 02-ativos.md, 03-geracao.md).

Passo 8 · Autoverificação

Execute seis verificações, com script se possível:

python scripts/check_gen_list.py --dir <diretoriode_producao>

Código de saída: 0 aprovado / 2 itens críticos / 3 arquivo ilegível.


4. Duas Saídas

Lista de Ativos (02-ativos.md)

Tabela de seis colunas, seguidas pelos prompts de imagem de cada ativo:

NúmeroTipoUsoFonteReferenciado por segmentosStatus
  • Tipo: Corpo do produto / Detalhe do produto / Cenário / Personagem / Acessório
  • Fonte: Real ou material oficial / Gerado por IA / A complementar
  • Status: Existente / A gerar imagem / A fotografar

Lista de Geração (03-geracao.md)

Uma tabela de visão geral + prompts completos por segmento (prompts longos demais para caber na tabela):

Segm.CenaDuraçãoModoAtivo referenciado1º framePós-produçãoNº de candidatosDependência prévia / Fato visível
  • Modo: Primeiro+último frame / Imagem de referência / Texto-para-vídeo
  • 1º frame: S01_f01 ou "nenhum"
  • Nº de candidatos: sugerido 2–4

Os três modos são opções para o downstream, nem todos os modelos suportam todos. Atualmente, o KIE Seedance oferece apenas texto-para-vídeo, primeiro frame e primeiro+último frame; o modo de imagem de referência deve ser rebaixado para primeiro frame – a regra de rebaixamento está em short-video-generate, esta skill apenas escreve conforme o padrão, sem ajustar para o modelo.

Abaixo da tabela, para cada segmento com ### S01 · Cena 1–2 | 8s | Primeiro+último frame, forneça os 8 campos visuais e o prompt completo, junto com a fonte do primeiro frame, dependências prévias e itens de pós-produção.

Modelos disponíveis em assets/.


5. Nove Verificações de Autoverificação

#VerificaçãoSe falhar
1Cada segmento tem número de cena, não há segmentos extrasVolte ao passo 4 e redivida
2Soma das durações dos segmentos difere da duração total da storyboard em ≤1 segundoAjuste a duração do segmento, não mude a storyboard
3Números de ativos referenciados na lista estão definidos na Lista de AtivosAdicione a definição ou remova a referência
4Modo principal único: Primeiro+último frame e Imagem de referência não se misturamUniformize em todo o vídeo
5Fonte da cena do produto está marcada; cenas com alegações usaram material real ou oficialVolte ao passo 3 e mude a fonte
6Cada prompt de vídeo tem: movimento de câmera único, Motion:, No subtitlesAdicione um a um
7Segmentos com fala: bloco de locução coincide palavra por palavra com a locução da storyboardCompare segmento por segmento; um caractere diferente já exige correção
8Campos visuais completosF8 só verifica se a tabela de "campos visuais" existe e está preenchida, não infere de palavras-chave; sujeito, estado, ação, ambiente, iluminação, enquadramento, ângulo/posição, movimento de câmera, dependência/fato visível devem ser preenchidos; itens não aplicáveis explicar motivo
9Dependência foi transmitidaDependências prévias e fatos visíveis chave da storyboard foram mapeados para o primeiro frame ou ação dentro do segmento

O verificador F8 só confirma que a tabela de visão geral preencheu a coluna "Dependência prévia / Fato visível" para cada segmento, não prova que o conteúdo foi realmente apresentado pelo primeiro frame ou pela ação do segmento; G2 ainda precisa de verificação manual segmento por segmento.

O item 4 com redação precisa: Primeiro+último frame e Imagem de referência são mutuamente exclusivos; Texto-para-vídeo é usado apenas para cenas sem sujeito. Misturar dois modos principais em cenas de produto resulta em imagens que não se conectam.

O item 7 é novo e o mais fácil de esquecer. A abordagem é simples, mas eficaz: coloque a coluna de locução da storyboard e o bloco de locução da lista lado a lado e compare caractere por caractere. Se mudar uma pontuação ou trocar um sinônimo, a legenda terá que mudar, e a legenda é feita apenas no S4 – quando descobrir, já será tarde.

Aproveite para verificar duas coisas: se cada segmento tem mais de 36 caracteres (se tiver, o modelo vai pular partes) e se há marcações de tom como (risos) [animado] (o modelo as lerá).


6. Limites

  • Não reestruturar o conteúdo: números de cena, ordem e duração vêm upstream; esta skill não altera a estrutura
  • Não julgar a qualidade do conteúdo: tema, gancho, estrutura são decisões upstream
  • Não gerar diretamente: apenas listas e prompts; geração de imagens fica com short-video-assets, geração de vídeo com short-video-generate
  • Não prometer sucesso na primeira tentativa: geração é probabilística; esta skill garante apenas que "aquela tentativa que vale a pena" tenha maior probabilidade
  • Não copiar parâmetros: parâmetros do modelo mudam; a skill dá princípios e diretrizes gerais, valores específicos consulte a documentação oficial

7. Referências

ArquivoQuando ler
references/prompt-syntax.mdAo escrever prompts de vídeo; ao ajustar movimento de câmera, linha do tempo, referências de ativos
references/assets.mdAo extrair ativos, escrever prompts de imagem de ativos e primeiro frame
references/consistency.mdQuando múltiplos segmentos não combinam, produto deforma, rosto não corresponde
references/troubleshooting.mdQuando um segmento não gera repetidamente

Modelos: assets/asset-list-template.md, assets/gen-list-template.md Validação: scripts/check_gen_list.py

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

一条短视频从策划到发布的流程总控:建制作目录、依次走「剧本分镜 → 提示词 → 生成 → 交付 → 发布」五段、每段设门禁、记录流程状态、支持跨会话续做。当用户要开一条新片子、问「下一步做什么」、想接着做某条没做完的片子、要把分镜变成提示词、要整理素材与成片、要准备发布包时使用。本技能只规定流程、目录与产物标准,不重复各环节的写作规范。

lhaovo/short-video-skills

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

lhaovo/short-video-skills

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

Habilidades Relacionadas