Communitygithub.com

story-to-storyboard

Gera pacotes estruturados de storyboard para livros ilustrados infantis, incluindo frases em inglês, tradução, prompts de desenho e dublagem, com base no tema fornecido pelo usuário.

O que é story-to-storyboard?

Esta skill transforma um tema de livro ilustrado infantil em um pacote completo de storyboard, ideal para criadores de conteúdo de aprendizado de inglês infantil. A partir de um tema simples ou enredo fornecido pelo usuário, a skill gera automaticamente uma sequência de quadros, cada um contendo: uma frase curta em inglês, sua tradução para o português, um prompt de desenho no estilo lápis de cera e giz pastel (com termos negativos fixos), um prompt de vídeo (com termos negativos fixos), quatro palavras-chave (cor, tamanho, verbo de ação, lugar) e um prompt de dublagem formatado para o motor Volc Engine seed-audio-1.0. A skill segue uma estrutura rígida de 6 linhas por quadro, com regras precisas para cada elemento. Ela suporta plataformas como Claude Code, Cursor e Codex, e prioriza a consistência entre os prompts de desenho e vídeo, garantindo que a história seja traduzida visualmente. Um recurso opcional de otimização de prompt de desenho via MCP está disponível, mas atualmente desativado por padrão. A skill também inclui scripts de validação para garantir a conformidade com os modelos e a integridade do storyboard.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LuckClover445/VideoSkills/tree/HEAD/story-to-storyboard

Perguntar na sua IA favorita

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

Documentação

Geração de Storyboard para Livro Ilustrado Infantil

Este arquivo define apenas a camada de organização: entrada, estrutura de entrega, ordem de execução e validação. As regras específicas e modelos para criação de história, prompts de desenho, prompts de vídeo e prompts de dublagem estão todos localizados nos arquivos a seguir. Este arquivo não contém nem repete seu conteúdo.

ArquivoConteúdo Responsável
references/story.mdTodas as regras e etapas de execução para a fase de história, definidas pelo próprio arquivo
references/creativity-path.mdCaminho criativo opcional (desativado por padrão): contrato de interface e fontes de valores substituíveis
references/drawing-prompt.mdRegras para a fase de prompt de desenho, incluindo o modelo original e os termos negativos de desenho (única cópia em toda a skill)
references/video-prompt.mdRegras para a fase de prompt de vídeo, incluindo termos negativos de vídeo e formato de frase final (única cópia em toda a skill)
references/voice-prompt.mdRegras para a fase de prompt de dublagem, incluindo termos negativos de dublagem, formato de frase final e mapeamento de campos para três plataformas (única cópia em toda a skill)
references/mcp-setup.mdGuia de configuração MCP para otimização de prompt de desenho, atualmente desativado e não participa da execução, lido apenas quando esse recurso é ativado
references/example.mdExemplo de formato final para regressão de script
scripts/pick_direction.pyFonte de valores para o caminho criativo (opcional)
scripts/check_storyboard_md.pyCompara o arquivo final com os dois modelos originais, palavra por palavra

Pré-condições

O tema do livro ilustrado é fornecido pelo usuário. Pode ser um tema simples (apenas personagem principal e cenário) ou um tema com enredo (já incluindo desejo e obstáculo). Quando o tema não for fornecido, processe as fontes candidatas de acordo com references/story.md e o usuário seleciona; se as fontes não tiverem resultados, encerre e solicite o tema. Não invente um tema nem produza exemplos primeiro.

Ponto de Entrada Externo

Entrada do UsuárioConteúdo de Entrega
Um tema de livro ilustrado (ex.: "A Lua e a Estrelinha")Um pacote de storyboard, cada quadro com 6 linhas; número padrão de quadros definido por references/story.md
Tema não fornecido e permissão para a skill escolherVários temas candidatos (nome do tema, direção em uma frase, personagem principal, ambiente); não produz storyboard diretamente; após a seleção, entregue conforme a linha anterior

Quando o usuário solicitar apenas prompts de vídeo ou prompts de geração de vídeo a partir de imagem, explique que esse conteúdo faz parte do processo interno da skill e não é entregue separadamente, e peça ao usuário que forneça o tema do livro ilustrado. Após o fornecimento do tema, o prompt de vídeo é escrito na linha seguinte a "→ Prompt de desenho:". Não deduza storyboards para atender a tais solicitações.

Estrutura de Entrega (Obrigatória, Imutável)

Cada quadro tem exatamente 6 linhas, ordem fixa:

【Quadro X】
Frase curta em inglês
→ Tradução para português
→ Prompt de desenho: <Preenchido palavra por palavra conforme o modelo original em references/drawing-prompt.md>. Negativos: <Termos negativos de desenho do mesmo arquivo>
→ Prompt de vídeo: <Conforme o formato de frase final em references/video-prompt.md, com termos negativos no final>
→ Palavras-chave: 【cor / tamanho / verbo de ação / lugar】
→ Prompt de dublagem: <Conforme o formato de frase final em references/voice-prompt.md, com termos negativos de dublagem no final>

Cinco restrições obrigatórias:

  • A frase curta em inglês ocupa a primeira linha sozinha, sem aspas, parênteses, notas ou descrições do quadro.
  • Os termos negativos de desenho são colocados no final da mesma linha do prompt de desenho, precedidos por "Negativos:"; sem quebra de linha, sem resumo no final do quadro.
  • O prompt de vídeo segue imediatamente a linha do prompt de desenho, comprimido em um parágrafo, sem tags ①②③, sem seção separada.
  • As palavras-chave são fixas na 5ª linha, ordem inalterada, cada uma correspondendo ao conteúdo específico do quadro.
  • O prompt de dublagem é fixo na 6ª linha, a última do quadro. O texto para leitura deve ser idêntico, palavra por palavra, à frase curta em inglês da 1ª linha. Os parâmetros são escritos como campos que podem ser inseridos em um modelo de áudio.

Nota de nível de arquivo: Escreva uma linha de orçamento de leitura (segundos de vídeo e segundos de orçamento para cada quadro) antes do primeiro "【Quadro X】", para alinhamento com um modelo de voz independente; esta linha é uma nota de nível de arquivo, não inserida em nenhum quadro, não altera as 6 linhas de cada quadro.

Ordem de Execução

  1. Conclua a etapa de história de acordo com references/story.md, produzindo as frases curtas em inglês e as traduções para o português de cada quadro.
  2. Conclua a etapa de prompt de desenho de acordo com references/drawing-prompt.md, produzindo a linha de prompt de desenho e a linha de palavras-chave de cada quadro. A otimização de desenho está atualmente desativada (consulte "Recurso Externo: Otimização de Prompt de Desenho"), produza diretamente, sem detectar ou chamar.
  3. Conclua a etapa de prompt de vídeo de acordo com references/video-prompt.md, produzindo a linha de prompt de vídeo de cada quadro.
  4. Conclua a etapa de prompt de dublagem de acordo com references/voice-prompt.md, produzindo a linha de prompt de dublagem de cada quadro.
  5. Execute python scripts/check_storyboard_md.py <arquivo_final.md> --theme "<tema>" para validação. Erros devem ser corrigidos até a aprovação. A dublagem é pós-processada por um modelo de voz independente, não sai junto com o vídeo; se os segundos de leitura reais forem obtidos, revalide com --voice-seconds "1:3.8,2:4.2". Se exceder o orçamento, encurte a frase primeiro, não estenda o vídeo.

Requisito de transição: O próximo passo baseia-se no produto do passo anterior; quando um passo subsequente entrar em conflito com a etapa anterior, reverta a etapa anterior, não force a autoconsistência no passo subsequente. O script valida apenas o formato e a consistência com os modelos. A verificação semântica, se a frase em inglês é bem representada, é responsabilidade do conteúdo de cada arquivo de referência.

Recurso Externo: Otimização de Prompt de Desenho (Opcional)

Estado Atual: Desativado. O prompt-optimizer ainda não está maduro. Por padrão, na execução, não detecta, pergunta, configura ou chama, nem lê references/mcp-setup.md. Os prompts de desenho são produzidos diretamente de acordo com references/drawing-prompt.md. As subseções a seguir são mantidas como regras para quando o recurso for ativado. A menos que o usuário solicite explicitamente "ativar otimização de prompt de desenho" na conversa, elas não serão executadas.

Quando ativado, após escrever o prompt de desenho, ele pode ser enviado a este MCP para uma otimização de redação no texto final já preenchido com os quatro slots. Este MCP é uma etapa de pós-processamento, não de geração de prompt: a lógica existente de entender o significado da frase, descrever a imagem em linguagem simples, preencher slots, montar o modelo e anexar os termos negativos é executada inalterada; o MCP apenas reescreve o texto dentro dos slots depois disso. Independentemente de estar ativado ou não, a forma de produção da etapa de desenho permanece a mesma. A falta dele significa apenas uma polidura a menos, não uma via de geração ausente.

Este recurso não é essencial; sua ausência ou indisponibilidade não bloqueia a entrega, e não se deve atrasar ou desistir da produção para usá-lo. Quando ativado, a configuração do MCP é executada pelo agente atual após confirmação do usuário: localizar o arquivo de configuração, fazer backup, mesclar entradas, validar e escrever de volta, tudo de acordo com "Etapas de configuração executadas pelo agente atual" em references/mcp-setup.md.

Contrato de Chamada (Desativado, para Referência)

A entrada do MCP é apenas uma coisa: o prompt de desenho já gerado para aquele quadro. Nenhum outro contexto é enviado.

  • Entrada: O texto completo do prompt de desenho daquele quadro, do início do modelo "【Proporção da tela】" até o final dos termos negativos. Sem tags como "→ Prompt de desenho:", sem número do quadro, sem prefácio ou sufixo.
  • Saída: Apenas o texto dentro dos três slots é adotado. As frases fixas do modelo e os termos negativos ainda seguem o texto original desta skill, não a versão retornada pelo MCP.
  • Proibido: Tema do livro ilustrado, frase curta em inglês e tradução, linha de palavras-chave, linhas de vídeo e dublagem, conteúdo de outros quadros, cartão de história, requisitos de estilo, histórico de conversa, regras da skill. Não anexe antecedentes como "Por favor, entenda esta história primeiro" ou "Este é um livro infantil" antes ou depois do prompt, nem combine prompts de vários quadros em uma única solicitação.
  • Um de cada vez: A chamada processa apenas o quadro atual; o texto retornado do quadro anterior não deve ser anexado à entrada do próximo quadro, para evitar contaminação cruzada.
  • Campos Obrigatórios: Se o schema da ferramenta tiver outros campos obrigatórios, preencha apenas com valores neutros diretamente relacionados a "otimizar este prompt" (como idioma, tipo de tarefa), não use esses campos para transmitir o tema ou o conteúdo da história.
  • Sem ida e volta: Uma chamada, uma adoção. Sem perguntas de acompanhamento, sem esclarecimentos de múltiplas rodadas. Se o retorno for inutilizável, reverta de acordo com "Restrições de Resultado de Otimização".

Detecção Pré-execução (Desativado, para Referência; Executado Uma Vez Antes do Início do Processo, Quando Ativado)

A detecção é concluída antes do passo 1, feita apenas uma vez para toda a rodada, sem repetir perguntas dentro dos quadros.

Obter Lista de MCPs: Leia os serviços MCP montados na sessão atual e a lista de ferramentas disponíveis, confirme se existe um prompt-optimizer (http://47.251.140.61:8081/mcp) e suas ferramentas fornecidas. Quando a lista não puder ser lida diretamente, pesquise ferramentas com a palavra-chave prompt optimizer. O julgamento é baseado em "o serviço existe e suas ferramentas podem ser chamadas", não no aparecimento da URL no diálogo, e não invente nomes de ferramentas por suposição.

Resultado da DetecçãoAção
MontadoNão pergunte, não sugira instalação, mas informe ao usuário que este MCP será chamado para otimizar os prompts de desenho (uma linha de status, sem pop-up), depois use diretamente de acordo com o "Contrato de Chamada"
Não montadoPergunte com um pop-up de confirmação se o usuário deseja instalar, explicando que este é um recurso opcional de otimização secundária de prompt de desenho e que não instalá-lo não afeta a produção do storyboard. Duas opções: Configurar agora, Não configurar agora
Selecionar "Configurar agora"Leia references/mcp-setup.md, o agente atual executa a configuração de acordo com suas "Etapas de configuração executadas pelo agente atual": confirmar o cliente e a localização do arquivo de configuração, fazer backup, mesclar entradas, validar JSON; depois releia a lista de MCPs para verificar novamente. Se a verificação for aprovada, informe ao usuário "Configuração bem-sucedida. O prompt-optimizer será chamado para otimizar os prompts de desenho nas próximas etapas", então prossiga para o passo 1 e ative a otimização no passo 2
Selecionar "Não configurar agora"Não pergunte novamente nesta rodada; pule a otimização completamente e entregue os prompts de desenho originais
  • Se o agente atual não tiver permissão de escrita, não encontrar o arquivo de configuração ou se o cliente exigir reinicialização para reconhecer: envie o trecho de configuração do arquivo inteiro para o usuário, instruindo-o a executar ou reiniciar; esta sessão continua como se não estivesse montado, sem esperar ou bloquear; observe na nota de entrega.
  • A recusa é lembrada apenas dentro desta sessão, não gravada em preferências de longo prazo nem altera os arquivos da skill. Na próxima execução, a detecção e a pergunta serão repetidas.
  • Se a capacidade de pop-up não estiver disponível, substitua por uma pergunta curta, mantendo as duas opções.
  • Se o usuário escolher "Configurar agora", mas até o passo 2 a otimização não estiver em vigor (não instalada ou não reiniciada), não faça um segundo pop-up, continue como não montado e observe na nota de entrega.

Chamada Intraquadro (Desativado, para Referência; Executado Após Cada Linha de Desenho Ser Escrita, Quando Ativado)

  • Após cada linha de desenho ser escrita, faça uma chamada. Os parâmetros seguem o "Contrato de Chamada".
  • A chamada deve ser visível: Não chame silenciosamente. Antes da chamada, imprima uma linha de status explicando o objeto e o quadro, por exemplo, "Chamando MCP prompt-optimizer para otimizar o prompt de desenho do Quadro 3"; após a chamada, imprima uma linha de resultado explicando se foi adotado (Adotado / Revertido, com uma breve razão).
  • Chamada bem-sucedida: Extraia apenas o texto dentro dos três slots, verifique novamente de acordo com "Restrições de Resultado de Otimização" e escreva de volta na linha de desenho do quadro; as frases fixas do modelo e os termos negativos ainda seguem o texto original desta skill.
  • Chamada falhou, expirou ou retornou vazia: Tente novamente no máximo mais uma vez; se ainda falhar, pule o quadro, marque como "Não otimizado (falha de conexão)", e o processo continua.
  • Não pergunte ao usuário dentro de um quadro, não repita a confirmação de configuração, nem refaça o quadro anterior devido à falha de um único quadro.

Restrições de Resultado de Otimização

  1. Apenas otimize a redação, não redefina a imagem. Quem é o personagem principal, a quantidade, a pose, a orientação, a interação, o cenário e a iluminação não podem ser alterados. As alterações permitidas são limitadas a redação, precisão de detalhes visíveis e ordem das palavras. Não esvazie os slots, não remova informações existentes, não expanda para uma segunda ação.
  2. Frases fixas do modelo permanecem inalteradas, palavra por palavra. O texto original de "estilo de ilustração de livro infantil" a "luz suave, sem sombras duras, amigável para crianças pequenas, imagem sem texto interno, marcas d'água ou assinaturas" não pode ser adicionado, removido ou alterado; apenas o texto dentro dos três slots (personagem principal da cena, interação do personagem principal, ambiente/cenário) pode ser reescrito.
  3. Termos negativos permanecem inalterados. O texto otimizado não contém "Negativos:" e seu conteúdo subsequente; os termos negativos ainda são adicionados pela skill no final da linha.
  4. Restrições factuais permanecem inalteradas. Não adicione personagens, adereços ou cenários que não existem na frase curta em inglês; após a reescrita, ainda deve ser possível deduzir a frase.
  5. O script é a autoridade final. O quadro otimizado deve passar novamente por check_storyboard_md.py; se falhar, reverta para o texto original do quadro antes da otimização e registre o motivo da reversão.
  6. Os downstream usam a versão final. Os prompts de vídeo (passo 3) e os prompts de dublagem (passo 4) leem a linha de desenho otimizada. Se a otimização alterou a pose ou o cenário, a linha de vídeo do quadro deve ser reescrita, não use a versão pré-otimização.

Marcação de Entrega

Quando desativado, nenhuma marcação de otimização é feita. Quando ativado, a nota de entrega indica quais quadros foram otimizados pelo MCP, quais foram pulados e o motivo (não configurado, recusado pelo usuário, falha de conexão). Em nenhum dos casos, marcas são escritas dentro das linhas do quadro final, e a estrutura de 6 linhas não é alterada.

Produtos e Convenção de Carregamento

O custo de contexto desta skill é determinado principalmente por duas coisas: se o arquivo de referência inteiro é lido repetidamente e se os resultados intermediários existem apenas na conversa. Ambas devem ser restritas.

1. Convenção de Produtos

Um arquivo Markdown final é o único portador cumulativo ao longo de todo o processo. Cada etapa escreve apenas sua própria parte. Os downstream leem apenas o produto final e não repetem o conteúdo upstream.

PassoProdutoPortador
1 HistóriaCartão de história: lista de personagens principais, ambiente, desejo, obstáculo, resolução, conclusão; uma frase curta em inglês e sua tradução para o português por quadroTítulo do quadro e primeiras três linhas do arquivo final
2 DesenhoLinha de prompt de desenho de cada quadro (com termos negativos), linha de palavras-chaveMesmo arquivo, adicionado quadro por quadro
3 VídeoLinha de prompt de vídeo de cada quadro (com termos negativos); linha de orçamento de leitura no cabeçalho do arquivoMesmo arquivo, inserido após a linha de desenho do quadro; a linha de orçamento é escrita apenas uma vez antes do primeiro quadro
4 DublagemLinha de prompt de dublagem de cada quadro (com termos negativos)Mesmo arquivo, adicionado após a linha de palavras-chave do quadro
5 ValidaçãoSaída do scriptEco do comando, não salvo em disco
  • Avance quadro por quadro: complete um quadro antes de passar para o próximo, não escreva todas as frases dos seis quadros primeiro e depois volte para preencher os prompts.
  • Depois que o conteúdo intermediário for escrito no arquivo final ou no bloco de diálogo, não o repita. Ao fazer correções, altere apenas esse trecho, não reescreva o arquivo inteiro.
  • O arquivo final é colocado por padrão no diretório output no mesmo nível do diretório da skill, ou seja, <diretório_da_skill>/../output/; nomeado como Tema - Storyboard e Prompts.md. Crie o diretório se ele não existir. Quando o usuário especificar explicitamente um caminho de saída, use o caminho especificado pelo usuário.

2. Convenção de Carregamento

Leia os trechos necessários por etapa, não carregue o arquivo inteiro. Conteúdo já lido não é relido. O modelo original é citado apenas ao escrever, não repetido na resposta.

PassoLeitura ObrigatóriaLeitura Sob DemandaNão Ler
1 HistóriaSeções 2, 5, 6, 7, 8, 9 de story.mdSeção 1 (princípios criativos), Seção 3 (três perguntas, durante a autoverificação); ao ativar o caminho criativo, leia creativity-path.mdSeção 10 (registros de exclusão); creativity-path.md quando não ativado
2 DesenhoModelo original, termos negativos de desenho, mapeamento de slots, regras de montagem de linha de drawing-prompt.mdOrdem de geração de imagem (apenas se o usuário solicitar imagens); método de correção de quebra (apenas durante retrabalho)Parágrafo de explicação da fonte; mcp-setup.md (não lido quando a otimização está desativada)
3 VídeoForma final, duração do idioma e margem de tela, compreensão em duas etapas, cinco dimensões de detalhes de video-prompt.mdLista de verbos de ação (leia apenas a parte correspondente ao tipo de personagem principal); lista de autoverificação (primeiro uso ou quando não qualificado)Exemplos A/B (depois que o formato estiver dominado)
4 DublagemForma final, parâmetros, método de escrita dos quatro elementos de voice-prompt.mdMapeamento de campos da plataforma (ao trocar de plataforma); lista de autoverificação (primeiro uso ou quando não qualificado)Exemplos (depois que o formato estiver dominado)
5 ValidaçãoComando de validaçãoexample.md (apenas durante regressão de formato e apenas para comparar a estrutura da frase)Todo o resto
  • example.md não é lido por padrão; o formato já é definido pela estrutura de entrega deste arquivo, sem necessidade de um exemplo para confirmar o layout.
  • Os seis quadros compartilham o mesmo modelo e o mesmo conjunto de termos negativos; leia apenas uma vez. Ao escrever os quadros 2 a 6, não carregue novamente o mesmo arquivo.

Disciplina de Citação

  • O modelo original, os termos negativos de desenho, os termos negativos de vídeo e os termos negativos de dublagem têm cada um uma única cópia, localizada no arquivo de referência correspondente. Aparecer em outros arquivos é considerado um erro.
  • Ao preencher, copie todo o trecho e substitua os slots. Não reorganize a estrutura da frase. Não omita nenhuma frase fixa separada por ponto e vírgula.
  • Em caso de conflito entre a frase fixa do modelo e a especificação estabelecida, o modelo prevalece. Se for necessário ajustar a especificação, modifique o próprio arquivo de modelo e execute a validação em sincronia.
  • O timbre, tom e volume da dublagem são consistentes em todos os seis quadros; apenas a emoção e a ênfase variam com a frase. Ao trocar para outra plataforma de áudio, converta de acordo com a tabela de mapeamento em voice-prompt.md, sem alterar a semântica dos campos.

Método de Entrega

  • Produza o conteúdo completo diretamente na conversa (número de quadros conforme references/story.md, cada quadro com 6 linhas). Não forneça um resumo como substituto.
  • Quando o usuário solicitar um arquivo, por padrão, escreva o Markdown no diretório output no mesmo nível do diretório da skill, nomeado como Tema - Storyboard e Prompts.md, e execute o script de validação. Exceto quando o usuário especificar explicitamente um caminho.

Habilidades Relacionadas