Communitygithub.com

nian-pangolin/wan3-drama-skills

Converte roteiros em storyboards cinematográficos, dividindo cada cena em 'unidades' (parágrafos) de até 15 segundos. Cada unidade inclui descrição de posicionamento de cena, e cada tomada segue um formato profissional com código de enquadramento (WS/MS/MCU/CU/ECU), movimento de câmera, foreground, [ação visual], [design de som] e falas. Ideal para pré-produção de vídeos curtos.

O que é wan3-drama-skills?

Esta skill transforma roteiros de episódios (um ou mais) em storyboards cinematográficos detalhados, segmentando cada cena em 'unidades' de até 15 segundos. Cada unidade contém uma descrição de posicionamento dos atores no espaço da cena, servindo como base para a decupagem de câmera. Cada tomada dentro da unidade é descrita em uma linha padronizada: código de enquadramento (WS, MS, MCU, CU, ECU), movimento de câmera (ex: 'fixa', 'dolly in'), foreground (ou 'nenhum'), [descrição da ação visual], [design de som] e falas (ou ':(sem falas)'). A saída é um arquivo de texto puro, formatado como 'storyboard.txt', seguindo uma estrutura de três níveis: episódio → unidade → tomada. A skill é ideal para diretores, roteiristas e equipes de produção de vídeos curtos, garantindo que cada segundo do vídeo seja planejado com precisão técnica e criativa. Ela se baseia em regras claras de segmentação (corte a cada 15 segundos, mudança de espaço/dramática) e de decupagem (pelo menos 2-3 tomadas por fala, evitar ângulos repetidos, uso obrigatório de foreground em over-the-shoulder).

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nian-pangolin/wan3-drama-skills/tree/HEAD/cinematic-storyboard

Perguntar na sua IA favorita

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

Documentação

Habilidade de Storyboard Cinematográfico e Segmentação em Unidades

Converte o roteiro de um (ou mais) episódios em um "storyboard cinematográfico" e segmenta o storyboard em "unidades" (parágrafos), cada uma correspondendo a um clipe de vídeo de ≤15 segundos.

Condição de Ativação

Quando o usuário fornecer um texto de roteiro (contendo cabeçalhos de cena, personagens, descrições de ação △, falas, VO/OS, etc.) e desejar:

  • Gerar um "storyboard cinematográfico", "script de movimentos de câmera", "script de tomadas", ou
  • "Segmentar o storyboard em unidades / parágrafos / clipes de 15 segundos", ou
  • Solicitar explicitamente um formato "como storyboard.txt"

use esta habilidade.

Formato de Entrada

A entrada é um roteiro de um ou mais episódios, com a estrutura típica:

Episódio X
X-X Nome da Cena Tempo (Dia/Noite) Interior/Exterior
Personagens: Personagem 1 Personagem 2 ...
Legenda: (opcional, ex: República·Cidade de Shen·Bund)
△Descrição da ação (dica de storyboard, geralmente começando com △ ou 【Close-up】, etc.)
Nome do Personagem (emoção/ação): Conteúdo da fala
Nome do Personagem (VO): Monólogo interior
Nome do Personagem (OS): Som fora da tela / fala de memória
(Marcações como (Flashback) / (Corte) / (Transição))

Formato de Saída (Estrutura de Três Níveis)

A saída é em texto puro, adotando uma estrutura de três níveis: "Episódio → Unidade → Tomada".

Primeiro Nível: Título do Episódio

Episódio X - Storyboard

Segundo Nível: Unidades (Storyboard Segmentado em Parágrafos)

Cada unidade corresponde a um clipe de vídeo de ≤15 segundos, formato:

Unidade N: X-X Nome da Cena Tempo Int/Ext Descrição do Posicionamento da Cena: <Descrição do posicionamento espacial, distância, movimentação dos personagens dentro do clipe>
  • Unidade N: Começa em 1, numeração contínua dentro de cada episódio
  • Seguido pelo cabeçalho da cena (mantido originalmente X-X Nome da Cena Tempo Int/Ext), podendo incluir marcações como (Flashback), (Transição), (Final com Gancho)
  • Após Descrição do Posicionamento da Cena: descreve o posicionamento físico dos personagens dentro desta unidade, distâncias entre eles, direções, posições de obstáculos, etc., fornecendo a base espacial para a movimentação da câmera

Terceiro Nível: Linhas de Tomada

As tomadas dentro de cada unidade são numeradas a partir de 1, uma tomada por linha, formato:

N. Código de Enquadramento (Movimento de Câmera) Foreground: <Descrição do foreground ou "nenhum">.【Descrição da Ação Visual】【Descrição do Design de Som】<Parte da Fala>
  • <Parte da Fala>: Se houver fala, escreva Nome do Personagem: Conteúdo da fala (VO/OS escreva Nome do Personagem (VO): ...); se não houver, escreva :(sem falas)

Exemplo completo de linha de tomada:

