Communitygithub.com

lhaovo/short-video-skills

Controlador do fluxo completo de produção de vídeos curtos, do planejamento à publicação: cria o diretório de produção, percorre as cinco etapas (roteiro/storyboard → prompts → geração → entrega → publicação), impõe verificações em cada etapa, registra o status do fluxo e permite continuar o trabalho entre sessões.

O que é short-video-skills?

Esta skill é o cérebro por trás da produção de vídeos curtos, agindo como um controlador de fluxo de trabalho de ponta a ponta. Ela não escreve roteiros ou gera vídeos diretamente, mas sim define e gerencia a estrutura do processo: como o diretório de cada vídeo é criado, quais são as cinco fases obrigatórias (roteiro/storyboard, prompts de geração, geração de ativos, entrega/finalização e publicação), e quais critérios objetivos ("portões") precisam ser atendidos para avançar de uma fase para outra. O principal benefício é a rastreabilidade e continuidade: qualquer pessoa que abra o diretório do projeto pode ver exatamente em que fase o vídeo está, o que está bloqueando o progresso e qual o próximo passo, mesmo que a produção tenha sido iniciada em uma sessão diferente do agente de IA. A skill suporta fluxos de trabalho com outras skills especializadas, como `short-video-plan` (para roteiro) e `short-video-prompt` (para prompts), atuando como a autoridade central sobre a estrutura de diretórios e arquivos, evitando retrabalho e garantindo que todos os ativos estejam no lugar certo. Ao iniciar um novo projeto, ela solicita informações essenciais (plataforma, duração alvo, tema) e constrói a estrutura de diretórios padronizada. Durante o processo, ela mantém um arquivo de status (`00-流程状态.md`) que serve como ponto de salvamento, documentando cada mudança e permitindo que o trabalho seja retomado de forma confiável após uma interrupção.

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

Perguntar na sua IA favorita

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

Documentação

Painel de Controle de Vídeos Curtos

Um vídeo, da ideia à publicação, acontece dentro de um único diretório. Esta skill cuida de três coisas: como criar o diretório, como percorrer as cinco etapas e o que é considerado "aprovado" em cada etapa.

Ela não ensina como escrever um roteiro (isso é responsabilidade da short-video-plan), não substitui modelos de geração e não realiza a edição prática do vídeo. O que ela garante é: em qualquer produção, ao abrir o diretório, você sabe exatamente em que etapa está, o que fazer a seguir e se pode prosseguir.


I. As Cinco Etapas

S1 Roteiro/Storyboard → G1 → S2 Prompts → G2 → S3 Geração → G3 → S4 Entrega → G4 → S5 Publicação → G5 → Concluído
EtapaO que fazerPrincipal ProdutoQuem faz
S1 Roteiro/StoryboardTópico, tipo, estrutura, roteiro, storyboard de conteúdo01-plano-de-producao.mdshort-video-plan
S2 PromptsStoryboard → Lista de Ativos + Lista de Geração02-lista-de-ativos.md, 03-lista-de-geracao.mdshort-video-prompt
S3 GeraçãoPreparar ativos, depois gerar segmentos de vídeo04-midias/short-video-assets + short-video-generate
S4 EntregaJuntar segmentos, legendar, musicar, mixar05-video-final/Ferramenta de edição
S5 PublicaçãoTítulo, capa, hashtags, horário, identificação06-pacote-de-publicacao.mdEsta skill

Avance apenas uma etapa por vez. Pular etapas é a principal fonte de retrabalho — se G2 não foi aprovado e você parte para a geração, o material gerado certamente não corresponderá aos números das cenas.


II. Padrão de Diretório (Esta Skill é a Única Autoridade)

Todos os produtos vão para o mesmo diretório. O local padrão é outputs/ na raiz do projeto. Outras etapas não devem definir suas próprias regras de diretório; todas obedecem a esta seção.

2.1 Estrutura

outputs/
└── 2026-09-29-nao-dormir-bem-como-tdah/
    ├── 00-status-do-fluxo.md
    ├── 01-plano-de-producao.md
    ├── 02-lista-de-ativos.md
    ├── 03-lista-de-geracao.md
    ├── 04-midias/
    │   ├── 01-imagens-de-ativos/
    │   ├── 02-primeiro-frame/
    │   └── 03-segmentos/
    ├── 05-video-final/
    │   └── video-final-v1.mp4
    └── 06-pacote-de-publicacao.md

A utilidade dos prefixos numéricos: ao abrir o diretório, os arquivos são ordenados por fluxo de processo; você vê em que etapa está e o que falta, sem precisar de um arquivo de navegação extra.

2.2 Nome do Diretório

Formato fixo: YYYY-MM-DD-Titulo

