ffmpeg-skill nedir? Kodlama ajanına video düzenletmek: kurulum, 42 araç ve örnek istekler

FFmpeg video ve sesle her şeyi yapabilen ama komutu ezberlenmesi zor bir programdır. Bir kodlama ajanı FFmpeg'i "bilir" ama çoğu zaman tahmin eder: kare hızını varsayar, kabın taşıyamayacağı bir kodek seçer, yalnız kesilmesi gereken dosyayı baştan kodlar ve sonucu açıp bakmadan "bitti" der. README'nin anlattığı sorun bu. ffmpeg-skill ajana ölçen, sınırları belli ve sonucunu kontrol eden 42 hazır araç verir: ajan önce dosyayı ölçer, sonra uygun aracı çalıştırır, en sonda çıktıyı ölçüp kontrol eder.

Kime yarar: Reels, TikTok, Shorts ya da podcast hazırlayan içerik ekiplerine ve ajanslara; röportaj, eğitim ya da toplantı kaydını kısa parçalara bölmek isteyenlere; zaten Claude Code, Cursor ya da Codex kullanan ve video işini de aynı yerden yaptırmak isteyenlere. Bir video düzenleme programı (zaman çizelgesi, sürükle bırak) değildir: istek yazılır, ajan araçları çalıştırır.

Neyin kesileceğine, hangi sahnenin ilginç olduğuna ya da altyazının ne diyeceğine skill karar vermez; bunlar ajanın ya da senin kararın. README bu ayrımı açıkça yapıyor: skill "eller", karar veren "beyin" başka yerde.

• Kaynağını korur: hiçbir araç girdisinin üzerine yazmaz; çıktı yeni bir dosyadır. Var olan bir çıktı dosyası da ancak --overwrite ile değiştirilir.
• Kabukta serbest komut yok: her işlem tipli seçenekleri olan bir Python betiği; dışarıdan FFmpeg filtre dizisi ya da ham argüman kabul etmez.
• Makinenin neyi yapabildiğini söyler: npx ffmpeg-skill doctor kurulu FFmpeg'in hangi bileşenleri (libx264, libass, loudnorm…) taşıdığını ve hangi aracın kullanılamayacağını listeler.
• Rapor biçimi sabit: iş bitince Done:, olmazsa Failed: der; eksik kalan kısmı notta yazar.

Her araçta ortak seçenekler var: --dry-run (planı göster), --json (çıktının ölçümüyle yapılandırılmış sonuç), --fast (önizleme kalitesi), --progress, --timeout (takılan FFmpeg'i durdurur, varsayılan 1.800 sn) ve --overwrite. Ses dosyaları (WAV, FLAC, MP3, M4A, OGG, Opus) da aynı komutlarla işlenir; görüntü araçları ses dosyasını "görüntü akışı yok" diye reddeder, resim uydurmaz.

Önce bilgisayarında FFmpeg kurulu olmalı (skill FFmpeg'i kendisi getirmez), sonra skill'i ajanına kurarsın. Kurulum bir kez yapılır; kopya kendiliğinden güncellenmez.

• FFmpeg: 5.0 ve üstü; 6.1+ önerilir (5.x 2.14.0'dan beri eski sayılıyor, 3.0 sürümü 6.1 isteyecek).
• Python: 3.9 ve üstü, yalnız standart kütüphane (ek paket kurmaz); 3.10+ önerilir.
• Node: 16+ yalnız npx kurulumu için.
• Kurulumda çalışan: npx paketi ek bağımlılık ve kurulum betiği (postinstall) taşımaz; kurucu SKILL.md, scripts/, templates/, references/, docs/ ve mcp/ klasörlerini hedef klasöre kopyalar.

Kurulumdan sonra ajanınla normal konuşursun; video ya da ses dosyasından söz ettiğinde skill kendiliğinden devreye girer. Aşağıdaki örnekler README'den; çıktılar README'de anlatıldığı kadar tarif edildi.

Ne alırsın: README'ye göre ajan sırasıyla ölçer (probe.py), iki aralığı keser (cut.py --segments 0:45-3:10,5:00-6:30), 60 saniyeye ve 9:16'ya kırparak uyarlar (fit.py --duration 60 --aspect 9:16 --fit crop), Reels ayarıyla dışa aktarır (export.py --preset reels), Reels kurallarına karşı kontrol eder (check.py --platform reels) ve kontak sayfası çıkarır (look.py). Rapor şöyle bir satırla biter: "final.mp4: 59.98 s, 1080×1920, 30 fps, AAC stereo", yanında incelediği görsel.

Ne alırsın: TikTok şablonu dosyayı 9:16'ya kırpar, altyazıyı kelime kelime TikTok'un açıklama çubuğunun üstüne ve beğeni sütununun dışına yerleştirir, sesi −14 LUFS'a getirir, TikTok ayarıyla dışa aktarır ve yazdığı dosyayı check.py --platform tiktok ile kontrol eder. --template all aynı kurgudan bütün platformları üretir ve ne üretildiğini bir _pack.md tablosunda listeler; --dry-run hiçbir şey yazmadan planı gösterir. Şablonlar: tiktok, reels, shorts, youtube, x, linkedin, facebook, podcast.

Ne alırsın: README'deki ses araçlarına göre ajan sessizlikleri kaldırır (silence.py), sesi podcast hedefine getirir (loudness.py … -I -16 --tp -1.5 -o … .m4a) ve check.py --platform podcast ile LUFS, gerçek tepe değeri, bölüm işaretleri ve kanal sayısını raporlar. Ses dosyasında görsel adım olmadığı için rapor "Look: not needed" der.

Uzun bir işten önce "önce planı göster, çalıştırma" de: her araç --dry-run ile yalnız çalıştıracağı komutları listeler. Üç ve daha fazla adımlı kurgularda README tek bir project.json ile render.py kullanmayı öneriyor (her adımda yeniden kodlama kalite kaybettirir).

!Skill FFmpeg'i getirmez; kurulu FFmpeg'deki bir açık güncelleyene kadar senin sürümünde kalır, doctor bilinen yüksek önemdeki açıklarda uyarır, FFmpeg'i güncel tut.

Evet. MIT lisanslı, ücretsiz; hesap, abonelik ya da API anahtarı istemez. Ticari işlerde de kullanılabilir (MIT, lisans bildirimini korumanı ister). Geliştirici GitHub Sponsors ile isteğe bağlı destek kabul ediyor. Para yalnız kullandığın ajana gider (Claude Code, Cursor ya da Codex aboneliği): skill işlemi bilgisayarında yaptığı için ayrıca ücret çıkarmaz.

Lisans özeti hukuki görüş değildir. İşlediğin videoların, müziklerin ve yazı tiplerinin kullanım hakları ayrıca geçerlidir.

Yapamadıkları (README SSS): yüz ya da nesne takibi yok; kayan logo ya da yeri değişen gömülü altyazı silinmez (yalnız sabit, bilinen bir dikdörtgen bulanıklaştırılır); GPU ile kodlama yalnız Apple Silicon'da VideoToolbox.

Plugin olarak kurduysan Claude Code'da /plugin panelinin Installed sekmesinden kaldır. FFmpeg ve Python ayrı programlardır, skill ile birlikte silinmez.