4. CU (Câmera Fixa) Foreground: Nenhum.【Close-up no rosto de Qin Shuyao, do pescoço ao topo da cabeça. Seus olhos brilham, expressão arrogante com um toque de languidez】【Voz baixa e lenta, com um toque de suspiro】Qin Shuyao: O Bund esta noite está tão silencioso.
1. WS (Câmera em Trilho com Ângulo Baixo) Foreground: Janela do carro antigo desfocada coberta de gotas de chuva.【Qin Shuyao, de vestido justo, está na porta em um halo de luz. A câmera se aproxima lentamente sobre a calçada molhada】【Som ambiente: jazz suave misturado com o som distante de rodas】:(sem falas)

Detalhamento dos Campos da Linha de Tomada

1. Código de Enquadramento (Obrigatório, no início)

CódigoSignificadoUso
WSWide Shot (Plano Geral)Estabelecer cena, relações ambientais, movimentação de grupo, cenas de impacto
MSMedium Shot (Plano Médio)Meio corpo do personagem, ação, relação entre duas pessoas, movimentação
MCUMedium Close-Up (Plano Americano)Do peito para cima, progressão emocional, tomada principal de diálogo
CUClose-Up (Close)"Rosto, do pescoço ao topo da cabeça", explosão emocional, objeto-chave
ECUExtreme Close-Up (Extremo Close)Olhos, dedos, marcas de sangue, ênfase máxima em detalhes
  • Close-ups faciais devem ser descritos uniformemente como "Close-up no rosto de XXX, do pescoço ao topo da cabeça", garantindo consistência na geração.

2. Movimento de Câmera (Obrigatório, logo após o enquadramento, entre parênteses em português)

Escrito dentro de ( ), descrevendo a posição da câmera e o movimento. Vocabulário comum (pode combinar português e inglês):

  • Fixos: Câmera Fixa, Grande Angular Fixo, Câmera Fixa em Plongée
  • Dolly/Travelling: Dolly In, Dolly Lento, Dolly Rápido, Dolly Muito Próximo, Dolly Out em Trilho
  • Pan/Tilt: Pan Lateral, Pan Lateral Seguindo, Whip Pan Rápido Horizontal, Tilt Down, Tilt Down com Guia de Olhar, Tilt Up Lento
  • Ângulo: Ângulo Baixo Contra-Plongée, Ângulo Alto em Plongée, Reverso Over-the-Shoulder, Over-the-Shoulder, Ângulo Inclinado (Dutch Angle)
  • Handheld/Steadicam: Handheld Leve, Handheld Instável, Steadicam Seguindo, Handheld Rentando ao Chão, Zoom com Movimento Circular
  • Especiais/Efeitos: Câmera Lenta Slow-mo, Match Cut, Crane Descendo, Transição de Foco, Transição Rápida de Foco, Ponto de Vista POV
  • Transição: Dissolve, Wipe com Foreground, Corte Seco, Transição com Dolly In/Out

3. Foreground (Obrigatório)

Após Foreground: escreva o objeto de foreground específico ou Nenhum. O foreground é usado para criar profundidade e sensação de voyeurismo, por exemplo:

  • Foreground: Janela do carro antigo desfocada coberta de gotas de chuva.
  • Foreground: Ombro desfocado de Qin Shuyao. (Over-the-shoulder: obrigatório escrever "ombro desfocado")
  • Foreground: Cano da arma do assassino. / Foreground: Velas vermelhas de casamento queimando, desfocadas.
  • Quando não houver foreground, escreva Foreground: Nenhum.

4.【Descrição da Ação Visual】(Primeiro colchete, obrigatório)

Descreve a imagem específica dentro da tomada: ações dos personagens, movimentação, expressões, ponto final do movimento da câmera, mudanças no ambiente. Deve ser concreto e executável, com informações espaciais e de direção.

5.【Descrição do Design de Som】(Segundo colchete, obrigatório)

Cada tomada deve ter uma marcação independente de som/performance, escolhendo uma ou combinando das seguintes dimensões:

  • Som Ambiente: 【Som ambiente: Passos altos de salto alto】, 【Relincho de cavalo rasgando a noite】, 【Tiroteio denso】
  • Respiração/Pausa: 【Respiração: Suspiro profundo 0,8s】, 【Respiração: Pausa estável 1,0s】 (pode incluir segundos)
  • Silêncio: 【Silêncio 2,0s】
  • Microexpressão/Dica de Atuação: 【Microexpressão: Mandíbula tensa】, 【Movimento leve e silencioso】
  • Tom da Fala (com fala): 【Voz baixa e lenta, com um toque de suspiro】, 【Grito, volume muito alto】, 【VO interior, voz extremamente desesperada e rouca】

6. Parte da Fala (Obrigatório, no final da linha)

  • Com fala: Nome do Personagem: Conteúdo da fala
  • Monólogo interior: Nome do Personagem (VO): Conteúdo da fala
  • Som fora da tela/memória: Nome do Personagem (OS): Conteúdo da fala
  • Sem fala: :(sem falas) (dois pontos antes, consistente com o exemplo)

