Communitygithub.com

alyssasworld/edit-twin-mcp

Faça um corte bruto do projeto aberto no Final Cut Pro com o Edit Twin MCP — retakes, hum/ah, pausas, seu visual e som salvos — adaptando para reels/shorts ou vlogs paisagem.

O que é edit-twin-mcp?

O Edit Twin MCP (alyssasworld/edit-twin-mcp) é um skill para agentes de IA como Claude Code que permite fazer um corte bruto automático de projetos do Final Cut Pro, sem modificar o original: o resultado é importado como um novo projeto ao lado. Ele analisa a transcrição para encontrar retakes (comparando takes e mantendo o melhor), pausas (com configurações diferentes para reels e vlogs) e preenchedores como 'hum' e 'ah', depois corta tudo de uma vez. Também aplica o estilo de áudio e vídeo salvos do usuário (look, cadeia de áudio) e normaliza o loudness. A habilidade suporta macOS (via MCP) e é especialmente útil para criadores de conteúdo que editam vídeos verticais curtos (reels/shorts) ou vlogs horizontais mais longos, pois adapta automaticamente os parâmetros de corte com base no formato do projeto. O fluxo começa com a obtenção dos estilos e timeline do usuário, análise e apresentação de um plano antes do corte, e finaliza com validação, preview e envio para o Final Cut.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alyssasworld/edit-twin-mcp/tree/HEAD/skills/edit-twin-rough-cut

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Corte bruto com Edit Twin

Use as ferramentas MCP edit-twin. O projeto original do usuário nunca é modificado: o resultado é importado como um NOVO projeto ao lado dele. Os tempos estão em segundos na timeline atual. Referências de clipe como "4" (clipe da linha do tempo) e "4.0" (item conectado) mudam a cada edição, portanto releia get_timeline antes de usar as referências.

1. Obter o projeto e o estilo do usuário

  1. get_style: padrões salvos (configurações de pausa, cadeia de áudio, visual padrão, anotações aprendidas com suas edições). Siga as anotações.
  2. fcp_export_project. Se avisar que o projeto está vazio, peça ao usuário para selecionar o projeto correto no Navegador do Final Cut (ou clicar na sua timeline) e tentar novamente. Se a exportação falhar, peça para usarem Arquivo > Exportar XML… e fornecerem o caminho, ou usar find_fcpxml_files + open_timeline.
  3. get_timeline, depois decida o formato a partir de summary.format (largura/altura) e duração, a menos que o usuário tenha dito qual:
    • Reel / short: vertical (altura > largura), ou com menos de ~3 minutos.
    • Vlog / paisagem: horizontal, ou peças mais longas com B-roll, paisagens, música ou momentos ambientes. Informe ao usuário qual formato você escolheu em uma linha.

2. Analisar (não alterar nada ainda)

  1. transcribe, com vocabulary definido para nomes e jargões prováveis no vídeo.
  2. find_repeats: gaguejos, retakes e preenchedores hum/ah. Para cada retake, compare as takes e escolha. Mantenha a que tiver entrega mais clara, sem tropeços e com final limpo; se forem iguais, mantenha a take posterior. Ao remover um retake, também remova um conector excedente ("e", "então") no início da take mantida se não soar mais natural.
  3. Pausas, dependendo do formato:
    • Reel: find_silences com os padrões salvos.
    • Vlog: find_silences com substituições mais soltas (min_silence 0.6, keep_after_speech 0.15, keep_before_speech 0.15), e proponha apenas pausas dentro de seções de fala (entre palavras da transcrição). Nunca corte trechos silenciosos que sejam B-roll, paisagens, música ou reações; use get_timeline e preview_frame quando não tiver certeza.
  4. Pare e mostre um plano resumido: retakes (cite ambas as takes, diga qual manteria e porquê), quantos preenchedores, quantas pausas e quantos segundos eles somam, e a nova duração esperada. Aguarde o OK do usuário ou alterações.

3. Cortar (após aprovação)

  1. cut_ranges para os retakes e preenchedores aprovados.
  2. Reels: remove_silences com os padrões salvos. Vlogs: cut_ranges com apenas os intervalos de pausa aprovados.
  3. Reels: verifique se os primeiros ~3 segundos funcionam como gancho, ou seja, as primeiras palavras enunciam o tópico ou uma afirmação surpreendente. Se uma linha de gancho mais forte aparecer depois, sugira-a, mas não a mova sem perguntar. Sinalize se o reel passar de 90 segundos.

4. Visual e som

  1. Se houver um clipe de ajuste com efeitos, execute fit_to_timeline. Caso contrário, se o estilo tiver um visual padrão, execute apply_look.
  2. Se o estilo tiver uma cadeia de áudio, execute apply_audio_style. Se não, execute measure_loudness e sugira um ganho (vídeo social geralmente fica em torno de -14 LUFS), ou ofereça normalize_audio.
  3. Deixe música e áudio conectados em paz, a menos que seja solicitado.

5. Verificar e enviar

  1. validate_timeline, depois render_preview. Diga ao usuário onde está o preview e a nova duração.
  2. send_to_final_cut com o nome do projeto " (corte bruto)".
  3. Resuma em algumas linhas: o que foi cortado (retakes, preenchedores, pausas, segundos economizados) e o visual e som aplicados.
  4. Termine sugerindo que, se polirem a edição manualmente, peçam ao Claude para learn_from_edit (com save=true e look_name) para que o próximo corte bruto corresponda ao estilo deles. Para o primeiro vlog depois de reels, execute com save=false e registre as configurações de pausa sugeridas para vlog com update_style add_note, para que os padrões de reel não sejam sobrescritos.

Regras

  • Nunca altere nada antes da aprovação do plano no passo 2.4.
  • Nunca edite o projeto original; envie sempre um novo.
  • A mídia em um drive externo deve estar conectada.
  • Se uma ferramenta falhar devido a permissões do macOS, oriente o usuário a Ajustes do Sistema > Privacidade e Segurança (Acessibilidade e Automação para o aplicativo que executa o Claude Code).

Habilidades Relacionadas