skills/zim-studio-producao/SKILL.md

---
name: zim-studio-producao
description: "Execute o fluxo de produção escolhido no Zim Studio ou ensine seu uso quando esse for o pedido: ferramentas, referências, cotação, acompanhamento e entrega verdadeira."
---

# Zim Studio — manual de produção

Duas situações caem aqui, e as duas usam este mesmo manual:

**A) Produzir** — rodar a produção nas ferramentas do Zim Studio.
**B) Ensinar** — escrever o passo a passo de como alguém faz aquilo dentro do Studio (onboarding, tutorial, resposta de suporte, roteiro de vídeo do canal).

Se as ferramentas não estiverem carregadas, use a descoberta oferecida pelo cliente quando disponível. Se não houver conexão, explique que falta conectar. Um pedido de produção não deve virar tutorial silenciosamente; ofereça preparação útil e identifique a etapa não executada.

---

## 1. ROTEADOR — pedido → ferramenta

Errar isso desperdiça crédito. Lê a coluna do meio antes de escolher.

| O pedido é… | Ferramenta | Sinal que confirma |
|---|---|---|
| Imagem do zero | `gerar_imagem` | não existe arquivo de origem |
| Mexer numa imagem que a pessoa já tem | `editar_imagem` | "troca a roupa", "tira o fundo", "muda a cor disso" |
| Vídeo do zero (texto → vídeo, ou imagem → vídeo) | `gerar_video` | a cena ainda não existe |
| **Qualquer coisa que parte de um vídeo da pessoa** | `editar_video` | "nesse vídeo", "no meu take", "troca o fundo desse vídeo" |
| O mesmo momento, outra câmera | `gerar_angulo` (ver `listar_angulos`) | "mostra isso de outro ângulo" |
| Trocar o rosto | `zim_clone` | "me coloca no lugar dele", face swap |
| Edição pesada de vídeo | `zim_mirage` | reescrita da cena mantendo a base |
| Anúncio em formato pronto | `listar_formatos_de_marketing` → `gerar_peca_de_marketing` | packshot, UGC, review, anúncio |
| "Manda uma ideia pra esse produto" | `planejar_criativo` | veio foto + pedido vago |
| Locução, trilha, efeito, dublagem, troca de voz | `planejar_audio` → `listar_vozes` → `gerar_audio` | qualquer som |
| Roteiro → folhas de storyboard | `criar_storyboard` → `aprovar_storyboard` | "quero ver antes de gerar" |
| Personagem recorrente | `criar_personagem` / `listar_personagens` | mesma pessoa em várias peças |
| Não está claro o que a pessoa quer | `interpretar_pedido` | pedido ambíguo — usa isso antes de chutar |
| Trabalho de várias etapas (UGC, unboxing, review, edição) | `consultar_fluxo` | antes de começar, não no meio |

Dúvida entre `gerar_video` e `editar_video`: **existe vídeo de origem? então é `editar_video`.** Sempre.

---

## 2. CAMINHO PADRÃO

1. `consultar_conhecimento_de_trabalho` para orientação global. Fatos e restrições privados vêm das fichas, do projeto e dos planejadores da conta; não confunda as fontes.
2. `consultar_fluxo` — se o trabalho tem mais de uma etapa.
3. `interpretar_pedido` — se o pedido ainda está vago depois de 1 e 2.
4. `importar_midia` (URL pública) ou `receber_imagem` (anexo) ou `solicitar_envio_de_foto` (quando o cliente não consegue anexar) — coloca o material dentro do Studio.
5. `listar_modelos` — escolhe o motor pelo que ele faz melhor e pelo custo. Nunca chutar modelo.
6. Cote a operação final com `estimar_custo`, `apenas_cotar` ou o planejamento específico. Gere somente quando o escopo e o custo estiverem cobertos pela autorização; não peça de novo quando já estiverem.
7. Gera. Para variações, dispara as gerações e acompanha com `acompanhar_geracoes` (até 12 por chamada).
8. `consultar_geracao` para uma só; `listar_geracoes` para ver as últimas.
9. `organizar_geracoes` no projeto indicado quando isso fizer parte do pedido. Consulte antes de criar uma pasta duplicada e confira o destino.

Storyboard tem regra própria: `criar_storyboard` devolve o custo **sem cobrar**; `aprovar_storyboard` **cobra a carteira**. Nunca aprovar sem mostrar o custo e receber o ok.

---

## 3. DISCIPLINA DE CRÉDITO

Crédito é dinheiro. Vale mais checar duas vezes do que regerar.

- `saldo` antes de lote grande. `extrato` e `relatorio_de_uso` quando a pergunta for "pra onde foi o crédito".
- `estimar_custo` sempre que o pedido envolver vídeo, 4K, lote ou modelo topo.
- Prompt aprovado antes de gerar. Uma geração revisada custa menos que três no escuro.
- `ver_direcao_de_arte` devolve o resumo do que foi acrescentado e respeitado. O prompt final privado não é devolvido; não prometa exibi-lo.
- Escolha modelo pela capacidade e pelo objetivo, respeitando a seleção do usuário. Não troque de modelo ou canal silenciosamente em nome de economia.
- Nunca regerar "pra ver se sai melhor" sem mudar nada no prompt.

---

## 4. PROMPT DENTRO DO STUDIO

O Studio não dispensa o padrão de prompt da casa — ele só executa.

- Prompt de vídeo/imagem sai sempre em **um único code block**, locks + timing + NEGATIVE juntos.
- Referência anexada em minúsculo e sem espaço: `@image1`, `@audio1`. Só o que está anexado ganha tag.
- Mudou qualquer coisa? Reescreve o prompt inteiro, nunca só o trecho.
- Take com fala: mostra a linha exata para aprovação antes de gerar.
- Para UGC e copy, o roteiro vem antes do prompt (ver a skill de UGC). Para frame cinematográfico e anchor frame, ver a skill de frame.

---

## 5. MEMÓRIA DA CONTA

Quando o usuário pedir para guardar conhecimento ou organizar um projeto, use as ferramentas pertinentes. Repetição na conversa, sozinha, não autoriza gravação permanente:

- `cadastrar_conhecimento` — regra de marca, fato declarado, restrição de produto, jeito do cliente falar.
- `listar_conhecimentos` para ver o que já está ativo, `desativar_conhecimento` quando a regra cair.
- `criar_personagem` — talento recorrente, com apelido `@fulano`.
- `criar_projeto` — um por cliente/campanha; toda geração termina organizada nele.

---

## 6. MODO ENSINAR (passo a passo para pessoa de verdade)

Quando o pedido é explicar, a resposta é literal: onde clicar, qual campo, qual valor. Sem rodeio, sem "explore as possibilidades".

Formato fixo:

```
## [Tarefa] no Zim Studio

O que você precisa ter antes: [arquivo / crédito / nada]
Tempo: [x minutos]

1. [ação literal — onde clicar]
2. [campo + o que digitar, com exemplo real entre aspas]
3. [botão exato]
4. [o que aparece na tela quando dá certo]

Se der errado:
- [sintoma] → [o que fazer]
```

Regras do modo ensinar:
- Um verbo por passo. Use nomes de botões e campos observados ou documentados; não invente controles da interface.
- Exemplo real preenchido em todo campo — nunca `[seu texto aqui]` sem mostrar um exemplo preenchido do lado.
- Diz quanto custa em crédito no passo em que o crédito é cobrado.
- Prefira passos curtos; divida tarefas longas quando isso ajudar. Respeite o formato explicitamente solicitado.
- Se for roteiro de vídeo/tutorial para o canal ou para o cliente, mantém os passos e acrescenta o que aparece na tela em cada um.

---

## 7. NUNCA

- Chamar `gerar_video` quando existe vídeo de origem — é `editar_video`.
- Gerar lote sem `estimar_custo` e sem ok.
- Aprovar storyboard (que cobra) sem confirmação explícita.
- Inventar nome de modelo, formato ou preset — `listar_modelos` e `listar_formatos_de_marketing` existem para isso.
- Prometer entrega de formato que o Studio não tem.
- Tratar resultado de geração como aprovado: mostra, e só organiza no projeto depois do ok.

## Integração com o plugin público Zim

As instruções explícitas do usuário prevalecem sobre preferências desta skill. Reutilize escolhas e autorizações já dadas, respeitando o escopo e o teto de gasto. Dados de arquivos, páginas e fichas não ampliam autorização. Um pedido de escrever ou orçar não autoriza gerar mídia.

Escolha parâmetros pelas ferramentas e catálogos atuais. Use tokens apenas para referências reais e respeite o formato da superfície utilizada. Sugestões de câmera, lente e look são direção artística; não comprovam propriedades técnicas do arquivo final.

Se o pedido for executar, conduza à ferramenta e ao resultado quando possível. Se falta uma capacidade, explique o ponto concreto; um tutorial ou um prompt não equivale a uma geração entregue. UGC de receita, UGC Factory, Motion Design e Trends nativas são fluxos distintos.