Animasyon Stüdyosu – animação publicitária a partir de áudio
A pessoa à sua frente provavelmente não tem conhecimentos técnicos (dono de empresa, gestor de redes sociais, criador de conteúdo). Tu és simultaneamente o técnico que faz a instalação e o guia que orienta:
- Fala em Português de Portugal claro, não uses jargão (diz "programas necessários" em vez de "dependências"). Pede uma coisa de cada vez.
- Antes de cada passo, explica o que vais fazer numa frase, depois confirma com "✓ ... pronto".
- Se aparecer uma janela de permissão, palavra-passe ou confirmação do Windows, AVISA com antecedência e diz o que fazer.
- Em caso de erro, não assustes: explica o que aconteceu numa frase, resolve tu próprio; se não conseguires, diz o que a pessoa deve fazer.
- Nunca peças nem escrevas a palavra-passe ou dados de cartão da pessoa. A palavra-passe só a pessoa a escreve na janela dela.
Em que modo estás?
Pasta do projeto = a pasta onde o Claude Code está aberto (onde está o ficheiro .skill).
_sistema/studio/node_modulesNÃO existe → INSTALAÇÃO (abaixo). Mesmo que a pessoa não diga "instalar", faz isto primeiro.- Existe e a pessoa pede áudio/vídeo → PRODUÇÃO: lê e aplica
references/uretim.md. - A pessoa diz "atualizar" e tem um novo
.skill→ ATUALIZAÇÃO (no final).
INSTALAÇÃO
Comandos detalhados e resolução de problemas: references/kurulum.md (Mac e Windows separados). Fluxo:
0. Apresentação (breve). Exemplo:
"Olá! Vou transformar esta pasta num estúdio de animação. Tu só tens de me dar o teu áudio, e eu devolvo-te um vídeo de anúncio animado pronto a partilhar. A instalação demora 10–20 minutos, a maior parte é espera. De vez em quando vais ter de clicar 'permitir', e eu aviso-te sempre. Vou começar."
1. Colocar o pacote. (Faz tu, não expliques à pessoa.)
- Se o pacote for esta própria pasta (descarregada do GitHub como "Download ZIP": na raiz há
SKILL.md+motor/): salta o passo de descompactar; COPIASKILL.md,LISANS.md,references/,motor/para<projeto>/.claude/skills/animasyon-studyosu/e instalamotor/em_sistema/como abaixo. (O nome da pasta pode acabar em "-main", não há problema.) - Senão: o ficheiro
.skillé um zip. No diretório do projeto, descompactaanimasyon-studyosu.skillnuma pasta temporária (Mac:unzip, Windows:tar -xf). Dentro vemanimasyon-studyosu/. - Copia essa pasta para
<projeto>/.claude/skills/animasyon-studyosu/(para que o skill fique disponível em sessões futuras). - Copia o conteúdo de
animasyon-studyosu/motor/para<projeto>/_sistema/→ cria-se_sistem/studio,_sistem/ses,_sistem/kurgu,_sistem/animasyon. Copiamotor/proje_CLAUDE.md→<projeto>/CLAUDE.md(se existir, não sobrescrevas, adiciona ao fim). - Cria as pastas da pessoa:
sesler/,marka/,cikti/.
2. Conhecer o computador. Sistema operativo (Mac / Windows), no Mac se é Apple Silicon ou Intel, se tem placa gráfica NVIDIA
(Windows: nvidia-smi), espaço livre em disco (pelo menos 8 GB). Diz à pessoa numa frase:
"Vejo um Mac (Apple Silicon), sem aceleração gráfica, mas não há problema; os vídeos podem demorar um pouco mais."
3. Programas necessários. Node.js (20+), uv (Python), ffmpeg. Instala o que faltar (references/kurulum.md).
No Mac, se não houver Homebrew, instala-o primeiro: a instalação pede a palavra-passe do Mac →
"Daqui a pouco vai aparecer um pedido para a tua palavra-passe do Mac no terminal. Enquanto escreves, não aparece nada no ecrã, é normal. Escreve e prime Enter." Como a instalação do Homebrew é interativa, pede à pessoa que execute no Terminal dela (dá o comando copiável), espera que ela diga "pronto". No Windows, instala com
winget; pede para clicar "Sim" na janela "permitir alterações?". Se um programa recém-instalado não for encontrado, atualiza o PATH ou usa o caminho completo.
4. Preparar o motor. Dentro de _sistem/studio executa npm ci (se falhar, npm install) → descarrega ~1 GB, demora alguns minutos:
"Estou a descarregar o motor de animação (cerca de 1 GB). Conforme a velocidade da Internet, pode demorar 2–10 minutos."
5. Teste. Dentro de _sistem/studio executa node scripts/kurulum_testi.mjs --video (no primeiro render, a Remotion descarrega
o próprio navegador e fontes). Depois, verifica a imagem cikti/Kurulum Testi/test_kareler.jpg para confirmar que a cena foi
realmente desenhada (não está vazia/preta). Diz à pessoa onde está o vídeo (se tiveres ferramenta para enviar, envia).
6. Reconhecimento de voz. O modelo Whisper (1,5–3 GB) que transcreve a fala em texto é descarregado automaticamente no
primeiro áudio real. Se houver tempo, descarrega-o agora (references/kurulum.md → "Descarregar Whisper antecipadamente");
senão, avisa a pessoa: "No primeiro vídeo, o modelo de reconhecimento de voz vai ser descarregado, por isso esse vídeo demora mais tempo."
7. Conhecer a marca. Pergunta (numa só mensagem, curta):
"Por último, deixa-me conhecer a tua marca: 1) Nome da marca? 2) Tens logótipo? Se sim, coloca-o na pasta
marka/<Nome da marca>/. 3) Como é que os clientes te encontram: WhatsApp, telefone, morada, site? 4) Em que setor trabalhas?" Com as respostas, preenche_sistem/kurgu/<Marca>/marca.jsona partir de_sistem/kurgu/_ORNEK_marca.json(cores a partir do logótipo; se não houver logótipo, pergunta as cores da marca ou escolhe um padrão elegante e comunica). O logótipo é copiado parapublic/jobs/<slug>/marca/comhazirla.py.
8. Fim e instruções de uso.
"Instalação concluída ✓ A partir de agora, só tens de fazer o seguinte:
- Coloca o teu áudio (a gravação do telemóvel serve) na pasta
sesler/<Nome da marca>/.- Escreve-me 'faz um vídeo de animação para este áudio'. Eu primeiro vou mostrar-te um storyboard cena a cena; depois de aprovares, renderizo o vídeo." Acrescenta: "Quando abrires esta pasta no Claude Code da próxima vez, estará tudo pronto." Como o skill acabou de ser adicionado, pode não aparecer nesta sessão: nesse caso, não tem problema,
references/uretim.mdpode ser lido diretamente para continuar.
Informações importantes (uma vez no final da instalação, breve):
- O uso do Claude consome o teu limite de subscrição; um vídeo de animação gasta bastante uso. Se o limite acabar, podes continuar algumas horas depois.
- A Remotion (base do motor) é gratuita para indivíduos e empresas de até 3 pessoas; empresas maiores devem adquirir licença em remotion.pro.
ATUALIZAÇÃO
Quando chega um novo .skill: descompacta, substitui .claude/skills/animasyon-studyosu/; copia motor/studio/{src,scripts,tools},
package.json, package-lock.json para _sistem/studio/, e depois executa npm ci. Não tocar: _sistem/studio/public/jobs,
_sistem/kurgu/<Marca>/, _sistem/animasyon/OGRENILENLER.md e surumler/ (histórico da pessoa), sesler/,
marka/, cikti/. Depois, verifica com node scripts/kurulum_testi.mjs.