Communitygithub.com

Biznomad/agent-skills

Procesamiento de video y audio con FFmpeg. Útil para conversión de formato, redimensionado, compresión, extracción de audio y preparación de activos para Remotion. Los disparadores incluyen convertir GIF a MP4, redimensionar video, extraer audio, comprimir archivos o cualquier tarea de transformación de medios.

¿Qué es agent-skills?

Esta skill de agente (para Claude Code, Cursor, Codex, etc.) proporciona una guía completa para el procesamiento de video y audio con FFmpeg, orientada especialmente a proyectos de video con Remotion. Abarca operaciones esenciales como conversión de GIF a MP4 compatible con Remotion, redimensionado con diferentes estrategias (letterbox o crop), compresión con control de calidad mediante CRF y preset, extracción de audio en múltiples formatos (MP3, AAC, WAV), corte y ajuste de velocidad con preservación de sincronía de audio mediante filter_complex. También incluye patrones específicos para Remotion, como la preparación de grabaciones de pantalla o demos para integrar como activos, y una guía detallada de optimización por plataforma (YouTube, Twitter/X, LinkedIn, web) con parámetros recomendados para cada una. La skill está documentada en un único archivo SKILL.md estructurado con secciones de referencia rápida, ejemplos de comandos, tablas de parámetros de calidad y resolución de problemas comunes, lo que permite al agente ejecutar transformaciones multimedia de manera precisa y confiable.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/ffmpeg

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

FFmpeg para Producción de Video

FFmpeg es la herramienta esencial para el procesamiento de video/audio. Esta skill cubre operaciones comunes para proyectos de video con Remotion.

Referencia Rápida

GIF a MP4 (compatible con Remotion)

ffmpeg -i input.gif -movflags faststart -pix_fmt yuv420p \
  -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" output.mp4

Por qué estos flags:

  • -movflags faststart - Mueve los metadatos al inicio para transmisión web
  • -pix_fmt yuv420p - Garantiza compatibilidad con la mayoría de reproductores
  • scale=trunc(...) - Fuerza dimensiones pares (requerido por la mayoría de códecs)

Redimensionar Video

# A 1920x1080 (mantener relación de aspecto, añadir barras negras)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" output.mp4

# A 1920x1080 (recortar para llenar)
ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" output.mp4

# Escalar al ancho, altura automática
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4

Comprimir Video

# Buena calidad, archivo más pequeño (CRF 23 es el valor por defecto, menor = mejor calidad)
ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac -b:a 128k output.mp4

# Compresión agresiva para vista previa web
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset fast -c:a aac -b:a 96k output.mp4

# Tamaño de archivo objetivo (ej. ~10MB para video de 60s = ~1.3Mbps)
ffmpeg -i input.mp4 -c:v libx264 -b:v 1300k -c:a aac -b:a 128k output.mp4

Extraer Audio

# Extraer a MP3
ffmpeg -i input.mp4 -vn -acodec libmp3lame -q:a 2 output.mp3

# Extraer a AAC
ffmpeg -i input.mp4 -vn -acodec aac -b:a 192k output.m4a

# Extraer a WAV (sin comprimir)
ffmpeg -i input.mp4 -vn output.wav

Convertir Formatos de Audio

# M4A a MP3 (para muestras de voz de ElevenLabs)
ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3

# WAV a MP3
ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3

# Ajustar volumen
ffmpeg -i input.mp3 -filter:a "volume=1.5" output.mp3

Recortar/Cortar Video

# Cortar desde una marca de tiempo con duración (recomendado - fiable)
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c:v libx264 -c:a aac output.mp4

# Cortar desde una marca de tiempo hasta otra
ffmpeg -i input.mp4 -ss 00:00:30 -to 00:00:45 -c:v libx264 -c:a aac output.mp4

# Copia de flujo (más rápida pero puede perder fotogramas en los puntos de corte)
# Usar solo cuando la fuente tenga fotogramas clave frecuentes
ffmpeg -i input.mp4 -ss 00:00:30 -t 00:00:15 -c copy output.mp4

Nota: Se recomienda la re-codificación para recortar. La copia de flujo (-c copy) puede eliminar silenciosamente video si el punto de búsqueda no coincide con un fotograma clave.

Acelerar / Ralentizar

# Velocidad 2x (video y audio)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" output.mp4

# Velocidad 0.5x (cámara lenta)
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" output.mp4

# Solo video (sin audio)
ffmpeg -i input.mp4 -filter:v "setpts=0.5*PTS" -an output.mp4

Concatenar Videos

# Crear lista de archivos
echo "file 'clip1.mp4'" > list.txt
echo "file 'clip2.mp4'" >> list.txt
echo "file 'clip3.mp4'" >> list.txt

# Concatenar (mismo códec/resolución)
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4

# Concatenar con re-codificación (fuentes diferentes)
ffmpeg -f concat -safe 0 -i list.txt -c:v libx264 -c:a aac output.mp4

Añadir Fundido de Entrada/Salida

# Fundido de entrada en el primer segundo, fundido de salida en el último segundo (video de 30fps)
ffmpeg -i input.mp4 -vf "fade=t=in:st=0:d=1,fade=t=out:st=9:d=1" -c:a copy output.mp4

# Fundido de audio
ffmpeg -i input.mp4 -af "afade=t=in:st=0:d=1,afade=t=out:st=9:d=1" -c:v copy output.mp4

Obtener Información del Video

# Duración, resolución, información del códec
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 input.mp4

# Información completa
ffprobe -v quiet -print_format json -show_format -show_streams input.mp4

Patrones Específicos de Remotion

Ajuste de Velocidad de Video para Remotion

Cuándo usar FFmpeg vs playbackRate de Remotion:

EscenarioUsar FFmpegUsar Remotion
Velocidad constante (1.5x, 2x)Cualquiera funciona✅ Más simple
Velocidades extremas (>4x o <0.25x)✅ Más fiablePuede tener problemas
Velocidad variable (acelerar con el tiempo)✅ Pre-procesarWorkaround complejo
Necesita sincronía de audio perfecta✅ GarantizadoGeneralmente bien
Demo necesita ajustarse al tiempo de locución✅ Pre-calcularAjuste en tiempo de ejecución

Limitación de Remotion: playbackRate debe ser constante. La interpolación dinámica como playbackRate={interpolate(frame, [0, 100], [1, 5])} no funcionará correctamente porque Remotion evalúa los fotogramas de forma independiente.

# Acelerar demo para que quepa en una escena (ej., demo de 60s en 20s = velocidad 3x)
ffmpeg -i demo-raw.mp4 \
  -filter_complex "[0:v]setpts=0.333*PTS[v];[0:a]atempo=3.0[a]" \
  -map "[v]" -map "[a]" \
  public/demos/demo-fast.mp4

# Cámara lenta para énfasis (velocidad 0.5x)
ffmpeg -i action.mp4 \
  -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" \
  -map "[v]" -map "[a]" \
  public/demos/action-slow.mp4

# Acelerar sin audio (común para grabaciones de pantalla)
ffmpeg -i demo.mp4 -filter:v "setpts=0.5*PTS" -an public/demos/demo-2x.mp4

# Efecto timelapse (velocidad 10x, eliminar audio)
ffmpeg -i long-demo.mp4 -filter:v "setpts=0.1*PTS" -an public/demos/timelapse.mp4

Calcular factor de velocidad:

  • Para que X segundos de video quepan en Y segundos de escena: velocidad = X / Y
  • Multiplicador setpts = 1 / velocidad (ej., velocidad 3x = setpts=0.333*PTS)
  • Valor atempo = velocidad (ej., velocidad 3x = atempo=3.0)

Velocidad extrema (>2x audio): Encadenar filtros atempo (cada uno limitado al rango 0.5-2.0):

# Audio a velocidad 4x
-filter_complex "[0:a]atempo=2.0,atempo=2.0[a]"

# Audio a velocidad 8x
-filter_complex "[0:a]atempo=2.0,atempo=2.0,atempo=2.0[a]"

Preparar Grabación de Demo para Remotion

# Estándar 1080p, 30fps, listo para Remotion
ffmpeg -i raw-recording.mp4 \
  -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2,fps=30" \
  -c:v libx264 -crf 18 -preset slow \
  -c:a aac -b:a 192k \
  -movflags faststart \
  public/demos/demo.mp4

Grabación de Pantalla a Activo de Remotion

# Desde grabación de iPhone/iPad (generalmente 60fps, resolución variable)
ffmpeg -i iphone-recording.mov \
  -vf "scale=1920:-2,fps=30" \
  -c:v libx264 -crf 20 \
  -an \
  public/demos/mobile-demo.mp4

Convertir GIFs por Lote

for f in assets/*.gif; do
  ffmpeg -i "$f" -movflags faststart -pix_fmt yuv420p \
    -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" \
    "public/demos/$(basename "$f" .gif).mp4"
done

Problemas Comunes

"Height not divisible by 2"

Añadir filtro de escala: -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2"

El video no se reproduce en el navegador

Usar: -movflags faststart -pix_fmt yuv420p -c:v libx264

Audio desincronizado después del cambio de velocidad

Usar filter_complex con atempo: -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]"

Archivo demasiado grande

Aumentar CRF (23→28) o reducir resolución

Guía de Calidad

Caso de UsoCRFPresetNotas
Archivo/Maestro18slowMejor calidad, archivos grandes
Producción20-22mediumBuen equilibrio
Web/Vista previa23-25fastArchivos más pequeños
Borrador/Rápido28+veryfastCodificación rápida

Optimización de Salida por Plataforma

Después de que Remotion renderice tu video (normalmente en out/video.mp4), usa FFmpeg para optimizarlo para cada plataforma de distribución.

Integración del Flujo de Trabajo

Renderizado de Remotion (maestro)     Optimización FFmpeg      Subida a plataforma
       ↓                            ↓                       ↓
   out/video.mp4  ────────→  out/video-youtube.mp4  ───→  YouTube
                  ────────→  out/video-twitter.mp4  ───→  Twitter/X
                  ────────→  out/video-linkedin.mp4 ───→  LinkedIn
                  ────────→  out/video-web.mp4      ───→  Inserción en web

YouTube (Configuración Recomendada)

YouTube vuelve a codificar todo, así que sube con alta calidad:

# YouTube optimizado (1080p)
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset slow -crf 18 \
  -profile:v high -level 4.0 \
  -bf 2 -g 30 \
  -c:a aac -b:a 192k -ar 48000 \
  -movflags +faststart \
  out/video-youtube.mp4

# YouTube Shorts (vertical 1080x1920)
ffmpeg -i out/video.mp4 \
  -vf "scale=1080:1920:force_original_aspect_ratio=decrease,pad=1080:1920:(ow-iw)/2:(oh-ih)/2" \
  -c:v libx264 -crf 18 -c:a aac -b:a 192k \
  out/video-shorts.mp4

Twitter/X

Twitter tiene límites estrictos: máximo 140s, 512MB, 1920x1200:

# Twitter optimizado (con objetivo de menos de 15MB para subida rápida)
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset medium -crf 24 \
  -profile:v main -level 3.1 \
  -vf "scale='min(1280,iw)':'min(720,ih)':force_original_aspect_ratio=decrease" \
  -c:a aac -b:a 128k -ar 44100 \
  -movflags +faststart \
  -fs 15M \
  out/video-twitter.mp4

# Verificar tamaño y duración del archivo
ffprobe -v error -show_entries format=duration,size -of csv=p=0 out/video-twitter.mp4

LinkedIn

LinkedIn prefiere MP4 con audio AAC, máximo 10 minutos:

# LinkedIn optimizado
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset medium -crf 22 \
  -profile:v main \
  -vf "scale='min(1920,iw)':'min(1080,ih)':force_original_aspect_ratio=decrease" \
  -c:a aac -b:a 192k -ar 48000 \
  -movflags +faststart \
  out/video-linkedin.mp4

Sitio Web/Inserción (Optimizado para Carga Rápida)

# MP4 optimizado para web (archivo pequeño, carga progresiva)
ffmpeg -i out/video.mp4 \
  -c:v libx264 -preset medium -crf 26 \
  -profile:v baseline -level 3.0 \
  -vf "scale=1280:720" \
  -c:a aac -b:a 128k \
  -movflags +faststart \
  out/video-web.mp4

# Alternativa WebM (mejor compresión, mayor compatibilidad con navegadores)
ffmpeg -i out/video.mp4 \
  -c:v libvpx-vp9 -crf 30 -b:v 0 \
  -vf "scale=1280:720" \
  -c:a libopus -b:a 128k \
  -deadline good \
  out/video-web.webm

GIF (para Vistas Previas/Miniaturas)

# GIF de alta calidad (primeros 5 segundos)
ffmpeg -i out/video.mp4 -t 5 \
  -vf "fps=15,scale=480:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
  out/preview.gif

# GIF de archivo más pequeño
ffmpeg -i out/video.mp4 -t 3 \
  -vf "fps=10,scale=320:-1:flags=lanczos,split[s0][s1];[s0]palettegen[p];[s1][p]paletteuse" \
  out/preview-small.gif

Referencia Rápida de Requisitos por Plataforma

PlataformaResolución Máx.Tamaño Máx.Duración Máx.Audio
YouTube8K256GB12 horasAAC 48kHz
Twitter/X1920x1200512MB140sAAC 44.1kHz
LinkedIn4096x23045GB10 minAAC 48kHz
Instagram Feed1080x13504GB60sAAC 48kHz
Instagram Reels1080x19204GB90sAAC 48kHz
TikTok1080x1920287MB10 minAAC

Exportación por Lotes para Todas las Plataformas

#!/bin/bash
# guardar como: export-all-platforms.sh
INPUT="out/video.mp4"

# YouTube (alta calidad)
ffmpeg -i "$INPUT" -c:v libx264 -preset slow -crf 18 \
  -c:a aac -b:a 192k -movflags +faststart \
  out/video-youtube.mp4

# Twitter (comprimido)
ffmpeg -i "$INPUT" -c:v libx264 -crf 24 \
  -vf "scale='min(1280,iw)':'-2'" \
  -c:a aac -b:a 128k -movflags +faststart \
  out/video-twitter.mp4

# LinkedIn
ffmpeg -i "$INPUT" -c:v libx264 -crf 22 \
  -c:a aac -b:a 192k -movflags +faststart \
  out/video-linkedin.mp4

# Inserción web (pequeño)
ffmpeg -i "$INPUT" -c:v libx264 -crf 26 \
  -vf "scale=1280:720" \
  -c:a aac -b:a 128k -movflags +faststart \
  out/video-web.mp4

echo "Exportado:"
ls -lh out/video-*.mp4

Manejo de Errores

Errores comunes y soluciones al procesar video:

# Verificar si FFmpeg tuvo éxito
ffmpeg -i input.mp4 -c:v libx264 output.mp4 && echo "Éxito" || echo "Falló: verificar archivo de entrada"

# Validar que el archivo de salida sea reproducible
ffprobe -v error -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 output.mp4

# Obtener información detallada del error
ffmpeg -v error -i input.mp4 -f null - 2>&1 | head -20

Manejo de Fallos Comunes

ErrorCausaSolución
"No such file"Ruta de entrada incorrectaVerificar ruta, usar comillas para espacios
"Invalid data"Entrada corruptaVolver a descargar o regrabar la fuente
"height not divisible by 2"Dimensiones imparesAñadir filtro de escala con trunc
"encoder not found"Códec faltanteInstalar FFmpeg con códecs completos
Salida 0 bytesFallo silenciosoVerificar la salida completa de ffmpeg en busca de errores

Comentarios y Contribuciones

Si a esta skill le falta información o se puede mejorar:

  • ¿Falta un comando? Describe lo que necesitabas
  • ¿Encontraste un error? Indica qué está mal
  • ¿Quieres contribuir? Puedo ayudarte a:
    1. Actualizar esta skill con mejoras
    2. Crear un PR en github.com/digitalsamba/claude-code-video-toolkit

Solo di "mejorar esta skill" y te guiaré en la actualización de .claude/skills/ffmpeg/SKILL.md.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills relacionados