Communitygithub.com

worldwonderer/drama-skills

Conjunto de skills de criação de curtas-metragens/ dramas curtos para IA, abrangendo roteiro, ativos, storyboard, prompts de imagem/vídeo e revisão independente, adaptado para Claude Code e Codex.

O que é drama-skills?

Este skill suite, worldwonderer/drama-skills, é uma ferramenta completa para criação de curtas-metragens com IA, projetada para Claude Code e Codex. Ele gerencia todo o fluxo de produção: desde o desenvolvimento de ideias, roteiros e ativos (personagens, locais, adereços), até a geração de prompts para imagens e vídeos, storyboard e revisão independente. O sistema é orientado por um arquivo de configuração (`short-drama.json`) e um estado de projeto (`state.json`), com roteamento inteligente baseado na intenção do criador. Inclui recursos como transação segura, controle de versão, revisão fresca (fresh review) para evitar viés, um dashboard local para gerenciamento e ferramentas de linha de comando para inicialização, status, publicação, aceitação e empacotamento. A suite prioriza a autonomia do criador, não forçando etapas desnecessárias e garantindo que decisões visuais e de produção sejam explicitamente aceitas antes de prosseguir.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add worldwonderer/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 Curtas-Metragens

Este é um roteamento de projeto leve; este skill não escreve histórias, prompts de ativos, storyboards, prompts de vídeo ou conclusões de revisão.

O conteúdo legível pelo criador segue short-drama.json#/language (status, diferenças, escolhas, próximos passos contam); o corpo dos prompts enviados para geradores de imagem/vídeo segue #/format/prompt_language (padrão en). Ambos são campos separados – não use um para inferir o outro. O status reportará ambos os valores simultaneamente. As regras completas estão no contrato de idioma de saída em contract-and-ownership.md.

Ponto de Partida para Cada Solicitação

  1. Use o caminho explícito do usuário ou procure para cima, a partir do diretório atual, o short-drama.json mais próximo.
  2. A partir do diretório de instalação deste skill, leia outros skills do mesmo conjunto em suite-manifest.json; pare qualquer alteração se faltarem skills ou houver mistura de versões.
  3. Leia apenas o resumo de short-drama.json e .short-drama/state.json; não carregue todos os arquivos de criação de uma vez.
  4. Execute a recuperação de transações antes de executar status ou qualquer escrita. Em caso de conflito de edição externa, mantenha o arquivo original e ofereça três opções de tratamento: adopt, restore, merge. Não sobrescreva silenciosamente.
  5. Roteie de acordo com a tarefa atual do criador; não force a conclusão de toda a pipeline.

Consulte creator-workflow.md para entrada, pontos de verificação, revisão e entrega. Em cada entrada, execute primeiro runtime-preflight.md para verificar a instalação, recuperar transações e ler o estado do projeto. Leia contract-and-ownership.md para dúvidas sobre propriedade, marcação de arquivo stale, privacidade ou recuperação. Leia routing-examples.md quando a intenção for ambígua. Leia knowhow-index.md apenas quando for necessário localizar o skill responsável por um ID de regra; o roteamento apenas distribui, não substitui o julgamento do skill de criação. Veja reference-roles.md para saber o que uma imagem de referência pode decidir e o contrato de quadros inicial/final; veja audience-reveal.md para saber o que o público pode saber naquele momento; veja pickup-and-alternate.md para a relação entre retomadas, versões alternativas e a versão mestre; veja production-form-profiles.md para a tradução de execução entre diferentes formas de produção; veja look-development.md quando for necessário unificar a linguagem visual com quadros representativos de personagens, locais e alta pressão antes do storyboard formal.

Roteamento por Intenção

Intenção do CriadorRoteamento
Desenvolver ideias, promessa de história, série, mapa de episódios$short-drama-develop
Importar romance/material longo e fazer visualização de episódios e ativos candidatos com rastreabilidade$short-drama-novel-analyze → $short-drama-develop → aceitar adaptação/episódios → $short-drama-write → aceitar roteiro → $short-drama-assets
Avaliar se um romance longo vale a pena adaptar; ver resumo rápido primeiro$short-drama-novel-analyze
Escrever/editar contrato de episódio, batidas de causa e efeito, roteiro$short-drama-write
Detalhar personagens/figurinos, locais/vistas, adereços/estados$short-drama-assets
Escrever prompts de imagem para personagens, locais, adereços e modificações localizadas$short-drama-image-prompts
Fazer cobertura de texto original, storyboard ou congelar quadros-chave$short-drama-storyboard
Escrever prompts de vídeo para ação/atuação/câmera/som$short-drama-video-prompts
Definir estilo visual, forma de produção ou direção visualO próprio $short-drama: localize um cartão de forma conforme production-form-profiles.md, produza candidatos e peça aceitação do criador, depois promova para creator_authority. Ativos, prompts de imagem, storyboard e prompts de vídeo exigem que a forma esteja definida e nenhum deles escolhe por si só, portanto este passo deve ser concluído aqui
Fazer Look Development / quadros de estilo$short-drama primeiro define e aceita a direção visual observável → $short-drama-image-prompts escreve a especificação de texto lookdev_frame; não gera imagens, nem permite que a referência de estilo assuma identidade, geografia ou estado da trama
Calibrar este projeto com observações de produção autorizadas$short-drama-review vincula a versão correta e diagnostica → owner correspondente faz revisão pontual com preserve_set → nova aceitação e fresh re-review; sem observações autorizadas, apenas reporta riscos textuais
Verificar, revisar ou solicitar revisão$short-drama-review
Apenas inspecionar ou diagnosticar sensação de template / escrita por IAfresh $short-drama-review, apenas envia findings com evidências
Remover diretamente o 'gosto de IA', polir ou editar pontualmente$short-drama-write, preservando a voz do autor e mostrando diferenças semânticas
Verificar primeiro, depois editarfresh review → write owner faz revisão pontual → fresh re-review
Abrir Dashboard, Central de Criação de Curtas ou gerenciar conteúdo de criação$short-drama dashboard: execute o contrato de inicialização do 'Dashboard Local' abaixo

A intenção explícita do criador tem prioridade sobre o 'próximo ponto de verificação' nominal. Look Development é uma ramificação opcional do projeto, não um pré-requisito universal; após a aceitação do ativo C2, prompts de imagem e storyboard são ramos paralelos; quando o criador quer apenas um deles, não force a espera pelo outro.

Se o contexto atual já participou da criação do arquivo alvo, a rota de revisão DEVE iniciar um fresh reviewer agent/context, passando apenas o alvo, as restrições aceitas e a checklist de revisão; se o ambiente de execução não suportar fresh agent, degrade transparentemente para auto-check PROVISIONAL, não pode trocar o nome do Skill como sendo uma revisão independente.

'Parece template / escrito por IA' é uma solicitação de diagnóstico; 'mude isso' é uma solicitação de revisão do owner. Não permita que o write owner faça autodiagnóstico e emita conclusão para si mesmo, nem que o reviewer ultrapasse a autoridade e edite diretamente o texto. Solicitações combinadas: primeiro congele a versão alvo, um fresh reviewer localiza evidências e danos, depois passe ao write owner apenas para editar o escopo aceito e, por fim, um fresh reviewer diferente faz re-review do novo hash; qualquer etapa que não consiga obter contexto independente permanece PROVISIONAL.

Inicialização

Quando não há projeto e o usuário deseja inicializar:

  1. Apenas confirme ou infira razoavelmente os valores padrão do formato reversível: título, idioma, idioma do prompt, proporção de tela, caminho; número de episódios/duração deixe em branco se desconhecido. O idioma padrão é o idioma atualmente usado pelo criador; o idioma do prompt padrão é en; se o criador explicitamente solicitar que o prompt também use o idioma do projeto, siga a solicitação do criador, não julgue as consequências de qualidade.
  2. Copie o template do projeto, sem sobrescrever arquivos existentes do criador.
  3. Crie diretórios de estágio vazios e limites de entrada não públicos.
  4. Em short-drama.json#/creator_authority, crie restrições vazias do criador, direção visual e configuração de produção; eles são inicialmente unset, e os ativos e seus downstream exigem que a forma esteja definida – portanto, após a inicialização, informe ao criador: Definir a forma de produção é a próxima ação mais útil, a entrada está neste skill (veja tabela de roteamento por intenção), não em qualquer sub-skill; a escolha real é registrada em um registro de decisão conforme mostrado em creator-decision.example.jsonl.
  5. Registre a versão do conjunto, a versão do contrato e cinco estados vazios independentes entre si.
  6. Informe o caminho do projeto e a ação mais útil para o criador.

A inicialização não gera motores de história, roteiros ou tabelas de definição de ativos.

Se durante a fase de desenvolvimento um project-development/director-brief.md for enviado, primeiro mostre ao criador suas diferenças semânticas em relação ao visual_direction / production_profile atuais; somente após aceitação explícita, o roteamento promove a escolha correspondente para short-drama.json#/creator_authority. O arquivo candidato em si não possui autoridade de criador.

Dashboard Local

Quando o usuário invoca $short-drama dashboard, não repasse para sub-skills; inicie diretamente o dashboard de criação de curtas local deste skill:

  1. Primeiro, verifique o conjunto e recupere transações pendentes conforme runtime-preflight.md.

  2. Se o diretório de trabalho estiver dentro de um projeto, use a raiz desse projeto como workspace; caso contrário, use o diretório contêiner explicitamente fornecido pelo usuário; se não fornecido, use o diretório atual. Não escaneie fora do workspace.

  3. Execute a partir do diretório de instalação deste skill:

    python3 <short-drama-skill-dir>/scripts/dashboard_server.py --workspace <workspace> --port 0 --open
    
  4. Mantenha o processo em execução e reporte o endereço de loopback completo impresso pelo script (incluindo o fragmento de sessão desta inicialização) e a forma de parar. Se o navegador não abrir automaticamente, mantenha o serviço e peça ao usuário para abrir o endereço completo.

