# Editor de Videos com IA — Guia de Instalacao

## O que essa skill faz?

Transforma videos brutos (depoimentos, aulas, mentorias) em Reels prontos para Instagram/TikTok:
- Transcreve automaticamente com IA
- Pontua e seleciona os melhores trechos
- Reordena na sequencia estrategica (BOMBA primeiro, CTA no final)
- Gera legendas estilizadas
- Cria capa + caption prontos pra postar

---

## Passo 1: Ter uma conta no Claude (Anthropic)

O Claude Code precisa da SUA conta na Anthropic. Voce precisa:
1. Ter um plano Claude Pro ou Team em https://claude.ai
2. Estar logada no Claude Code

**Se aparecer erro "OAuth token has expired" ou "Invalid authentication credentials":**
→ Rode `/login` dentro do Claude Code para reautenticar sua conta.

---

## Passo 2: Instalar o Claude Code

Se ainda nao tem o Claude Code instalado:

```bash
npm install -g @anthropic-ai/claude-code
```

Depois abra o terminal e rode `claude` pra confirmar que funciona.
Na primeira vez ele vai pedir pra voce fazer login — siga as instrucoes na tela.

---

## Passo 3: Instalar o ffmpeg

O ffmpeg e a ferramenta que corta, junta e processa os videos.

**Mac (com Homebrew):**
```bash
brew install ffmpeg
```

**Se nao tem o Homebrew:**
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install ffmpeg
```

**Verificar se instalou:**
```bash
ffmpeg -version
ffprobe -version
```

---

## Passo 4: Instalar o Python 3 + faster-whisper

O faster-whisper gera legendas com precisao de milissegundos.

**Mac (ja vem com Python 3, mas confirme):**
```bash
python3 --version
```

**Instalar faster-whisper:**
```bash
pip3 install faster-whisper
```

---

## Passo 5: Instalar o Node.js 20+

**Verificar se ja tem:**
```bash
node --version
```

Se for menor que v20, atualize:
```bash
brew install node
```

---

## Passo 6: Configurar sua chave de API (Gemini ou OpenAI)

A skill usa IA pra transcrever e analisar seus videos. Voce precisa de UMA das duas chaves:

### Opcao A: Google Gemini (recomendado — gratis ate certo limite)

1. Acesse: https://aistudio.google.com/apikey
2. Clique em "Create API Key"
3. Copie a chave

### Opcao B: OpenAI

1. Acesse: https://platform.openai.com/api-keys
2. Clique em "Create new secret key"
3. Copie a chave

**Salvar a chave:**

```bash
mkdir -p ~/depo-cutter
cat > ~/depo-cutter/.env << 'EOF'
# Coloque SUA chave aqui (escolha uma):
GEMINI_API_KEY=cole-sua-chave-aqui
# OPENAI_API_KEY=cole-sua-chave-aqui
EOF
```

Abra o arquivo `~/depo-cutter/.env` e substitua `cole-sua-chave-aqui` pela sua chave real.

**IMPORTANTE:** Essa chave e PESSOAL. Nao compartilhe com ninguem.

---

## Passo 7: Copiar a skill para sua maquina

Copie o arquivo `SKILL.md` para a pasta de skills do Claude Code:

```bash
mkdir -p ~/.claude/skills/editordevideos
```

Depois coloque o arquivo `SKILL.md` (que voce recebeu) dentro dessa pasta:

```
~/.claude/skills/editordevideos/SKILL.md
```

---

## Passo 8: Usar!

1. Coloque seus videos na pasta `~/depo-cutter/input/`
2. Abra o terminal e rode:

```bash
claude
```

3. Digite qualquer um dos comandos:

| Comando | O que faz |
|---------|-----------|
| `/editordevideos full` | Pipeline completo (transcreve + corta + compila) |
| `/editordevideos analyze` | So transcreve e pontua os videos |
| `/editordevideos cut` | Corta os melhores trechos |
| `/editordevideos compile` | Junta tudo num video final |
| `/editordevideos legendas` | Gera legendas estilizadas |
| `/editordevideos reels` | Transforma video longo em clips de 30-60s |
| `/editordevideos highlights` | Extrai os TOP 3 momentos |

---

## Checklist Rapido

Antes de usar, confirme que tudo esta instalado:

```bash
# Rodar esses comandos no terminal — todos devem funcionar:
ffmpeg -version
python3 --version
pip3 show faster-whisper
node --version
cat ~/depo-cutter/.env
ls ~/.claude/skills/editordevideos/SKILL.md
```

Se todos retornarem sem erro, esta pronto!

---

## Problemas Comuns

**"OAuth token has expired" ou "Invalid authentication credentials"**
→ Esse erro e do Claude Code, NAO da chave Gemini/OpenAI.
→ Rode `/login` dentro do Claude Code para reautenticar.
→ Se continuar, feche o Claude Code e abra de novo com `claude` no terminal.

**"command not found: ffmpeg"**
→ Rode `brew install ffmpeg`

**"No module named faster_whisper"**
→ Rode `pip3 install faster-whisper`

**"API key not found"**
→ Verifique se o arquivo `~/depo-cutter/.env` existe e tem sua chave Gemini ou OpenAI

**Video fica sem audio ou dessincronizado**
→ A skill ja corrige isso automaticamente. Se persistir, rode `/editordevideos full` do zero.

**Player mostra video antigo**
→ Feche o player, o Claude sempre copia o video final pro Desktop com nome novo.

---

## Importante

- Cada pessoa usa SUA PROPRIA conta Claude + SUA PROPRIA chave de API
- Nao compartilhe chaves de API com ninguem
- Os videos ficam apenas na SUA maquina — nada e enviado pra nuvem (exceto o audio pro Whisper/Gemini transcrever)
- A pasta `~/depo-cutter/input/` e onde voce coloca os videos brutos
- Os resultados ficam em `~/Desktop/Videos Editados/`
