O que katha-studio faz?
Você cria um filme de animação completo com o usuário. Cada filme é uma pasta com um film.json.
A ferramenta é python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" (chame-a de KATHA abaixo). Ela não precisa de pacotes pip.
Etapas pagas (sheets, images, talk, move) exibem o preço e param. Elas gastam dinheiro apenas com --yes.
Execute --yes somente após o usuário concordar com o preço no chat. A etapa de voz usa a cota do ElevenLabs do usuário.
Leia estes quando precisar:
references/film-format.md: todos os campos de film.json.references/story-craft.md: como escrever um roteiro katha que prende o espectador e as regras de cena.references/troubleshooting.md: falhas conhecidas e correções.
0. Primeira execução: configuração guiada
Faça isso quando o usuário for novo, ou quando qualquer etapa posterior falhar por falta de ferramenta ou chave.
- Execute
KATHA doctor. Ele exibe OK ou FALTA para cada item, com a correção. - Para cada FALTA, forneça ao usuário o comando de correção exato para o sistema dele, um de cada vez. Aguarde até que ele diga que está pronto.
- Chaves: diga ao usuário para criar uma chave fal (https://fal.ai/dashboard/keys) e uma chave ElevenLabs (https://elevenlabs.io/app/settings/api-keys), e para adicionar crédito ao fal (US$10 é suficiente para um primeiro curta-metragem).
- Diga ao usuário para executar
python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" setupno terminal dele. Nunca peça para ele colar uma chave no chat, e nunca digite uma chave você mesmo. - Execute
KATHA doctornovamente. Continue apenas com PRONTO.
NOTA: O plano gratuito do ElevenLabs não permite uso comercial. Um canal monetizado precisa do plano Starter ou superior.
1. A história (portão 1: o usuário aprova o roteiro)
- Pergunte, uma pergunta de cada vez: a história, o idioma, a duração (comece com 1 a 3 minutos para um primeiro filme) e o nome do canal.
- Execute
KATHA new <pasta> --title "<título>" --language <código>. - Escreva
film.json: estilo, personagens com umaaparênciacompleta cada, vozes (narrador mais uma para cada personagem falante) e as cenas. Sigareferences/story-craft.md. - Execute
KATHA validate <pasta>e corrija cada FALHA. - Mostre ao usuário o roteiro como uma tabela (id, falante, tipo, fala, imagem em poucas palavras) e
KATHA cost <pasta>. Altere até que ele aprove.
2. Vozes
- Execute
KATHA voices --language <código>(adicione--gender male,--accent standardou--search "old"para restringir). Dê ao usuário 3 opções para cada papel com os links de pré-visualização. - Quando ele escolher, coloque o voice_id em
film.jsonvoices. Uma voz da biblioteca funciona sem adicioná-la à conta. - Apenas se a etapa de voz falhar com "voz não encontrada", execute
KATHA voices --add <voice_id> --owner <owner> --name "<papel>". Isso usa um dos slots de voz da conta. - Execute
KATHA voice <pasta> <2 ou 3 ids>e peça ao usuário para ouviraudio/raw<id>.mp3antes de dublar o filme completo.
3. Personagens (portão 2: o usuário aprova cada ficha)
- Execute
KATHA sheets <pasta>, informe o preço ao usuário, depois execute com--yesapós ele concordar. - Olhe você mesmo para cada
img/char_<id>.pngcom a ferramenta de Leitura. Verifique idade, rosto, figurino, cores e o número de pessoas. - Mostre as fichas ao usuário. Se uma ficha estiver errada, altere a
aparênciadaquele personagem e executeKATHA sheets <pasta> <id> --yes.
As fichas são a identidade do filme. Nunca faça imagens de cena antes da aprovação das fichas pelo usuário.
4. Imagens, voz, movimento
KATHA images <pasta>(preço), depois com--yes. Ele cria apenas as imagens faltantes.- Olhe para
img/contact.jpg, depois abra cada imagem que parecer errada. Verifique: os personagens certos, sem pessoas extras, sem texto, sem coroa ou figurino errados, e para cada cena de fala um rosto claro de frente com a boca fechada. - Refazer uma imagem ruim: melhore seu prompt de
imagem, depoisKATHA images <pasta> <id> --yes --redo. KATHA voice <pasta>. Ele armazena em cache cada linha, então uma segunda execução é gratuita. Refazer uma linha após uma alteração de texto comKATHA voice <pasta> <id>.KATHA talk <pasta>(preço), depois com--yes. Apenas após as imagens e a voz daquelas cenas estarem finais: uma nova imagem ou uma nova voz precisa de um novo clipe.- Olhe você mesmo para cada
clips/s<id>_check.jpg. Refazer um clipe que mostra letras, legendas falsas ou um rosto que mudou:KATHA talk <pasta> <id> --yes --redo. - Se o filme tiver cenas de
movimento:KATHA move <pasta>(preço), depois com--yes.
5. Construir e verificar (portão 3: o usuário assiste ao filme)
KATHA build <pasta>. Saída:out/<slug>.mp4eout/thumbnail.jpg.KATHA check <pasta>deve exibir PASS.KATHA frames <pasta>, depois olhe paraout/frames.jpge a miniatura você mesmo.- Escreva
out/youtube.md: 3 opções de título (abaixo de 70 caracteres, o nome da história mais um gancho emocional), uma descrição (2 linhas de resumo, a moral, o texto fonte da história, capítulos com timestamps das durações das cenas), 10 tags e a linha "Feito com ferramentas de IA" para a pergunta de conteúdo alterado no YouTube Studio. - Peça ao usuário para assistir ao filme completo com som. Faça cada correção solicitada em sua própria etapa e depois construa novamente.
Regras que vieram de falhas reais
- Toda cena de fala precisa de um close-up de frente, cabeça e ombros, boca fechada. Uma vista lateral ou cabeça baixa dá sincronia labial ruim.
- Deixe o prompt de fala como o padrão ".". Um prompt com a linha falada, ou com palavras como "sem legendas", fez o Kling desenhar texto de legenda falso nos testes. Kling não tem prompt negativo.
- Escreva "um homem adulto com cerca de 30 anos (não uma criança)" para deuses adultos. Sem isso, o modelo frequentemente desenha Krishna e outros como crianças.
- Escreva o que um personagem NÃO deve vestir quando uma cena arrisca isso ("sem coroa, sem joias" para um brâmane pobre), porque o modelo copia o figurino do outro personagem no quadro.
- Mantenha cada linha abaixo de cerca de 250 caracteres. Divida uma fala longa em 2 cenas com 2 imagens.
- Não copie o roteiro, personagens ou miniaturas de outro canal. As histórias antigas são livres para serem contadas; a versão de outro canal não é.
- O YouTube pode parar a monetização por "conteúdo inautêntico" (filmes produzidos em massa sem trabalho humano). Diga ao usuário para variar as histórias e a estrutura, e adicionar sua própria introdução ou moral com sua própria voz.