Communitygithub.com

ComeOnOliver/skillshub

FFmpeg es la navaja suiza del procesamiento multimedia. Maneja prácticamente todos los formatos de audio y video, códecs y contenedores existentes. Esta habilidad cubre conversión de formatos, transcodificación de códecs, recorte, concatenación, filtrado, compresión, extracción de miniaturas, incrustación de subtítulos, normalización de audio, creación de GIF, marcas de agua e integración en tuberías con herramientas como yt-dlp y gallery-dl.

¿Qué es skillshub?

Esta habilidad proporciona un conjunto completo de comandos y técnicas para usar FFmpeg, el estándar de facto en el procesamiento de medios desde la línea de comandos. Es especialmente útil para agentes de IA que necesitan manipular archivos de audio y video de manera programática, ya que ofrece instrucciones claras y ejemplos prácticos. La habilidad cubre desde la instalación básica en Linux/macOS hasta operaciones avanzadas como conversión de formatos (WebM a MP4, MKV a MP4, etc.), extracción y normalización de audio, recorte y concatenación de clips, redimensionado y compresión con control de calidad mediante CRF, extracción de miniaturas, manejo de subtítulos (duros y blandos), creación de GIF animados, aplicación de filtros y efectos (marcas de agua, rotación, cambios de velocidad, fade) y procesamiento por lotes. Además, incluye directrices para optimizar la compatibilidad con dispositivos móviles y navegadores web, y ejemplos completos de integración con yt-dlp para descargas. Está diseñada para funcionar en cualquier sistema con FFmpeg instalado y es compatible con los asistentes de codificación Cursor, Codex y Claude Code.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/TerminalSkills/skills/ffmpeg

Preguntar en tu IA favorita

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

Documentación

FFmpeg

Resumen

FFmpeg es la navaja suiza del procesamiento multimedia. Maneja prácticamente todos los formatos de audio y video, códecs y contenedores existentes. Esta habilidad cubre conversión de formatos, transcodificación de códecs, recorte, concatenación, filtrado, compresión, extracción de miniaturas, incrustación de subtítulos, normalización de audio, creación de GIF, marcas de agua e integración en tuberías con herramientas como yt-dlp y gallery-dl.

Instrucciones

Paso 1: Instalación

# Ubuntu/Debian
sudo apt install -y ffmpeg

# macOS
brew install ffmpeg

# Verificar
ffmpeg -version
ffprobe -version   # herramienta de información multimedia, incluida con ffmpeg

Paso 2: Conversión de formato

La tarea más común: convertir entre formatos de contenedor y códecs.

# WebM → MP4 (re-codificar a H.264 + AAC para compatibilidad universal)
ffmpeg -i input.webm -c:v libx264 -c:a aac -movflags +faststart output.mp4

# WebM → MP4 (copiar flujos si ya son H.264/AAC — instantáneo, sin pérdida de calidad)
ffmpeg -i input.webm -c copy output.mp4

# MKV → MP4 (copia de flujo, sin re-codificación)
ffmpeg -i input.mkv -c copy output.mp4

# AVI → MP4
ffmpeg -i input.avi -c:v libx264 -crf 23 -c:a aac -b:a 128k output.mp4

# MOV → MP4 (Apple ProRes a H.264)
ffmpeg -i input.mov -c:v libx264 -crf 18 -preset slow -c:a aac output.mp4

# Cualquier formato → MP4 con inicio rápido optimizado para web
ffmpeg -i input.* -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart output.mp4

CRF (Factor de Tasa Constante): Controla la calidad. Menor = mejor calidad, archivo más grande.

  • 18: Sin pérdida visual
  • 23: Valor predeterminado, buen equilibrio
  • 28: Archivo más pequeño, algo de pérdida de calidad
  • 51: Peor calidad

Paso 3: Operaciones de audio

# Extraer audio de un video
ffmpeg -i video.mp4 -vn -c:a copy audio.aac          # Copiar códec (rápido)
ffmpeg -i video.mp4 -vn -c:a libmp3lame -q:a 2 audio.mp3  # Convertir a MP3
ffmpeg -i video.mp4 -vn -c:a flac audio.flac          # FLAC sin pérdida

# Convertir entre formatos de audio
ffmpeg -i input.wav -c:a libmp3lame -b:a 320k output.mp3
ffmpeg -i input.mp3 -c:a libopus -b:a 128k output.opus
ffmpeg -i input.flac -c:a aac -b:a 256k output.m4a

