fralapo/filmcraft-expert

Experto en FilmCraft

Conocimiento operativo para editar video en FilmCraft (el editor de clase Premiere Pro de ArtCraft) desde Claude Code o cualquier agente compatible con SKILL.md que tenga conectado el servidor MCP de FilmCraft (SoundCraft y EffectCraft son destinos de transferencia opcionales). Los resúmenes por lección se encuentran en references/. Cada mapeo a continuación fue verificado contra command_list (716 comandos) y effects.list (304 efectos) el 2026-11-03.

Fuentes. El flujo de trabajo se basa en el libro Premiere Classroom in a Book 2026 Release de Adobe (Adobe Press) y se ha verificado contra el catálogo de comandos en vivo de FilmCraft el 2026-11-03. Este skill está escrito de forma independiente y no reproduce ningún texto del libro.

Para qué cortar y por qué (ganchos, ritmo, retención, estructura), combine esto con el skill video-editor; para transcodificación, sondeo o conversión por lotes desde la línea de comandos fuera de FilmCraft, consulte ffmpeg.

Leyenda de verificación. "(verificado)" / "Verificado:" = el comando se ejecutó realmente en una sesión en vivo de FilmCraft y se observó el comportamiento descrito. Los mapeos sin marcar = el identificador del comando/efecto existe en el catálogo en vivo del 2026-11-03 con parámetros coincidentes, pero no se probó de principio a fin. "No disponible" = se buscó en el catálogo en esa fecha sin coincidencia (una instantánea, véase §0).

0. La aplicación cambia cada día — vuelva a verificar antes de decir "falta"

Las aplicaciones de ArtCraft reciben actualizaciones casi a diario. Cada elemento "ausente" o "faltante" en este skill y en references/ es una instantánea al 2026-11-03, no un límite permanente.

• Antes de decirle al usuario que una función falta, o recurrir a una solución alternativa, busque en el catálogo en vivo con un filtro (command_list / list_effects / effects.list). Si el comando existe ahora, úselo.
• El método de Adobe descrito aquí es el objetivo. Aplíquelo completamente tan pronto como la aplicación lo admita.
• Si encuentra un comando que este skill lista como ausente, o un mapeo que ha cambiado, actualice este skill (o abra un issue en el repositorio) para que la instantánea se mantenga precisa.

Reglas básicas para el agente

• Tiempo: 254016000000 ticks = 1 s. La mayoría de los comandos también aceptan seconds, frame o timecode; las duraciones de transición están en frames.
• Tiempo de fotograma clave: effects.setParam {time, keyframe:true} toma el tiempo de la línea de tiempo. effects.setInterpolation, setKeyframe, moveKeyframe y deleteKeyframe toman mediaTime = tiempo de origen = sourceIn + (t_timeline − start) (verificado).
• Ids: los clips de la línea de tiempo y los elementos del proyecto tienen ids diferentes. timeline.place devuelve pares [video, audio] vinculados. sequence_inspect es muy verboso (~15k tokens con 3 clips); para preguntas específicas use state.inspect, graphics.list, essentialSound.inspect, mixer.inspect, captions.list.
• Lotes: command_batch {stop_on_error:false} ejecuta todo y reporta ok/error por paso; cada paso es su propio deshacer (edit.undo).
• Exportación: siempre pase un path explícito (sin uno, el archivo termina en la carpeta de inicio del usuario como <nombre de secuencia>.mp4), wait:true para obtener el resultado; verifique primero con export.resolve.
• Archivos de usuario: nunca abra ni guarde proyectos de usuario a menos que se le solicite. Para experimentos use file.newProject + file.importDemoFootage (OceanSunset, Aurora, CityNight, Dunes, Plasma, Forest).
• Verificación visual: render_frame {seconds, max_side:480} en varios puntos; para color, scopes.read (números, no imágenes).

Conceptos clave (breve)

• Proyecto: contiene contenedores, clips, secuencias y configuraciones, pero solo referencias a los archivos multimedia. Eliminar/renombrar un clip nunca toca el original.
• Contenedores: carpetas del proyecto (file.newBin, project.moveToBin); los contenedores de búsqueda (file.newSearchBin) son colecciones de metadatos dinámicas.
• Secuencia: la línea de tiempo. Sus ajustes (tamaño de fotograma, fps, audio) establecen el formato de trabajo; coincida con el metraje principal, o con la entrega cuando las fuentes sean mixtas.
• Pistas: las pistas V superiores cubren las inferiores; las pistas A se suman. Destino (timeline.setTargeting) decide dónde aterrizan las inserciones/sobregrabaciones; parcheo de origen decide qué canales de origen entran. Bloqueo de sincronía y bloqueo: timeline.setTrack.
• Entrada/Salida: en el origen eligen qué usar; en la línea de tiempo marcan un rango para eliminar, renderizar o exportar.
• Inserción vs sobregrabación: la inserción empuja todo hacia adelante (la secuencia se alarga); la sobregrabación reemplaza lo que está debajo.
• Ediciones de 3/4 puntos: proporcione tres puntos y el cuarto se calcula; cuatro puntos que no coinciden obligan a elegir entre recortar y cambiar la velocidad.
• Elevar vs extraer: elevar deja un espacio, extraer lo cierra. Lo mismo para eliminar vs eliminar con ondulación.
• Recortes: normal mueve un borde y deja un espacio; ripple mueve un borde y arrastra el resto; roll mueve el corte entre dos clips sin cambiar la longitud total; slip cambia qué parte del origen se muestra en una posición fija; slide mueve el clip y acorta/alarga sus vecinos.
• Mangos: metraje adicional más allá de Entrada/Salida; sin ellos, las transiciones repiten fotogramas.
• Marcadores: marcadores de secuencia o clip con nombre, comentario, color y duración; también marcadores de capítulo y flash-cue.
• Anidación: clip.nest convierte varios clips en una subsecuencia que se comporta como un solo clip (efectos de grupo, reencuadre, exportaciones parciales).
• Efectos fijos: Movimiento, Opacidad, Reasignación de tiempo, Volumen, Volumen de canal y Paneo están en cada clip desde el principio.

Flujo de trabajo recomendado

1. Proyecto + contenedores (Metraje, Audio, Gráficos, Secuencias) → importar → verificar formatos (file.mediaProperties, media.colorInfo).
2. Secuencia con ajustes correctos (o matchSequence:true en el primer timeline.place).
3. Selecciones con Entrada/Salida o subclips → corte bruto.
4. Corte fino: recortes, ritmo, cortes J/L, transiciones solo donde sumen.
5. Audio: tipos, sonoridad, limpieza, música, ducking, mezcla.
6. Efectos, movimiento, estabilización, composición.
7. Color: corrección primero (balance, emparejamiento de tomas), luego etalonaje (el aspecto).
8. Títulos, gráficos, subtítulos.
9. Control de calidad → exportar → archivar (Administrador de proyectos).

Mapeo Premiere → FilmCraft

Función de Premiere	FilmCraft
Nuevo proyecto / secuencia / contenedor	file.newProject, file.newSequence {width,height,fps}, file.newBin
Configuración de secuencia	sequence.settings, sequence.colorSettings
Importar / Explorador de medios	media_import (herramienta), file.import, mediaBrowser.list/import
PSD/AI con capas	sin diálogo de capas: exportar capas desde PhotoCraft/VectorCraft como PNG
Grabación de voz en off	audio.voiceover.start/stop (necesita la aplicación con una entrada de audio)
Narración sintética	tts.create (no está en Premiere)
Metadatos y columnas	metadata.set, project.columns.set, edit.find
Subclips	clip.makeSubclip
Canales de audio / interpretar metraje	clip.audioChannels, clip.interpretFootage
Fusionar clips (audio de sistema dual) / sincronizar	clip.mergeClips, clip.synchronize {method:"audio"}
Monitor de origen, Entrada/Salida	source.open, markers.markIn/markOut {target:"source"}, project.setMarks
Insertar / sobregrabar	source.insert, source.overwrite, timeline.place {insert}
Guión gráfico → secuencia	clip.automateToSequence
Cuchilla / Agregar edición	timeline.razor, sequence.addEdit(AllTracks)
Elevar / extraer / eliminar con ondulación	sequence.lift, sequence.extract, edit.rippleDelete, timeline.delete {ripple}
Cerrar espacios	sequence.closeGap, timeline.selectGap
Recortar, ripple, roll, slip, slide	timeline.trim {mode}, timeline.roll, timeline.slip, timeline.slide
Recortes de teclado Q/W, E	trim.ripplePrevious/rippleNext, trim.extendToPlayhead
Recorte dinámico	trim.shuttle, trim.playAround
Estiramiento de velocidad / velocidad / inversión	timeline.rateStretch, clip.speedDuration {speed,reverse,ripple}
Congelación de fotograma / flujo óptico	clip.frameHold, clip.setTimeInterpolation
Reemplazar clip / metraje	clip.replaceFromBin, media.replaceFootage
Marcadores	markers.add/addRange/addChapter/edit/exportCsv
Vincular, agrupar, habilitar	clip.link, clip.group, clip.enable
Anidar	clip.nest, sequence.makeSubsequence
Transiciones de video/audio	sequence.applyVideoTransition, sequence.applyAudioTransition, trim.applyDefaultTransition
Transición Morph Cut	efecto morph_cut
Edición basada en texto	transcript.generate → transcript.extract/lift, removePauses, removeFillers
Efectos / parámetros / fotogramas clave	effects.apply, effects.setParam, effects.addKeyframe, effects.setInterpolation
Ajustes preestablecidos de efectos / capa de ajuste	presets.save/apply, file.newAdjustmentLayer
Pegar/eliminar atributos	edit.pasteAttributes, edit.removeAttributes
Máscaras y seguimiento	masks.add, masks.set, masks.track
Estabilizador Warp / Reencuadre automático	efectos warp_stabilizer, auto_reframe; clip.fillFrame/fitToFrame
Detección de edición de escena	clip.sceneEditDetection
Lumetri (panel, ajustes preestablecidos, LUTs, coincidencia)	efecto lumetri + effects.setParam, lumetri.applyPreset, lumetri.setInputLut/setLook, lumetri.applyMatch, lut.import
Scopes Lumetri	scopes.read (forma de onda, parade, histograma, vectorscopio como números)
Limitador de video	efecto video_limiter o el limitador en la configuración de exportación
Opacidad, modos de fusión	effects.setParam {effect:"opacity", param:"blend", value:"Screen"}
Ultra Key / Máscara de pista / Máscara Luma	efectos ultra_key, track_matte, luma_key, color_key
Gráficos esenciales texto/formas	graphics.newText, graphics.newShape/newRectangle, graphics.set, graphics.setCharStyle, graphics.align
Título en desplazamiento/arrastre	graphics.setRoll
Plantillas de gráficos en movimiento	graphics.template.list/apply/export (.fcgt; .mogrt es rechazado)
Subtítulos	captions.newTrack/add/setStyle/import/export, transcript.createCaptions, graphics.upgradeCaption
Ganancia de audio / normalizar	`clip.audioGain {mode:"set
Volumen de clip y fotogramas clave	clipMixer.set, effects.setParam {effect:"volume", param:"level"}
Mezclador de pistas, submezcla, envíos, automatización	mixer.setStrip/addSubmix/addSend/addInsert/writeAutomation
Sonido esencial (tipos, reparación, claridad, ducking, coincidencia automática)	essentialSound.setType/set/applyPreset/autoMatch/generateDucking
Remix (reajustar duración de la música)	clip.remix {seconds}
Efectos de audio (EQ, muesca, DeNoise, DeHum, Mejorar voz…)	effects.apply (consulte references/11-improving-audio.md)
Multicámara	clip.createMulticam, multicam.cut, clip.multicamFlatten
Proxies / ingesta	media.createProxies, media.toggleProxies, project.ingestSettings
Exportación rápida / exportar medios / Media Encoder	export.quick, file.exportMedia, export.queue.add/start
Exportar un fotograma	file.exportFrame
EDL/XML/AAF/OMF/OTIO	file.exportInterchange, file.exportAaf, file.exportOmf
Administrador de proyectos / Eliminar no usados / Vincular medios	file.projectManager {mode, handles, dryRun}, edit.removeUnused, media.findMissing/relink/autoRelink
Limpieza de caché	mediaCache.clean, sequence.deleteRenderFiles

No disponible al 2026-11-03 — instantánea, vuelva a verificar (§0) (buscado en command_list/effects.list, sin coincidencia): Extensión generativa (IA), Herramienta de máscara de objeto (IA), Búsqueda de inteligencia multimedia / "buscar fotogramas similares", Adobe Stock (video y audio), el botón Automático de Corrección básica de Lumetri (solo existe applyMatch), Renderizar y reemplazar, Dynamic Link a After Effects/Audition, Proyectos en equipo/Producciones/Frame.io, carga directa a plataformas sociales, importación de PSD/AI con capas. Las Áreas de trabajo y la vista de Comparación son solo de interfaz (use las herramientas ui_* en modo puente). Soluciones alternativas: extender manualmente con congelación de fotograma/slip, máscaras manuales + masks.track, EffectCraft para movimiento, SoundCraft para audio.

Recetas

Corte bruto → fino

1. Importe, organice en contenedores, nombre los clips; con mucho metraje use subclips.
2. Cree la secuencia, luego timeline.place {items:[...]} en orden (o clip.automateToSequence); use sourceIn/duration para seleccionar rangos.
3. Elimine lo superfluo: timeline.razor + edit.rippleDelete, o Entrada/Salida + sequence.extract.
4. Ritmo: timeline.roll en los cortes, timeline.slip para elegir el momento adecuado.
5. Largos planos de persona hablando: transcript.generate (necesita el modelo Whisper, si no está instalado: transcript.downloadModel, ~290 MB, pregunte primero) → removeFillers, removePauses.

Reel 9:16 desde metraje 16:9

1. file.newSequence {width:1080, height:1920, fps:<fps del metraje>}.
2. timeline.place los clips → clip.fillFrame (llena el fotograma; 177.8% desde 1080p) y, si es necesario, el efecto auto_reframe o fotogramas clave manuales de motion.position. Alternativa: anide la secuencia 16:9 y reencuadre el anidado.
3. Mantenga el texto dentro de la zona segura: deje aproximadamente el 15% superior y el 25% inferior libres para la interfaz de la plataforma.
4. Los subtítulos grandes y los gráficos llamativos son la norma; mantenga el gancho breve (primeros 1–2 s).
5. Exporte con el ajuste preestablecido "Social Vertical 1080×1920" + loudnessLufs:-14.

Transiciones: un corte directo es el predeterminado; las disolvencias (cross_dissolve, dip_to_black) señalan un cambio de tiempo o lugar. effects.setDefaultTransition → trim.applyDefaultTransition en los clips seleccionados. Audio: constant_power de 6–12 fotogramas en cortes que resalten. Verifique los mangos primero.

Movimiento y fotogramas clave: effects.setParam {effect:"motion", param:"scale|position|rotation", value, time, keyframe:true} en dos tiempos → effects.setInterpolation {mediaTime, interpolation:"easeIn|easeOut|bezier"}. Para una sombra que rota con el objeto use transform o basic_3d con drop_shadow debajo, no Motion (Motion se aplica al final).

Audio: essentialSound.setType (diálogo/música/efectos/ambiente) → autoMatch (valores predeterminados: diálogo −23, música −25, efectos −21, ambiente −30 LUFS) → voz set {key:"repair.noise.on"} etc. → música type:"music" + generateDucking → master a través de exportación loudnessLufs (social −14, difusión −23). Picos alrededor de −6/−3 dBFS. Transfiera a SoundCraft para edición de forma de onda/espectral, restauración seria de audio, mezcla envolvente o masterización de entrega. effectcraft.handoff {target:"SoundCraft", sequence, config} cierra el proyecto actual y lo abre en SoundCraft con una petición.

Color: 1. scene.light (ajuste rápido de exposición y balance de blancos) o efecto scopes.read → lumetri.setInputLut (LUT de cámara) → lumetri.applyMatch (emparejar tomas en la misma luz). 2. Empuje con effects.setParam {effect:"lumetri", param:"contrast|highlights|shadows|whites|blacks|saturation"}. 3. Aspecto: lumetri.applyPreset o lut.import {path} + lumetri.setLook (LUT creativa). 4. video_limiter en los masters. 5. Verifique con scopes.read (forma de onda asegura que los picos estén en el rango de difusión; parade para emparejar; vectorscopio para dominio de saturación).

Efectos y fotogramas clave (consulte references/ para listas completas de efectos): busque siempre primero (effects.list {search:"timecode"}) para verificar el nombre exacto y los parámetros. Aplique: effects.apply {sourceId, effect:"timecode", preset:"HH:MM:SS:FF"}. Anidación para composiciones de varias capas. Transfiera a EffectCraft para gráficos en movimiento más complejos (curvas de velocidad, seguimiento de puntos, partículas, etc.): effectcraft.handoff {target:"EffectCraft", sequence, config, parts:[...]}.

Exportación: export.resolve {sequence, container, codec, preset, bitrate} para verificar la configuración → export.quick {path, container, codec, bitrate, loudnessLufs} para una exportación rápida, o file.exportMedia {path, preset:"Social Vertical 1080×1920"} para ajustes preestablecidos. Social: H.264, 10–20 Mbps, −14 LUFS. Web: H.264, parámetros de nivel medio. Master: ProRes 422 HQ o DNxHR HQX; 24 bits, 48 kHz, sin limitador. Si la velocidad es crítica, active proxies primero (media.createProxies); si el tamaño importa, pruebe con H.265/HEVC con desbloqueo.

Archivado: edit.removeUnused → file.projectManager {mode:"collect|copy|cache", handles:24, dryRun:true} para listar los archivos que se copiarán → ejecute sin dryRun → opcionalmente añada metadatos con metadata.set {property:"comment", value:"Archived for project X"}.

Notas de implementación

• Rendimiento de secuencia_inspect: con 15+ clips esto puede devolver 30k+ tokens. Úselo solo cuando necesite el estado completo. Para consultas (¿hay un efecto en el clip 3?) use state.inspect {sourceId}.
• modelo Whisper de transcripción: ~290 MB. Pregunte primero: "¿Puedo descargar el modelo Whisper para transcripción?" antes de ejecutar transcript.downloadModel.
• Búsqueda de comandos difusos: command_list acepta comodines: command_list {filter:"trim.*"}.
• Transferencias: SoundCraft y EffectCraft no están instalados de forma predeterminada. Verifique con command_list antes de usar effectcraft.handoff. Si no están disponibles, haga lo que pueda con las herramientas de FilmCraft (effects.apply, effects.setParam, mixer.set, clips de audio de sistemas de mezcla via mixer.setStrip).

Lista de verificación de calidad (QC)

Antes de la exportación:

• La secuencia comienza y termina donde se espera (sin cola en la cabeza, sin cola en la cola).
• Sin fotogramas negros accidentales ni clips deshabilitados.
• Subtítulos visibles y sincronizados con el programa (captions.list para verificar la sincronización).
• Los gráficos/títulos están dentro de la zona segura (verifique con render_frame + anotaciones).
• Sin recortes de fotogramas clave de movimiento saltados o abruptos.
• Las transiciones de audio tienen 6–12 fotogramas de constant_power.
• Sin picos de audio: verifique con scopes.read o mixer.inspect (picos por debajo de −3 dBFS).
• Sonoridad de entrega: social −14, difusión −23 LUFS (verifique con scopes.read o en la configuración de exportación).
• La salida del limitador de video (si se usa) no aplasta los reflejos.
• El metraje proxy está desactivado (media.toggleProxies si es necesario).
• El contenedor/códec de exportación coincide con el destino.

Después de la exportación (verificación manual por parte del usuario):

• El archivo se reproduce en un reproductor estándar (VLC/IINA/QuickTime).
• Sin artefactos de compresión (bloques, bandas); si los hay, aumente la tasa de bits.
• Relación de aspecto y velocidad de fotogramas correctas.
• Sin problemas de color entre tomas (verifique en un monitor calibrado).
• Los subtítulos son legibles a tamaño completo.

Ejemplos de comando

# Crear proyecto + secuencia para reel vertical
file.newProject {name:"Summer Reel", path:"/Users/me/projects"}
file.newSequence {name:"Main Reel", width:1080, height:1920, fps:30}

# Importar metraje
media_import {path:"/Users/me/footage/beach.mp4", bin:"Footage"}

# Colocar en línea de tiempo
timeline.place {items:["beach.mp4"], track:1}

# Ajustar escala para llenar vertical
clip.fillFrame

# Agregar texto
graphics.newText {text:"Verano 2026", position:{x:540, y:300}}

# Configurar exportación
export.resolve {path:"/Users/me/exports/reel.mp4", container:"mp4", codec:"h264", bitrate:15}
export.quick {path:"/Users/me/exports/reel.mp4"}

# Recorte fino con transcripción
transcript.downloadModel  # ~290 MB, pregunte primero
transcript.generate {sourceId:"interview.mp4"}
transcript.extract {range:{start:10, end:45}}  # extraer como subclip
transcript.removeFillers {sourceId:"interview.mp4"}
transcript.removePauses {sourceId:"interview.mp4"}

Referencias

Consulte references/ para resúmenes detallados por lección:

• 00-overview.md — Descripción general de FilmCraft y configuración.
• 01-importing.md — Importación, organización, proxies, transcodificación.
• 02-editing.md — Edición básica, recortes, edición de 3/4 puntos.
• 03-transitions.md — Transiciones, duraciones, valores predeterminados.
• 04-effects.md — Efectos, parámetros, fotogramas clave, máscaras.
• 05-color.md — Lumetri, LUTs, scopes, coincidencia.
• 06-audio.md — Essential Sound, mezcla, ducking, efectos.
• 07-titles.md — Gráficos, texto, formas, plantillas.
• 08-captions.md — Subtítulos, estilos, importación/exportación.
• 09-export.md — Configuraciones, ajustes preestablecidos, masters.
• 10-multicam.md — Multicámara, sincronización, corte.
• 11-improving-audio.md — Efectos de audio detallados (DeNoise, EQ, etc.).
• 12-keyboard.md — Atajos de teclado y mapeos.

---

Skill actualizado al 2026-11-03. Verifique contra el catálogo en vivo antes de informar de funciones faltantes.