Regras de Segmentação de Unidades (Núcleo da Segmentação do Storyboard)

  1. Duração Prioritária: Cada unidade corresponde a um clipe de vídeo de ≤15 segundos. Estimativa baseada no número de tomadas e ritmo: geralmente 3-6 tomadas por unidade.
  2. Critério de Corte: Nova unidade deve ser iniciada nos seguintes pontos —
    • Mudança significativa de espaço/posicionamento (movimentação de personagem, nova entrada em cena, formação de cerco)
    • Mudança de cena/tempo-espaço (entrada em flashback, transição, retorno à realidade)
    • Mudança de batida dramática (ex: de ternura para conflito, de confronto para explosão)
  3. Descrição do Posicionamento da Cena: No início de cada unidade, deve-se descrever o posicionamento físico dos personagens dentro do clipe, distâncias entre eles, direções e obstáculos, servindo como base espacial para todas as tomadas da unidade.
  4. Coerência da Unidade: As tomadas dentro de uma mesma unidade compartilham o mesmo espaço e tempo; as tomadas são a decomposição de uma ação contínua.
  5. Final com Gancho: O último de cada episódio deve ter, após a descrição da cena, a marcação (Final com gancho) ou (gancho). A última tomada deve "cortar para preto, deixando o gancho de suspense".

Regras de Decupagem das Tomadas (Núcleo do Storyboard)

  1. Densidade de Corte Primeiro: Cada pausa semântica (vírgula, ponto e vírgula, interjeição), cada mudança emocional, cada pessoa/objeto mencionado deve gerar um corte. É melhor cortar demais do que de menos.
  2. Cada fala com pelo menos 2-3 tomadas: Falante → reação do ouvinte; falas com vírgulas devem ser cortadas nas vírgulas, inserindo tomadas do ouvinte/objeto mencionado entre elas.
  3. Proibido repetir mesmo personagem no mesmo ângulo em tomadas consecutivas: Duas tomadas consecutivas com o mesmo personagem e mesmo ângulo devem ser mescladas ou alteradas (ângulo/enquadramento/tomada de reação). Falas longas de um único personagem precisam intercalar tomadas de reação de espectadores entre as frases.
  4. VO/OS como tomada independente: Monólogo interior, som fora da tela, memória devem ter tomada própria, geralmente com close-up ou câmera subjetiva.
  5. Ações △ importantes como tomada independente: Ações-chave sem fala (sacar arma, cair do cavalo, abrir porta, apertar marca de sangue) devem ter tomada própria, com :(sem falas).
  6. Over-the-Shoulder obrigatório com foreground desfocado: Diálogo/confronto entre duas pessoas: priorizar reverso over-the-shoulder, com Foreground: Ombro desfocado de XXX.
  7. Profundidade com Foreground: Tomadas-chave devem usar foreground (gotas de chuva, fumaça, cano de arma, moldura de porta, chama de vela) para criar profundidade e emoção.
  8. Falas não se repetem: Quando uma fala é dividida em várias tomadas, distribuir os fragmentos semanticamente entre as tomadas, garantindo que tomadas adjacentes nunca repitam o mesmo fragmento.

Sugestões de Escolha de Enquadramento / Movimento de Câmera / Som

  • Tomada de estabelecimento: WS + Dolly In/Plongée + som ambiente; Explosão emocional: CU/ECU + Dolly Rápido + respiração; Cena de ação: MS + Handheld/Steadicam + efeitos sonoros densos; Transição: Match Cut / Dissolve / Wipe / Whip Pan.
  • Design de som deve corresponder à emoção da imagem: cenas calmas usam "silêncio / respiração", conflitos usam "gritos / tiroteio denso", morte/desespero usam "voz de fio de ar / memória etérea".

Transições e Marcações Especiais

  • (Flashback), (Corte), (Transição) do roteiro devem ser refletidos na marcação da unidade como (Flashback), (Transição), etc.
  • Mudanças de cena/tempo-espaço devem ser recebidas por uma tomada de transição dedicada (Match Cut / Dissolve / Wipe / Corte Seco), explicando a lógica da transição em 【Ação Visual】(ex: "eixo de ação similar invertido", "forma e movimento correspondentes").

Requisitos de Saída

  1. Iniciar com o título do episódio Episódio X - Storyboard.
  2. Seguir a ordem "Unidade → Tomada"; as tomadas dentro de cada unidade são numeradas consecutivamente a partir de 1, mas não são contínuas entre unidades (cada unidade recomeça em 1).
  3. Cada tomada ocupa uma linha, com a ordem estrita dos campos: N. Enquadramento (Movimento) Foreground: X.【Ação】【Som】Fala.
  4. Cada tomada deve conter: código de enquadramento, movimento de câmera, foreground, 【Ação】, 【Som】, parte da fala (sem fala escrever :(sem falas)). Nenhum pode faltar.
  5. Ao processar múltiplos episódios, gerar cada episódio separadamente, com o título Episódio X - Storyboard entre eles.
  6. A saída final é texto puro, que pode ser salvo diretamente como arquivo .txt, com nome sugerido storyboard.txt ou {numero_episodio}_storyboard.txt.
  7. Cobertura: Garantir que cada fala do roteiro, cada ação △ importante tenha uma tomada correspondente, sem perder ganchos ou transições.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas