lalimi/claude-reelsmith

Finaliza um reel construído no CapCut — envia a imagem (tudo embutido), as faixas de voz e música, coloca efeitos sonoros da biblioteca do CapCut em cada efeito e transição, e gera um rascunho editável no CapCut Web para o criador trocar músicas e sons de ouvido antes de exportar. Usa o conector MCP do CapCut incluído neste plugin. Use quando solicitado: "efeitos sonoros do CapCut", "colocar no CapCut", "rascunho editável", "trocar a música no CapCut", "капкат".

O que é claude-reelsmith?

Esta skill finaliza o processo de um reel construído com o ReelSmith, enviando-o para o CapCut Web como um rascunho editável. Ela faz o upload dos arquivos de vídeo, voz e música para o CapCut, insere automaticamente efeitos sonoros da biblioteca do CapCut em eventos e transições, e cria um rascunho que o criador pode abrir no editor web para ajustar músicas, sons e volumes de forma intuitiva — tudo sem precisar exportar previamente. A skill é útil porque evita o trabalho manual de recriar o reel no CapCut, permite a troca rápida de faixas e efeitos, e mantém a capacidade de edição final. Ela depende do servidor MCP do CapCut (incluído no plugin) e de um plugin local para upload e geração do rascunho. O fluxo inclui: adicionar definições de efeitos sonoros ao `reel.json`, executar `reelsmith capcut stems` para extrair as faixas, fazer upload com o script `capcut-upload.mjs`, gerar o rascunho com `reelsmith capcut draft` e enviá-lo via sessão padrão. A skill orienta o criador a verificar os sons (alguns podem ficar mudos), substituir a música placebo por faixas da biblioteca e exportar em 1080p/30fps, tomando cuidado com o espaço na nuvem do CapCut.

Funciona com✓Claude Code✓Codex CLI~Cursor

npx skills add https://github.com/lalimi/claude-reelsmith/tree/HEAD/skills/reel-capcut

Documentação

Reel → Rascunho CapCut

Necessário: um reel já construído (reelsmith build <dir>), o servidor MCP do CapCut (capcut, incluído no .mcp.json deste plugin; faça login uma vez via /mcp) e o pacote de plugins do CapCut em disco para o uploader e construtor de rascunho (veja $(reelsmith root)/docs/capcut.md, env CAPCUT_PLUGIN_DIR, padrão ~/capcut-plugin).

Etapas

Adicione "sfx" ao reel.json — uma entrada por evento na tela:
```
"sfx": [{"name": "whoosh", "t": 6.9, "vol": 0.5}, {"name": "click", "t": 30.62, "vol": 0.5},
        {"name": "typing", "t": 2.5, "vol": 0.35, "dur": 1.4}, {"name": "my_sounds/rip.mp3", "t": 15.36}]
```
Nomes da biblioteca: whoosh, whoosh-short, pop, typing, click, sparkle, coin, chime, impact, shutter, ding (ids em engine/capcut.py). Qualquer outro nome = um arquivo de áudio local de sua propriedade, enviado junto com as faixas.
reelsmith capcut stems <dir> → out/capcut/{video.mp4, voice.wav, music.wav} + files.json. Voz e música compartilham um ganho (soma = −14 LUFS) e um limitador; a música já é ducked sob a voz.
Upload: chame capcut_asset_upload_credential com version: 2 e o file_name + size_bytes exatos de cada arquivo (reverifique os tamanhos imediatamente antes; uma discrepância falha com upload_files_mismatch). Em seguida:

printf '%s' <ticket> | node "${CAPCUT_PLUGIN_DIR:-$HOME/capcut-plugin}"/x/plugins/codex/skills/capcut-upload/scripts/capcut-upload.mjs --files "$(cat out/capcut/files.json)" --upload-ticket-stdin --json > out/capcut/upload.json
reelsmith capcut draft <dir> → out/capcut/draft.json (validado).
start_stdraft_session → push_stdraft_snapshot com base_package_id: "" e o JSON do rascunho. Forneça ao criador a web_editor_url.
Antes de enviar novamente, use get_stdraft_snapshot e construa sobre ele — o criador pode ter editado o rascunho (a leitura de volta é imperfeita; nunca sobrescreva cegamente as alterações dele). Para pequenos ajustes (cortar o final da música, volume) prefira fazê-los no editor através do Claude no Chrome.

O que dizer ao criador

Ouça primeiro: foi relatado que sons da biblioteca do CapCut aparecem na linha do tempo mas ficam mudos. Se isso acontecer, substitua-os em Áudio → Efeitos sonoros, ou use arquivos locais.
Música: silencie a faixa placebo e escolha uma faixa da biblioteca de ouvido; corte-a no comprimento do vídeo (uma faixa mais longa adiciona uma cauda preta à exportação).
Exportar: (canto superior direito → Download, 1080p / 30 fps / MP4) salva primeiro na nuvem do CapCut: se o espaço na nuvem estiver cheio, a exportação falha com "Não foi possível salvar" — libere espaço no espaço do CapCut ou mantenha o MP4 do motor.
A busca de som do próprio conector (search_capcut_material) é uma busca pobre por título sem prévias; a biblioteca completa de sons está apenas no aplicativo CapCut.