fralapo/filmcraft-expert

Especialista em FilmCraft

Conhecimento operacional para editar vídeo no FilmCraft (o editor classe Premiere Pro da ArtCraft) a partir do Claude Code ou de qualquer agente compatível com SKILL.md que tenha o servidor MCP do FilmCraft conectado (SoundCraft e EffectCraft são destinos opcionais para delegação). Resumos por lição estão em references/. Cada mapeamento abaixo foi verificado em relação a command_list (716 comandos) e effects.list (304 efeitos) em 2026-11-03.

Fontes. O fluxo de trabalho é informado por Adobe Premiere Classroom in a Book 2026 Release (Adobe Press) e verificado em relação ao catálogo de comandos ao vivo do FilmCraft em 2026-11-03. Este skill é escrito de forma independente e não reproduz texto do livro.

Para o que cortar e por que (ganchos, ritmo, retenção, estrutura), combine este skill com o skill video-editor; para transcodificação por linha de comando, análise ou conversão em lote fora do FilmCraft, veja ffmpeg.

Legenda de verificação. "(verificado)" / "Verificado:" = o comando foi realmente executado em uma sessão ao vivo do FilmCraft e o comportamento descrito foi observado. Mapeamentos sem marcação = o comando/ID do efeito existe no catálogo ao vivo em 2026-11-03 com parâmetros correspondentes, mas não foi testado de ponta a ponta. "Indisponível" = pesquisado no catálogo naquela data sem correspondência (um instantâneo, veja §0).

0. O aplicativo muda todos os dias — verifique novamente antes de dizer "faltando"

Os aplicativos ArtCraft recebem atualizações quase diariamente. Cada item "ausente" ou "faltando" neste skill e em references/ é um instantâneo de 2026-11-03, não um limite permanente.

• Antes de informar ao usuário que um recurso está faltando, ou recorrer a uma solução alternativa, pesquise no catálogo ao vivo com um filtro (command_list / list_effects / effects.list). Se o comando existir agora, use-o.
• O método Adobe descrito aqui é o alvo. Aplique-o integralmente assim que o aplicativo o suportar.
• Se você encontrar um comando que este skill lista como ausente, ou um mapeamento que mudou, atualize este skill (ou abra uma issue no repositório) para que o instantâneo permaneça preciso.

Regras básicas para o agente

• Tempo: 254016000000 ticks = 1 s. A maioria dos comandos também aceita seconds, frame ou timecode; as durações das transições estão em frames.
• Tempo do keyframe: effects.setParam {time, keyframe:true} usa o tempo da linha do tempo. effects.setInterpolation, setKeyframe, moveKeyframe e deleteKeyframe usam mediaTime = tempo da fonte = sourceIn + (t_timeline − start) (verificado).
• Ids: clipes da linha do tempo e itens do projeto têm ids diferentes. timeline.place retorna pares [video, audio] vinculados. sequence_inspect é muito verboso (~15k tokens com 3 clipes); para perguntas específicas use state.inspect, graphics.list, essentialSound.inspect, mixer.inspect, captions.list.
• Lotes: command_batch {stop_on_error:false} executa tudo e relata ok/erro por etapa; cada etapa tem seu próprio desfazer (edit.undo).
• Exportação: sempre passe um path explícito (sem um, o arquivo vai para a pasta pessoal do usuário como <nome da sequência>.mp4), wait:true para obter o resultado; verifique primeiro com export.resolve.
• Arquivos do usuário: nunca abra ou salve projetos do usuário a menos que seja solicitado. Para experimentos use file.newProject + file.importDemoFootage (OceanSunset, Aurora, CityNight, Dunes, Plasma, Forest).
• Verificação visual: render_frame {seconds, max_side:480} em vários pontos; para cor, scopes.read (números, não imagens).

Conceitos-chave (resumido)

• Projeto: contém bins, clipes, sequências e configurações, mas apenas referências aos arquivos de mídia. Excluir/renomear um clipe nunca toca o original.
• Bins: pastas do projeto (file.newBin, project.moveToBin); bins de pesquisa (file.newSearchBin) são coleções dinâmicas de metadados.
• Sequência: a linha do tempo. Suas configurações (tamanho do quadro, fps, áudio) definem o formato de trabalho; corresponda à filmagem principal ou à entrega quando as fontes forem mistas.
• Faixas: faixas V mais altas cobrem as mais baixas; faixas A se somam. Segmentação (timeline.setTargeting) decide onde inserir/sobrepor; correspondência de origem decide quais canais de origem entram. Bloqueio de sincronia e bloqueio: timeline.setTrack.
• In/Out: na fonte, eles escolhem o que usar; na linha do tempo, marcam um intervalo para remover, renderizar ou exportar.
• Inserir vs sobrepor: inserir empurra tudo para frente (a sequência fica mais longa); sobrepor substitui o que está por baixo.
• Edições de 3/4 pontos: dê três pontos e o quarto é calculado; quatro pontos que discordam forçam uma escolha entre cortar e alterar a velocidade.
• Levantar vs extrair: levantar deixa uma lacuna, extrair a fecha. O mesmo para excluir vs exclusão em ripple.
• Trims: regular move uma borda e deixa uma lacuna; ripple move uma borda e arrasta o resto junto; roll move o corte entre dois clipes sem alterar o comprimento total; slip altera qual parte da fonte é exibida em uma posição fixa; slide move o clipe e encurta/alonga seus vizinhos.
• Handles: mídia extra além de In/Out; sem eles, as transições repetem quadros.
• Marcadores: marcadores de sequência ou clipe com nome, comentário, cor e duração; marcadores de capítulo e flash-cue também.
• Aninhamento: clip.nest transforma vários clipes em uma sub-sequência que se comporta como um clipe (efeitos de grupo, reenquadramento, exportações parciais).
• Efeitos fixos: Movimento, Opacidade, Remapeamento de Tempo, Volume, Volume do Canal e Panela já estão em todos os clipes.

Fluxo de trabalho recomendado

1. Projeto + bins (Filmagens, Áudio, Gráficos, Sequências) → importar → verificar formatos (file.mediaProperties, media.colorInfo).
2. Sequência com configurações corretas (ou matchSequence:true no primeiro timeline.place).
3. Seleções com In/Out ou subclipes → corte bruto.
4. Corte fino: trims, ritmo, cortes J/L, transições apenas onde elas merecem seu lugar.
5. Áudio: tipos, volume, limpeza, música, ducking, mixagem.
6. Efeitos, movimento, estabilização, composição.
7. Cor: correção primeiro (equilíbrio, correspondência de tom), depois gradação (o visual).
8. Títulos, gráficos, legendas.
9. QC → exportar → arquivar (Gerenciador de Projetos).

Mapeamento Premiere → FilmCraft

Recurso Premiere	FilmCraft
Novo projeto / sequência / bin	file.newProject, file.newSequence {width,height,fps}, file.newBin
Configurações da sequência	sequence.settings, sequence.colorSettings
Importar / Navegador de Mídia	media_import (ferramenta), file.import, mediaBrowser.list/import
PSD/AI em camadas	sem diálogo de camadas: exportar camadas do PhotoCraft/VectorCraft como PNG
Gravação de narração	audio.voiceover.start/stop (precisa do aplicativo com uma entrada de áudio)
Narração sintética	tts.create (não está no Premiere)
Metadados e colunas	metadata.set, project.columns.set, edit.find
Subclipes	clip.makeSubclip
Canais de áudio / interpretar filmagem	clip.audioChannels, clip.interpretFootage
Mesclar clipes (áudio de sistema duplo) / sincronizar	clip.mergeClips, clip.synchronize {method:"audio"}
Monitor de origem, In/Out	source.open, markers.markIn/markOut {target:"source"}, project.setMarks
Inserir / sobrepor	source.insert, source.overwrite, timeline.place {insert}
Storyboard → sequência	clip.automateToSequence
Navalha / Adicionar Edição	timeline.razor, sequence.addEdit(AllTracks)
Levantar / extrair / exclusão em ripple	sequence.lift, sequence.extract, edit.rippleDelete, timeline.delete {ripple}
Fechar lacunas	sequence.closeGap, timeline.selectGap
Trim, ripple, roll, slip, slide	timeline.trim {mode}, timeline.roll, timeline.slip, timeline.slide
Trims de teclado Q/W, E	trim.ripplePrevious/rippleNext, trim.extendToPlayhead
Corte dinâmico	trim.shuttle, trim.playAround
Esticar taxa / velocidade / reverso	timeline.rateStretch, clip.speedDuration {speed,reverse,ripple}
Congelar quadro / fluxo óptico	clip.frameHold, clip.setTimeInterpolation
Substituir clipe / filmagem	clip.replaceFromBin, media.replaceFootage
Marcadores	markers.add/addRange/addChapter/edit/exportCsv
Vincular, agrupar, ativar	clip.link, clip.group, clip.enable
Aninhar	clip.nest, sequence.makeSubsequence
Transições de vídeo/áudio	sequence.applyVideoTransition, sequence.applyAudioTransition, trim.applyDefaultTransition
Corte de Transição	efeito de transição morph_cut
Edição Baseada em Texto	transcript.generate → transcript.extract/lift, removePauses, removeFillers
Efeitos / parâmetros / keyframes	effects.apply, effects.setParam, effects.addKeyframe, effects.setInterpolation
Presets de efeitos / camada de ajuste	presets.save/apply, file.newAdjustmentLayer
Colar/remover atributos	edit.pasteAttributes, edit.removeAttributes
Máscaras e rastreamento	masks.add, masks.set, masks.track
Estabilizador Warp / Reenquadramento Automático	efeitos warp_stabilizer, auto_reframe; clip.fillFrame/fitToFrame
Detecção de Edição de Cena	clip.sceneEditDetection
Lumetri (painel, presets, LUTs, correspondência)	efeito lumetri + effects.setParam, lumetri.applyPreset, lumetri.setInputLut/setLook, lumetri.applyMatch, lut.import
Escopos Lumetri	scopes.read (forma de onda, parade, histograma, vectorscope como números)
Limitador de Vídeo	efeito video_limiter ou o limitador nas configurações de exportação
Opacidade, modos de mesclagem	effects.setParam {effect:"opacity", param:"blend", value:"Screen"}
Ultra Key / Track Matte / Luma Key	efeitos ultra_key, track_matte, luma_key, color_key
Texto/formas de Gráficos Essenciais	graphics.newText, graphics.newShape/newRectangle, graphics.set, graphics.setCharStyle, graphics.align
Rolo/deslocamento de título	graphics.setRoll
Modelos de Gráficos em Movimento	graphics.template.list/apply/export (.fcgt; .mogrt é recusado)
Legendas	captions.newTrack/add/setStyle/import/export, transcript.createCaptions, graphics.upgradeCaption
Ganho de áudio / normalizar	`clip.audioGain {mode:"set
Volume do clipe e keyframes	clipMixer.set, effects.setParam {effect:"volume", param:"level"}
Mixer de faixa, submix, envios, automação	mixer.setStrip/addSubmix/addSend/addInsert/writeAutomation
Som Essencial (tipos, reparo, clareza, ducking, correspondência automática)	essentialSound.setType/set/applyPreset/autoMatch/generateDucking
Remix (reajustar duração da música)	clip.remix {seconds}
Efeitos de áudio (EQ, notch, DeNoise, DeHum, Enhance Speech…)	effects.apply (veja references/11-improving-audio.md)
Multicâmera	clip.createMulticam, multicam.cut, clip.multicamFlatten
Proxies / ingestão	media.createProxies, media.toggleProxies, project.ingestSettings
Exportação Rápida / exportar mídia / Media Encoder	export.quick, file.exportMedia, export.queue.add/start
Exportar um quadro	file.exportFrame
EDL/XML/AAF/OMF/OTIO	file.exportInterchange, file.exportAaf, file.exportOmf
Gerenciador de Projetos / Remover não utilizados / Vincular Mídia	file.projectManager {mode, handles, dryRun}, edit.removeUnused, media.findMissing/relink/autoRelink
Limpeza de cache	mediaCache.clean, sequence.deleteRenderFiles

Indisponível em 2026-11-03 — instantâneo, verifique novamente (§0) (pesquisado em command_list/effects.list, sem correspondência): Extensão Generativa (IA), ferramenta de Máscara de Objeto (IA), pesquisa de Inteligência de Mídia / "pesquisar quadros semelhantes", Adobe Stock (vídeo e áudio), botão Automático de Correção Básica Lumetri (apenas applyMatch existe), Renderizar e Substituir, Dynamic Link para After Effects/Audition, Projetos em Equipe/Produções/Frame.io, upload direto para plataformas sociais, importação de PSD/AI em camadas. Espaços de trabalho e visualização de comparação são apenas de interface (use as ferramentas ui_* no modo bridge). Soluções alternativas: estender manualmente com congelamento de quadro/slip, máscaras manuais + masks.track, EffectCraft para motion, SoundCraft para áudio.

Receitas

Corte bruto → fino

1. Importe, organize em bins, nomeie os clipes; com muita filmagem use subclipes.
2. Crie a sequência, depois timeline.place {items:[...]} em ordem (ou clip.automateToSequence); use sourceIn/duration para escolher intervalos.
3. Remova a gordura: timeline.razor + edit.rippleDelete, ou In/Out + sequence.extract.
4. Ritmo: timeline.roll nos cortes, timeline.slip para escolher o momento certo.
5. Cabeça falante longa: transcript.generate (precisa do modelo Whisper, não instalado: transcript.downloadModel, ~290 MB, pergunte primeiro) → removeFillers, removePauses.

Reel 9:16 a partir de filmagem 16:9

1. file.newSequence {width:1080, height:1920, fps:<fps da filmagem>}.
2. timeline.place os clipes → clip.fillFrame (preenche o quadro; 177,8% de 1080p) e, se necessário, o efeito auto_reframe ou keyframes manuais de motion.position. Alternativa: aninhe a sequência 16:9 e reenquadre o aninhamento.
3. Mantenha o texto dentro da zona segura: deixe aproximadamente os 15% superiores e 25% inferiores livres para a interface da plataforma.
4. Legendas grandes e gráficos em negrito são a norma; mantenha o gancho curto (primeiros 1-2 s).
5. Exporte com preset "Social Vertical 1080×1920" + loudnessLufs:-14.

Transições: um corte direto é o padrão; dissolves (cross_dissolve, dip_to_black) sinalizam uma mudança de tempo ou lugar. effects.setDefaultTransition → trim.applyDefaultTransition nos clipes selecionados. Áudio: constant_power de 6–12 quadros em cortes que saltam. Verifique os handles primeiro.

Movimento e keyframes: effects.setParam {effect:"motion", param:"scale|position|rotation", value, time, keyframe:true} em dois momentos → effects.setInterpolation {mediaTime, interpolation:"easeIn|easeOut|bezier"}. Para uma sombra que gira com o objeto, use transform ou basic_3d com drop_shadow abaixo dele, não Motion (Motion é aplicado por último).

Áudio: essentialSound.setType (diálogo/música/efeitos sonoros/ambiência) → autoMatch (padrões: diálogo −23, música −25, efeitos sonoros −21, ambiência −30 LUFS) → voz set {key:"repair.noise.on"} etc. → música type:"music" + generateDucking → master via exportação loudnessLufs (social −14, broadcast −23). Picos em torno de −6/−3 dBFS. Delegar para SoundCraft para edição de forma de onda/espectral, restauração séria…