Communitygithub.com

zenstory-ai/drama-skills

Uma coleção de skills de criação de curtas-metragens/dramas em IA, cobrindo roteiro, assets, storyboard, prompts de imagem/vídeo e revisão independente, adaptada para Claude Code e Codex.

O que é drama-skills?

Esta skill oferece um conjunto completo de ferramentas para a criação de curtas-metragens e dramas por IA, suportando as plataformas Claude Code e Codex. Ela abrange todo o ciclo de produção, desde a inicialização do projeto, roteiro, definição de assets (personagens, cenários), storyboard, geração de prompts de imagem e vídeo, até a revisão final e exportação. A estrutura é modular e orientada a roteiros, utilizando um workflow 'creator-first' que mantém cinco documentos principais por episódio: roteiro, configuração visual, storyboard, prompts de imagem e prompts de vídeo. A ferramenta evita a criação de conteúdo desnecessário, focando apenas no que é solicitado pelo usuário, e fornece um dashboard para visualização e edição dos arquivos de criação.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add zenstory-ai/drama-skills

Perguntar na sua IA favorita

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

Documentação

Roteamento de Criação de Curta-metragem/Drama

Esta skill é responsável pela inicialização do projeto, roteamento entre etapas, definição do formato de produção e Dashboard. O conteúdo de cada etapa é de responsabilidade do owner correspondente.

Quick Start

Todos os projetos utilizam o workflow creator-first: para cada episódio, mantenha conforme necessário os arquivos roteiro.md, configuracao-visual.md, storyboard.md, prompts-de-imagem.md, prompts-de-video.md, sem criar uma estrutura de verdade de criação paralela. Para detalhes de escrita, veja os Cinco Documentos de Criação.

Roteamento

O que o usuário quer fazerowner / ação
Desenvolver ideias, compromissos de série, adaptações e mapa de episódios$short-drama-develop, somente quando o usuário precisar
Já possui múltiplos episódios completos/roteiros soltos para identificar episódios$short-drama-develop cria um índice temporário com base nos limites reais
Analisar obra original longa$short-drama-novel-analyze, somente quando o usuário precisar
Escrever ou modificar o roteiro de um episódio$short-drama-write → roteiro.md
Detalhar personagens, estilos, locais, adereços$short-drama-assets → configuracao-visual.md
Escrever prompts de imagem para assets$short-drama-image-prompts → prompts-de-imagem.md
Criar cenas e quadros-chave congelados$short-drama-storyboard → storyboard.md
Escrever prompts de vídeo/linha do tempo/música$short-drama-video-prompts → prompts-de-video.md
Gerar mídia de fato$short-drama-produce, primeiro pré-visualizar, depois confirmar explicitamente, e então executar
Revisar ou verificar$short-drama-review, somente quando o usuário solicitar
Inicialização, Dashboard, arquivamento de documentos solicitadosEsta skill

Análise de materiais longos e índices de episódios em desenvolvimento-projeto/ são áreas de trabalho opcionais de análise, não participam da definição do layout de um episódio; ao escrever qualquer episódio, mantenha apenas os cinco Markdowns creator-first daquele episódio.

Roteiros prontos podem ser diretamente desmembrados em assets; fatos visuais existentes podem ser usados diretamente para escrever prompts de imagem ou storyboard; storyboard existente pode ser usado diretamente para escrever prompts de vídeo. Não invente upstream para completar uma linha de produção fictícia.

Execução de Solicitações

  1. Encontre o projeto ou material fornecido pelo usuário, leia apenas a entrada direta para a tarefa atual.
  2. Passe todo o escopo solicitado pelo usuário para o owner correspondente; lotes controlam apenas o contexto, execução automática contínua.
  3. Pergunte apenas sobre bifurcações criativas reais; não pergunte sobre schema, diretórios, transações ou verificadores para o criador.
  4. Após a conclusão do escopo, relate de uma vez o conteúdo concluído, decisões-chave, pendências reais e próximos passos opcionais.
  5. Não inicie automaticamente revisão, arquivamento ou produção que o usuário não solicitou.

Inicialização e Dashboard

Quando for necessária configuração do projeto, execute:

python3 {diretorio-skill}/scripts/project_tool.py init ./meu-drama --titulo "Exemplo de Curta"

init apenas cria configuração e diretórios vazios; na primeira criação, escreva os documentos no diretório episodios/<EP>/, não crie arquivos vazios previamente.

Para localização do projeto e escrita segura, veja Pré-verificação de Execução. Quando o usuário solicitar explicitamente o Dashboard, execute:

python3 {diretorio-skill}/scripts/dashboard_server.py --workspace <workspace> --port 0 --detach --open

--detach faz o processo de serviço ser executado independentemente do shell atual, não sendo interrompido pelo fim da sessão, fechamento do terminal ou saída do agente; o link permanece válido durante toda a criação. O endereço, porta e PID em execução são registrados em <workspace>/.short-drama/dashboard.json (apenas legível pelo próprio usuário), e os logs no mesmo diretório dashboard.log:

python3 {diretorio-skill}/scripts/dashboard_server.py --workspace <workspace> --status   # Imprime o link atual
python3 {diretorio-skill}/scripts/dashboard_server.py --workspace <workspace> --stop     # Para

Se já houver um Dashboard em execução no mesmo workspace, iniciar novamente apenas imprime o mesmo link, sem abrir uma segunda porta; para mudar de porta ou token, adicione --restart. Sem --detach, o comportamento permanece inalterado: execução em primeiro plano, encerrada com Ctrl-C.

O Dashboard exibe e edita arquivos de criação, não é responsável por orquestração de workflow ou produção de mídia.

Decisões Criativas de Nível de Projeto

Quando o formato de produção, direção visual, formato de exibição e duração-alvo de episódio realmente restringem múltiplas etapas, mostre as opções e seu impacto e deixe o usuário decidir.

Look Development é um ramo opcional, não uma etapa obrigatória para entrar em prompts de imagem ou storyboard.

Para cada problema, leia apenas um conhecimento relevante:

Limites de Produção e Entrega

Produção externa sempre mantém preview -> confirm explicit -> run. Arquivamento copia apenas os documentos atuais e produtos finais solicitados pelo usuário, excluindo dados privados, credenciais, caminhos absolutos e estado de execução oculto; não invente aprovações, hashes ou conteúdo secundário para arquivamento.

Quando o usuário perguntar "como exportar/entregar após concluir", use export para empacotar o estado atual:

python3 {diretorio-skill}/scripts/project_tool.py export <projeto> --out <diretorio-fora-do-projeto>

Ele copia os cinco documentos de criação existentes de cada episódio e episodios/<EP>/resultados-producao/ para --out, junto com manifest.json e checksums.sha256, e exclui input/, entrega/ e .short-drama/. Para apenas uma parte, adicione --episode EP001 (pode ser repetido); para apenas texto, adicione --no-media; para sobrescrever diretório existente, adicione --overwrite. --out deve estar fora do diretório do projeto.

export é um instantâneo do estado atual, onde asserts_approval no manifest é sempre false: ele não alega qualquer revisão ou aceitação do criador. Pacotes de entrega formais com evidência de aprovação ainda requerem o caminho package/verify.

Instalação e Manutenção

Execute python3 scripts/selftest.py apenas para instalação, upgrade ou solução de problemas.

Habilidades Relacionadas