ItemRequisito
DataData de criação do diretório, não muda depois
SeparadorUm hífen entre data e título; o título também usa hífens para conectar palavras
TamanhoTítulo com 8–15 caracteres
ProibidoBarras (/, ), dois pontos, asteriscos, interrogação, aspas, colchetes, barra vertical, espaços e pontuação
Nomes DuplicadosMesma data e mesmo título, adicione -2, -3

O título deve ser a frase mais reconhecível do tópico selecionado, não o nome da categoria:

InválidoVálido
Dica EducativaNão dormir bem como TDAH
Vídeo TikTokComida quente por fora, fria por dentro
Tópico de 22 de outubroCafé em garrafa térmica esfria em meio dia

Método de avaliação: Três meses depois, só de olhar o nome do diretório, você consegue lembrar de que vídeo se trata? Nomes de categoria você certamente não lembrará; o tópico, sim.

2.3 Três Regras de Ouro

  1. O nome do diretório, uma vez criado, não muda. Se mudar, uma série de caminhos de referência de mídia será quebrada. Se quiser alterar o título, mude o título de publicação no 06-pacote-de-publicacao.md, não mexa no diretório.
  2. Não altere a data entre os dias. Se continuar no dia seguinte, o diretório ainda terá a data do dia em que foi criado, não crie um novo diretório.
  3. Um vídeo, um diretório. Séries, ramificações de matriz não viram subdiretórios; crie um novo diretório com um título que inclua um termo distintivo.

2.4 Primeiro Passo ao Iniciar

Quando o usuário disser "iniciar um novo vídeo", pergunte primeiro as três coisas, depois crie o diretório:

  • Plataforma (Douyin / Weibo Video / Xiaohongshu)
  • Duração alvo
  • Direção em uma frase

Em seguida, faça quatro coisas em ordem:

  1. Gere o nome do diretório conforme 2.2, leia em voz alta para o usuário confirmar — esta é a única chance de renomear sem custo
  2. Crie o diretório e os quatro subdiretórios: 04-midias/01-imagens-de-ativos, 02-primeiro-frame, 03-segmentos, 05-video-final
  3. Escreva 00-status-do-fluxo.md: etapa atual = S1, preencha o perfil de aceitação do projeto, todos os cinco portões marcados como "não iniciado"
  4. Passe para S1, entregue à camada de conteúdo

Se o nome não for confirmado antes da criação, o custo de renomear depois é por conta do usuário.


III. Arquivo de Status

00-status-do-fluxo.md é o ponto de salvamento deste vídeo. Atualize imediatamente após cada avanço de etapa, não acumule.

Campos obrigatórios:

CampoFunção
Nome do diretório, data de criação, plataforma, duração alvoIdentificação
Etapa atualSeis opções: S1 / S2 / S3 / S4 / S5 / Concluído
Resultado dos cinco portõesG1–G5 um por um: Aprovado / Reprovado / Não iniciado
Lista de produtosArquivos existentes + arquivos ausentes
Itens bloqueadoresOnde está travado agora, quem está esperando
Perfil de aceitação do projetoTipo de conteúdo, objetivo, intenção de ritmo, limite máximo de intervalo sem fala, como suporta momentos de silêncio, restrições rígidas, aprovador/condições de aprovação
Registro de versõesUma linha por alteração: data + o que mudou + por quê

Modelo em assets/flow-state-template.md.

Isso resolve um problema bem específico: trocar de sessão, pular uma semana ou mudar de pessoa para continuar; lendo este arquivo, é possível retomar. Sem ele, no terceiro dia você teria que revisar todo o material para lembrar onde parou.


IV. Os Cinco Portões

Os portões só têm dois resultados: Aprovado ou Reprovado. Se for Reprovado, pare nesta etapa. Não é permitido "fazer primeiro, vê depois".

G1 · Portão de Roteiro/Storyboard (S1 → S2)

  • As cinco seções do 01-plano-de-producao.md estão completas e passaram na auto-verificação das oito perguntas
  • A duração total do storyboard está com desvio ≤30% da meta
  • Cada cena dura 2–6 segundos, numeração de cena contínua sem pulos
  • Verificação de linha vermelha aprovada: sem eficácia não comprovada, sem depoimentos inventados, sem linguagem absolutista, sem informações pessoais
  • Usuário confirmou o tópico e o roteiro
  • Perfil de aceitação do projeto preenchido; se plataforma, duração alvo ou restrições rígidas não estiverem confirmadas, registre o valor padrão autorizado pelo usuário, caso contrário, pare em S1
  • O perfil de aceitação declarou o limite máximo do intervalo sem fala; para projetos que permitem silêncio longo, a forma de suporte para os segmentos de silêncio foi esclarecida
  • Cada cena tem preenchidos: função, percepção do público, dependências prévias, fatos visíveis-chave e intenção de duração; para segmentos sem fala, descreva o suporte por ação, som foley, música ou atmosfera
  • Ao usar a skill de planejamento, execute seu scripts/check_plan.py para eliminar erros mecânicos de campo, duração e número de dependência; ao instalar apenas a skill de fluxo, verifique manualmente conforme a lista de verificação G1 e registre que o script não foi executado

G2 · Portão de Lista de Geração (S2 → S3)

  • Cada prompt tem um número de cena correspondente, sem prompts extras
  • A soma das durações de cada segmento difere da duração total do storyboard em ≤1 segundo
  • Os números de ativos referenciados na lista de geração estão todos definidos na lista de ativos, sem referências pendentes
  • O modo principal está definido: Primeiro/Último frame OU imagem de referência, escolha um; geração de texto para vídeo é usada apenas para cenas sem assunto principal
  • Cenas com parâmetros de produto, embalagem, logotipo, etc., estão marcadas como "deve usar imagem real", não são delegadas à geração de texto para vídeo puro
  • Para segmentos com fala, o texto original está escrito no prompt, idêntico palavra por palavra à narração do storyboard (narração não é dublada separadamente; se faltar, o segmento fica mudo)
  • O campo "descrição visual" de cada prompt de segmento lista: assunto principal, estado, ação, ambiente, iluminação, plano, ângulo/posição de câmera, movimento de câmera e dependências/fatos visíveis; itens não aplicáveis têm explicação
  • Fatos visíveis-chave, dependências prévias e intenção de duração do storyboard foram mapeados para o primeiro frame ou para a ação dentro do segmento

G3 · Portão de Material de Mídia (S3 → S4)

  • Cada segmento tem uma versão utilizável; os que faltam estão escritos nos itens bloqueadores
  • A geometria do produto não está deformada, a etiqueta está legível e inalterada
  • Segmentos adjacentes podem ser conectados: mesmo produto, mesma direção de luz, mesmo formato de tela
  • Pontos de identificação icônicos e suas quantidades na lista de características do IP/personagem foram verificados cena por cena no segmento finalizado
  • Quando há múltiplos candidatos para a mesma cena, a versão escolhida está registrada na lista
  • Segmentos com fala foram verificados auditivamente frase por frase: nenhuma frase faltando, nenhuma palavra-chave pronunciada erroneamente
  • A conclusão da fala finalizada está registrada em 04-midias/00-veredito-de-fala.json; a transcrição de palavras-chave ambíguas serve apenas como auxílio para verificação auditiva
  • A revisão completa do material de todo o vídeo foi feita manualmente em ordem cronológica, verificando causalidade entre cenas, estado de personagens/produtos, continuidade espacial e ritmo; o storyboard de primeiro frame antes da geração não substitui este item
  • Se houver uma linha do tempo de fala do segmento finalizado, faça uma pré-verificação de ritmo primeiro; se não houver legenda do vídeo final, registre para teste real em S4, não tome a pré-verificação como conclusão do vídeo final
  • Itens de pós-produção como sons foley e sobreposição de texto na lista de geração têm um plano de execução em S4, sem promessas pendentes

G4 · Portão de Vídeo Final (S4 → S5)

  • A duração real tem desvio ≤10% da meta
  • Execute o script scripts/check_rhythm.py desta skill com a legenda do vídeo final e a duração real; o relatório e a conclusão da verificação auditiva são anexados ao 00-status-do-fluxo.md; lacunas na legenda são apenas um proxy indicador para segmentos sem fala
  • A legenda corresponde ao que é realmente ouvido no áudio (não ao que está no roteiro original — se houver erro de fala, o que é ouvido prevalece)
  • Voz clara, música de fundo não abafa a voz
  • Formato de tela, resolução e taxa de quadros atendem aos requisitos da plataforma alvo
  • O intervalo sem fala mais longo do vídeo final é determinado por verificação auditiva manual, com o relatório de lacunas de legenda auxiliando a localização; se exceder o valor declarado no perfil de aceitação e não estiver declarado como segmento não-verbal no storyboard, é rejeitado
  • Intervalos declarados como permitindo silêncio longo devem ter ação, som foley, música ou atmosfera descritos no storyboard, e o produto entregue deve marcar o arquivo e o ponto de tempo correspondentes
  • Todos os itens de pós-produção prometidos na lista de geração foram concluídos e podem ser localizados no produto, ou têm uma isenção explícita do aprovador

G5 · Portão de Pré-Publicação (S5 → Concluído)

  • Categorias fortemente regulamentadas (medicamentos, suplementos, dispositivos médicos, finanças, educação) passaram por revisão separada
  • Conteúdo gerado por IA foi identificado conforme exigido pela plataforma
  • Título, capa, hashtags e horário de publicação estão prontos
  • Sem informações pessoais, sem retratos ou locais não autorizados

V. Cartão de Transferência

As etapas só se comunicam por meio de arquivos, não através de "onde paramos mesmo". Ao final de cada etapa, preencha um cartão e escreva na seção "Transferência" do arquivo de status:

TransferênciaO que deve conter no cartão
S1 → S2Tabela de storyboard de seis colunas e detalhes de cada cena (percepção/dependências/fatos visíveis/intenção de duração), nome real e especificações do produto, informações que devem ser apresentadas realisticamente
S2 → S3Tarefa de geração de cada segmento: número do segmento, duração, prompt, número da imagem de referência, modo, número de candidatos
S3 → S4Lista de mídia: nome do arquivo, número do segmento, duração, usabilidade; se as falas foram verificadas auditivamente segmento por segmento, se o BGM já foi selecionado
S4 → S5Arquivo do vídeo final, duração, formato de tela, material de capa, pontos fortes e palavras-chave de hashtag

Campos completos em references/stage-specs.md.


VI. Continuar um Vídeo Inacabado

Quando o usuário disser algo como "continue aquele vídeo sobre não dormir bem":

  1. Liste os diretórios sob outputs/, faça a correspondência pelo nome; se não houver correspondência, pergunte, não adivinhe
  2. Leia 00-status-do-fluxo.md, primeiro apenas a etapa atual e os itens bloqueadores, não leia todos os produtos imediatamente
  3. Relate três linhas: onde parou, o que está bloqueando, qual o próximo passo
  4. Após confirmação, entre na etapa correspondente

Não refaça tudo do zero. Também não pule o arquivo de status para inferir a etapa — errar pode reabrir um portão já aprovado.


VII. Relacionamento com Sub-skills

CamadaQuemO que gerencia
Camada de FluxoEsta skillDiretório, etapas, portões, status, transferência
Camada de Conteúdoshort-video-planTópico, tipo, estrutura, roteiro, storyboard de conteúdo
Camada de Promptsshort-video-promptStoryboard → Lista de Ativos + Lista de Geração
Camada de Ativosshort-video-assetsLista → Imagens: programar, gerar candidatos, aceitar, salvar
Camada de Geraçãoshort-video-generateLista → Segmentos: criar tarefas, sondar downloads, verificar mídia, manter registros
Camada de EntregaFerramenta de ediçãoJuntar, legendar, musicar, mixar

Três regras:

  • A camada de conteúdo não define diretórios, apenas entrega o produto final ao local especificado pela camada de fluxo
  • A camada de prompts não reorganiza o conteúdo, apenas traduz; esta skill não copia seu método de trabalho
  • A camada de ativos não altera conteúdo ou prompts, apenas garante que a imagem seja criada, corresponda e seja aprovada
  • A camada de geração não altera o design visual, apenas anima a imagem finalizada e mantém registros rastreáveis de tarefas
  • A camada de fluxo não reescreve as diretrizes de escrita de nenhuma camada, apenas julga se o portão foi aprovado

Em caso de conflito: diretório e nomes de arquivo seguem esta skill; julgamento de conteúdo segue short-video-plan.


VIII. Limites

  • Não escreve diretrizes de roteiro: tópico, estrutura, roteiro e escrita de storyboard estão na camada de conteúdo; esta skill não os repete
  • Não substitui modelos de geração: define tarefas e padrões de aceitação, não garante que uma geração específica será bem-sucedida
  • Não realiza edição prática: define padrões para o vídeo final, a montagem específica é feita na ferramenta de edição
  • Não promete tráfego: os cinco portões garantem "fluxo sem lacunas, material conectável, publicação em conformidade", não garantem dados de desempenho
  • Não substitui regras de plataforma e revisão legal: políticas de plataforma e leis mudam; categorias fortemente regulamentadas devem ser confirmadas separadamente

IX. Materiais de Referência (Carregar Conforme Necessário)

ArquivoQuando ler
references/stage-specs.mdAntes de cada etapa, ao preencher o cartão de transferência
references/delivery-and-publish.mdEm S4 para montar o vídeo final, em S5 para gerar o pacote de publicação
references/regression-cases.mdApós modificar scripts ou critérios de portão
assets/flow-state-template.mdAo criar um novo fluxo, ao atualizar o status
assets/publish-pack-template.mdEm S5 ao preencher o pacote de publicação

O método de trabalho de S2 não está dentro desta skill; é responsabilidade da short-video-prompt. Esta skill só cuida de: verificar G1 antes de entrar em S2 e aplicar G2 após gerar a nova lista.

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 视频提示词写法、首帧方案、一致性与失败诊断。当用户说「把分镜变成提示词」「写视频提示词」「这条片子要哪些图」「生成清单」「某个镜头生成不出来」时使用。只做翻译与清单,不重新编排内容,不直接出图出片。

Habilidades Relacionadas