# video-edit

Adopt this skill: https://proskills.md/skills/other/omergocmen-ai-video-edit-workflow-claude-skills-video-edit

Page: https://proskills.md/skills/other/omergocmen-ai-video-edit-workflow-claude-skills-video-edit
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .claude/skills/video-edit/SKILL.md
size: 528
sha: 20dae7abf4e87c36aa760de8acbbf00ca5266bfa
upstream: https://github.com/omergocmen/ai-video-edit-workflow/blob/main/.claude/skills/video-edit/SKILL.md

```text
---
name: video-edit
description: Kullanıcının kestiği veya ham videosuna brief'e göre logo, arama sahnesi, sayaç, çerçeve vurgusu, ekran görüntüsü, yakınlaştırma ve müzik ekler. Remotion ile şeffaf katman üretir, ffmpeg ile birleştirir. Brief geldiğinde veya "videoyu edit et" denince kullan.
---

# Video edit

Akışın tamamı `talimat/video-edit.md` dosyasındadır. Önce o dosyayı oku, sonra adımları sırayla uygula. Kullanıcı genellikle `materyaller/<video>/brief.md` dosyasını işaret eder.
```

## File: README.md
upstream: https://github.com/omergocmen/ai-video-edit-workflow/blob/main/README.md

```text
# Video Edit Workflow

Videonu kesersin, logo, arama sahnesi, sayaç, çerçeve vurgusu, ekran görüntüsü, yakınlaştırma ve müziği yapay zeka ekler (Claude Code, Codex CLI, Gemini CLI veya Cursor). Her şey kendi bilgisayarında çalışır.

## Gerekenler
- Windows 10/11 ya da Mac bilgisayar. Mac'te en sorunsuz kurulum Apple Silicon (M1 ve sonrası) ve macOS 15 Sequoia veya üstüdür. Intel Mac'te ve eski macOS'ta da çalışır, ama Homebrew paketleri derleyebileceği için ilk kurulum uzun sürebilir (bkz. "Mac'te kullanım").
- Bir yapay zeka kodlama aracı: [Claude Code](https://claude.com/product/claude-code) (ücretli Claude planı gerekir), Codex CLI veya Gemini CLI. Cursor ve diğer araçlarda komutu elle yapıştırırsın.
- Node.js, ffmpeg ve Python gerekir ama sen kurmazsın: `baslat.bat` eksik olanları kendisi indirir (winget gerekmez). Node.js ve ffmpeg proje içindeki `araclar` klasörüne gider. Bilgisayarının PATH ayarına dokunulmaz.

## Kullanım (tek dosya)
1. Zip'i klasöre ayıkla. Zip'in içinden çalıştırma.
2. `baslat.bat` dosyasına çift tıkla.
   - İlk seferde eksik programları kurar (yaklaşık 150 MB, birkaç dakika) ve Claude Code kurulsun mu diye sorar.
   - Sonra formu tarayıcıda açar. Sonraki seferlerde kurulum atlanır, form hemen açılır.
3. Formu doldur. Dosyaları seçtiğin anda doğru klasörlere kendiliğinden yerleşir ve brif güncellenir.
4. **Edit'i başlat** düğmesine bas. Bir terminal penceresi açılır ve seçtiğin yapay zeka aracı işe başlar. İlk seferde o pencerede aracına giriş yaparsın.
5. Bitince araç "çıktı şu klasörde" der. Dosya `out/` klasöründe olur.

`baslat.bat` açtığı siyah pencere formu kullandığın sürece açık kalmalı. İşin bitince kapat. Sunucu sadece senin bilgisayarında çalışır, dışarıdan erişilemez.

Cursor veya başka bir araç kullanıyorsan ya da düğme çalışmazsa formdaki **Elle yapıştırmak istersen** bölümünden komutu kopyalayıp aracına yapıştır. Kendi terminalini açmak için `terminal.bat` var: Node.js, ffmpeg ve Python orada tanınır.

## Mac'te kullanım
1. Zip'i indir ve aç (genelde İndirilenler klasörüne açılır).
2. Terminal'i aç: `Cmd + Boşluk`, "Terminal" yaz, Enter.
3. Terminal'e `bash ` yaz (sonunda bir boşluk bırak), sonra klasördeki `baslat.command` dosyasını sürükleyip Terminal penceresine bırak ve Enter'a bas.
   - İlk seferde Homebrew yoksa kurulsun mu diye sorar, `e` de. Mac şifreni isteyebilir; şifre yazarken ekranda bir şey görünmez, bu normal.
   - Sonra Node.js ve ffmpeg kurulur, Claude Code kurulsun mu diye sorar. Bir kez yapılır.
   - Form tarayıcıda açılır. Terminal penceresini işin bitene kadar açık tut.
4. Formu doldur, **Edit'i başlat**'a bas. Yeni bir Terminal penceresinde yapay zeka aracı işe başlar.

Sonraki seferlerde de aynı şekilde aç. `baslat.command` dosyasına çift tıklamak da olur, ama Mac internetten inen dosyalarda ilk seferde "açılamıyor" uyarısı verir. O zaman **Sistem Ayarları → Gizlilik ve Güvenlik** bölümünün altındaki **Yine de Aç** düğmesine bas ya da 3. adımdaki Terminal yolunu kullan.

`.bat`, `.ps1` dosyaları sadece Windows içindir, Mac'te kullanılmaz.

Mac'te sorun çıkarsa:
- **"brew: command not found" ya da kurulum yarıda kaldı:** Terminal'i kapatıp aç, 3. adımı tekrarla. Betik kaldığı yerden devam eder.
- **Homebrew yönetici şifresi istiyor ama kabul etmiyor:** Mac kullanıcın yönetici (admin) olmalı.
- **Başlat'a basınca "claude bulunamadı":** Terminal'de `npm install -g @anthropic-ai/claude-code` çalıştır ya da Codex/Gemini kullanıyorsan onu kur, sonra Başlat'a tekrar bas.
- **Kendi Terminal'inde ffmpeg veya node bulunamıyor:** Başlat düğmesinin açtığı pencerede sorun olmaz. Elle çalıştıracaksan önce `export PATH=/opt/homebrew/bin:/usr/local/bin:$PATH` yaz.
- **Transkript için Python:** Mac'te `python3` kullanılır. Yapay zeka gerekirse proje içinde `.venv` sanal ortamı açar, sistemine dokunmaz.

## Her yeni video için
`baslat.bat`'a çift tıkla, formu doldur, **Edit'i başlat**'a bas. Her video kendi adıyla `materyaller/` altında ayrı bir klasöre yerleşir.

`kur.bat` sadece bir şey bozulursa elle çalıştırılır (kurulumu yeniden yapar).

## Dikey (9:16) videolar
Kaynak yatay ekran kaydıysa ve çıktı dikeyse, ekranı sığdırıp altını boş bırakmak yerine `Dikey` sahnesi kullanılır: ekran kırpılıp konuşulan yere kaydırılır, yüz altta kaynak oranında görünür, efektler ekran penceresine göre çizilir. Ekran uzun süre durağansa kadraj hareketi ve efektlerle canlandırılır.

Hazır betikler (yapay zeka bunları çalıştırır, sen çalıştırmak zorunda değilsin):
- `node scripts/analiz.mjs VIDEO --kamera x,y,w,h`: çözünürlük, süre, kareler ve ekranın durağan aralıkları.
- `node scripts/kontrol.mjs plan dikey.json`: render öncesi plan kapısı (kadraj, yüz çakışması, durağan aralık, efekt kayması).
- `node scripts/kontrol.mjs cikti VIDEO --sure SN`: render sonrası ölçüm (süre, ses, siyah alan oranı, 3 sn'den uzun donuk görüntü).

Kontrol kapısı geçmeden teslim yapılmaz. Render süresi bilgisayarına göre değişir, 1 dakikalık dikey videoda birkaç dakika sürebilir.

Formda **Yapay zeka modeli** olarak "orta veya zayıf" seçersen komut önce `talimat/adim-adim.md` dosyasını okutur: daha kısa, adım adım ve hazır komutlu bir akış.

## PATH ve terminal
`kur.bat` bilgisayarının kalıcı PATH ayarına yazmaz. Kurduğu araçlar sadece `terminal.bat` ve `baslat.bat` açtığı pencerelerde tanınır. Daha önce eski `kur.bat` ile kurduysan ve PATH'ine `araclar` klasörü girdiyse `yol-temizle.ps1` dosyasına sağ tıklayıp **PowerShell ile çalıştır** de. Yalnızca bu projenin eklediği yolları siler ve eski PATH'i `path-yedek.txt` dosyasına yedekler.
Yapay zeka araçlarına da "PATH'i kalıcı değiştirme, `setx` kullanma" kuralı `CLAUDE.md`, `AGENTS.md` ve `GEMINI.md` içinde yazılıdır.

## Efektler
Formda 25 efekt var, hepsinin ön izlemesi yanındaki ▶ düğmesinde: detaya yaklaşma, altını çizme, çerçeve, spotlight, fosforlu kalem, ok, tıklama halkası, sayaç, çubuk grafik, madde listesi, başlık kartı, isim bandı, bölüm etiketi, bilgi kartı, önce/sonra, çeviri, arama sahnesi, haber ekran görüntüsü, test penceresi, tuş kısayolu, bulanıklaştırma, logo, abone ol çağrısı, ilerleme çubuğu, geri sayım. Formda ayrıca giriş kancası seçeneği var: yapay zeka videodan en vurucu cümleyi bulur veya sen kendi cümleni yazarsın. Altyazıda kelime kelime vurgulu seçenek de var.

## Ayarlarını kaydetmek
Sağdaki **Ayarlarım** kartında renk, stil, efekt, ses ve kamera seçimlerini bir adla kaydedebilirsin. Sonraki videoda listeden seçip **Yükle**'ye basman yeter. Video adı, dosyalar ve notlar kaydedilmez. `baslat.bat` ile açtıysan kayıtlar `ayarlar/stiller.json` dosyasında durur.

## Tanıtım sitesi (Vercel)
`site/` klasörü tek dosyalık statik bir tanıtım sayfasıdır (`site/index.html`). Efektlerin canlı demosu, örnek ayarlar ve kurulum adımları var. Vercel'de projeyi içe aktarırken **Root Directory** olarak `site` seç, Framework Preset için **Other** kalsın, build komutu gerekmez. Sayfadaki GitHub bağlantıları `github.com/omergocmen/video-edit-workflow` adresine gider. Repo adın farklıysa `site/index.html` içinde bu adresi değiştir.

## İçindekiler
- `baslat.bat`: tek giriş. Gerekirse kurar, formu açar
- `baslat-arac.bat`: Başlat düğmesinin yapay zeka aracını açtığı küçük yardımcı
- `baslat.command`, `baslat-arac.sh`: aynılarının Mac sürümü
- `kur.bat`: kurulumu elle yeniden yapar
- `form.html`: brief formu
- `talimat/video-edit.md`: yapay zekanın izlediği akış (tek kaynak)
- `.claude/skills/video-edit/SKILL.md`: Claude Code için kısa tanım, akışa yönlendirir
- `AGENTS.md`, `GEMINI.md`, `CLAUDE.md`: Codex, Cursor, Gemini CLI ve Claude Code'un otomatik okuduğu proje kuralları
- `src/`: Remotion katman şablonu (logo, sayaç, arama sahnesi, çerçeve, kart, ekran görüntüsü, yazı)
- `materyaller/video-1/`: örnek klasör yapısı
- `CLAUDE.md`: Claude Code'un bu klasörde izleyeceği genel kurallar

## Başka yapay zeka araçlarıyla
Akış Claude Code ile hazırlandı ve onunla denendi. Aynı klasörde başka bir araç da kullanabilirsin:
- **Codex CLI:** klasörde `codex` yaz. `AGENTS.md` dosyasını kendis
```