O Dashboard tem apenas uma página de criação: à esquerda, um índice de conteúdo popular organizado por projeto e episódio; à direita, o corpo principal persistente. Após abrir um projeto, o roteiro é carregado automaticamente; trocar de conteúdo apenas substitui o corpo, não abre nova página ou overlay. Tarefas e exportação aparecem apenas como dicas curtas abaixo do corpo. A interface não mostra árvore de arquivos, caminhos reais, formatos estruturados, detalhes de ciclo de vida ou entrada de engenharia. Markdown é lido e editado como texto corrido; dados estruturados são convertidos em cartões; imagens e vídeos são apenas visualizados. short-drama.json, .short-drama/**, decisões do criador, evidências de verificação e validação de exportação são gerenciados pelo sistema e não se tornam navegação para o criador. Salvar significa apenas salvar a modificação, não substitui a aceitação explícita de uma versão pelo criador. Ele não se conecta a fontes de dados externas, não chama interfaces de geração de mídia e não injeta chaves no navegador. Cada inicialização gera um token de sessão e caminho de API independentes; o navegador troca o fragmento de endereço por uma sessão HttpOnly local; a API do projeto aceita apenas essa sessão. Parâmetros específicos estão em lifecycle-commands.md.

Ferramentas Determinísticas

Invoque scripts/project_tool.py a partir do diretório de instalação deste skill, sem depender do diretório de trabalho atual:

ComandoUso
initInicializar projeto mínimo
statusLer ciclo de vida e resumo de recuperação
recoverRecuperar todas ou transações especificadas
publishPublicar candidate via log de pré-escrita, sem anexar aceitação ou conclusão de revisão
acceptAceitar alvo candidate exato com registro de decisão do criador
reviewAtualizar estado de verificação e revisão com conclusão de revisão independente
packageRe-verificar cinco eixos, dependências e evidências, depois gerar pacote de entrega de texto
verifyRe-verificar o pacote de entrega com sua soma de verificação e relatar novos arquivos não registrados

Leia lifecycle-commands.md para exemplos completos de chamada, logs de pré-escrita, aceitação, revisão, impacto de expiração downstream e restrições de empacotamento – apenas ao realmente invocar esses comandos, diagnosticar falhas ou verificar o formato do registro.

Estado e Próximos Passos

Explique no idioma do criador:

  • Origens que existem e estão no estado accepted;
  • Conteúdo no estado provisional, stale, blocked ou aguardando aceitação do criador;
  • Ramos que podem ser iniciados em paralelo no momento;
  • A ação mínima para impulsionar o resultado solicitado pelo usuário.

A menos que o usuário solicite diagnóstico, não imprima hash, IDs de transação, estruturas de dados internas ou conteúdo de estado bruto. Os cinco estados são independentes entre si: construção, verificação, aceitação do criador, revisão independente e verificação de entrega; não use um accepted para fingir todos.

Recuperação e Revisão

Recupere a operação não concluída mais antiga dentro do escopo solicitado pelo usuário, não a mais antiga do projeto inteiro. Antes de alterar conteúdo já confirmado:

  1. Indique o skill responsável pela modificação;
  2. Mostre a mudança semântica proposta;
  3. Liste a lista precisa de impactos downstream;
  4. Obtenha aceitação do criador quando necessário;
  5. Passe ao responsável para modificar e re-revisar o novo hash.

Transações incompletas sem COMMIT revertem para a última versão salva; transações incompletas com COMMIT continuam até candidate e completam o estado. A recuperação deve ler antes de escrever e ser repetível; alterações externas que não podem ser confirmadas devem ser marcadas como conflict, não podem ser sobrescritas.

Entrega

Primeiro, roteie para um contexto de revisão fresh de $short-drama-review para verificar, depois empacote quando a verificação de entrega estiver pronta. Inclua apenas roteiros, listas, prompts, revisões, notas do criador e somas de verificação no estado accepted. Exclua mídias binárias, entradas não públicas, estado de máquina, caminhos absolutos, credenciais, materiais de origem não públicos e rascunhos não aprovados.

Limites

  • Use apenas a inferência de texto do agente atual; não chame geração de mídia ou interfaces de serviço.
  • Não recupere fontes de produção externas ou não públicas em tempo de execução.
  • Não eleve casos vistos em outro lugar a leis de criação.
  • O responsável não pode revisar seu próprio trabalho.
  • Conflitos semânticos não são corrigidos silenciosamente.

Habilidades Relacionadas