# Normalizar volumen de audio
ffmpeg -i input.mp3 -af loudnorm=I=-16:LRA=11:TP=-1.5 output.mp3

# Cambiar frecuencia de muestreo
ffmpeg -i input.wav -ar 44100 output.wav

# Fusionar audio en video
ffmpeg -i video.mp4 -i audio.mp3 -c:v copy -c:a aac -map 0:v:0 -map 1:a:0 output.mp4

Paso 4: Recortar, cortar y concatenar

# Recortar desde una marca de tiempo hasta una duración
ffmpeg -i input.mp4 -ss 00:01:30 -t 00:00:45 -c copy clip.mp4    # 45s comenzando en 1:30

# Recortar desde una marca de inicio hasta una de fin
ffmpeg -i input.mp4 -ss 00:05:00 -to 00:10:00 -c copy clip.mp4   # 5:00 a 10:00

# Primeros 30 segundos
ffmpeg -i input.mp4 -t 30 -c copy first30.mp4

# Concatenar archivos (crear lista de archivos primero)
cat > filelist.txt << 'EOF'
file 'clip1.mp4'
file 'clip2.mp4'
file 'clip3.mp4'
EOF
ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4

# Concatenar con re-codificación (cuando los códecs difieren)
ffmpeg -f concat -safe 0 -i filelist.txt -c:v libx264 -c:a aac output.mp4

Paso 5: Resolución y compresión

# Redimensionar a 1080p (mantener relación de aspecto)
ffmpeg -i input.mp4 -vf "scale=-2:1080" -c:v libx264 -crf 23 -c:a copy output.mp4

# Redimensionar a 720p
ffmpeg -i input.mp4 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a copy output.mp4

# Redimensionar a un ancho específico (altura automática)
ffmpeg -i input.mp4 -vf "scale=1280:-2" output.mp4

# Comprimir de forma agresiva (archivo más pequeño)
ffmpeg -i input.mp4 -c:v libx264 -crf 28 -preset faster -c:a aac -b:a 96k small.mp4

# Codificación de dos pasadas para un tamaño de archivo objetivo
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 1 -an -f null /dev/null
ffmpeg -i input.mp4 -c:v libx264 -b:v 1M -pass 2 -c:a aac -b:a 128k output.mp4

# Cambiar velocidad de fotogramas
ffmpeg -i input.mp4 -r 30 output.mp4

Paso 6: Miniaturas y capturas de pantalla

# Una sola captura en una marca de tiempo
ffmpeg -i input.mp4 -ss 00:01:30 -frames:v 1 thumb.jpg

# Captura cada 10 segundos
ffmpeg -i input.mp4 -vf "fps=1/10" thumbs/frame_%04d.jpg

# Cuadrícula de miniaturas (hoja de contactos 4x4)
ffmpeg -i input.mp4 -vf "select='not(mod(n,300))',scale=320:-1,tile=4x4" -frames:v 1 grid.jpg

# Extraer primer fotograma
ffmpeg -i input.mp4 -frames:v 1 first_frame.png

Paso 7: Subtítulos

# Quemar subtítulos en el video (incrustados)
ffmpeg -i input.mp4 -vf "subtitles=subs.srt" output.mp4

# Quemar subtítulos ASS/SSA con estilo
ffmpeg -i input.mp4 -vf "ass=subs.ass" output.mp4

# Agregar pista de subtítulos (subtítulos blandos, el usuario puede activarlos)
ffmpeg -i input.mp4 -i subs.srt -c copy -c:s mov_text output.mp4

# Extraer subtítulos del video
ffmpeg -i input.mkv -map 0:s:0 subs.srt

Paso 8: Filtros y efectos

# Crear GIF a partir de un segmento de video
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos" output.gif

# GIF de alta calidad con paleta
ffmpeg -i input.mp4 -ss 5 -t 3 -vf "fps=15,scale=480:-1:flags=lanczos,palettegen" palette.png
ffmpeg -i input.mp4 -i palette.png -ss 5 -t 3 -lavfi "fps=15,scale=480:-1:flags=lanczos[v];[v][1:v]paletteuse" output.gif

# Agregar marca de agua
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-10:H-h-10" output.mp4

# Acelerar / ralentizar
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=0.5*PTS[v];[0:a]atempo=2.0[a]" -map "[v]" -map "[a]" fast.mp4
ffmpeg -i input.mp4 -filter_complex "[0:v]setpts=2.0*PTS[v];[0:a]atempo=0.5[a]" -map "[v]" -map "[a]" slow.mp4

# Rotar video
ffmpeg -i input.mp4 -vf "transpose=1" rotated.mp4    # 90° en sentido horario
ffmpeg -i input.mp4 -vf "transpose=2" rotated.mp4    # 90° en sentido antihorario

# Recortar video (ancho:alto:x:y)
ffmpeg -i input.mp4 -vf "crop=1280:720:0:180" cropped.mp4

# Fundido de entrada/salida
ffmpeg -i input.mp4 -vf "fade=in:0:30,fade=out:870:30" -af "afade=in:0:30,afade=out:870:30" output.mp4

Paso 9: Información multimedia

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

# Solo duración
ffprobe -v quiet -show_entries format=duration -of csv=p=0 input.mp4

# Resolución
ffprobe -v quiet -select_streams v:0 -show_entries stream=width,height -of csv=p=0 input.mp4

# Información del códec
ffprobe -v quiet -select_streams v:0 -show_entries stream=codec_name -of csv=p=0 input.mp4

Paso 10: Procesamiento por lotes

# Convertir todos los archivos WebM a MP4
for f in *.webm; do
  ffmpeg -i "$f" -c:v libx264 -crf 23 -c:a aac "${f%.webm}.mp4"
done

# Comprimir todos los archivos MP4 en el directorio
for f in *.mp4; do
  ffmpeg -i "$f" -c:v libx264 -crf 28 -preset fast -c:a aac "compressed_${f}"
done

# Extraer audio de todos los videos
for f in *.mp4; do
  ffmpeg -i "$f" -vn -c:a libmp3lame -q:a 2 "${f%.mp4}.mp3"
done

Ejemplos

Ejemplo 1: Convertir descargas de yt-dlp de WebM a MP4

Solicitud del usuario: "Descargué videos con yt-dlp pero todos son archivos .webm. Conviértelos a MP4 para que se reproduzcan en mi iPhone."

El agente:

  1. Verificará si los archivos WebM contienen H.264+AAC (posible copia de flujo) o VP9+Opus (necesita re-codificación) usando ffprobe.
  2. Para archivos VP9/Opus, ejecutará: for f in *.webm; do ffmpeg -i "$f" -c:v libx264 -crf 23 -preset medium -c:a aac -movflags +faststart "${f%.webm}.mp4"; done
  3. La bandera -movflags +faststart mueve los metadatos al inicio del archivo, permitiendo la reproducción instantánea en dispositivos móviles y navegadores web.
  4. Reportará los resultados de la conversión con los tamaños de archivo antes y después.

Ejemplo 2: Crear un reel de highlights a partir de múltiples clips

Solicitud del usuario: "Tengo 5 clips de video de una conferencia. Recorta las mejores partes y únelas en un solo video con transiciones de fundido."

El agente:

  1. Recortará cada clip a las marcas de tiempo especificadas usando las banderas -ss y -to.
  2. Re-codificará todos los clips con códec/resolución coincidentes: ffmpeg -i clip.mp4 -c:v libx264 -crf 23 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:-1:-1,fade=in:0:15,fade=out:st=DURACION:d=0.5" -c:a aac -ar 44100 segmento_N.mp4
  3. Creará una lista de archivos concat y los fusionará: ffmpeg -f concat -safe 0 -i filelist.txt -c copy highlight_reel.mp4

Pautas

  • Al convertir descargas de yt-dlp (típicamente WebM/VP9+Opus), siempre re-codificar a H.264+AAC para máxima compatibilidad con dispositivos. Usar -c:v libx264 -crf 23 -c:a aac -movflags +faststart.
  • Usar copia de flujo (-c copy) siempre que sea posible para evitar re-codificación; es instantáneo y sin pérdida. Solo re-codificar al cambiar códecs, aplicar filtros o cuando el contenedor de origen y destino sean incompatibles.
  • Siempre agregar -movflags +faststart al crear archivos MP4 para reproducción web o móvil; mueve el átomo moov al inicio del archivo para transmisión instantánea.
  • Usar ffprobe antes del procesamiento para entender el formato de entrada, evitando re-codificaciones innecesarias.
  • Para operaciones por lotes, probar siempre el comando en un solo archivo primero antes de ejecutarlo en todo el directorio.
  • Preferir el modo CRF sobre el modo de tasa de bits para codificación de una sola pasada; produce una calidad consistente en diferentes tipos de contenido.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados