Communitygithub.com

reels-explainer-video

Instagram Reels / TikTok / YouTube Shorts için 9:16 dikey "nasıl çalışır / yaygın yanılgı" tarzı motion graphics bilgi videosu üretir. Senaryo, HTML animasyon, kelime kelime altyazı, seslendirme metinleri, paylaşım metni ve sesler gelince sesli MP4 (1080×1920). "Reels videosu", "tanıtım videosu", "özelliğimizi anlatan video", "bu tarz video" denince kullan.

What is reels-explainer-video?

reels-explainer-video is a Claude Code agent skill that instagram Reels / TikTok / YouTube Shorts için 9:16 dikey "nasıl çalışır / yaygın yanılgı" tarzı motion graphics bilgi videosu üretir. Senaryo, HTML animasyon, kelime kelime altyazı, seslendirme metinleri, paylaşım metni ve sesler gelince sesli MP4 (1080×1920). "Reels videosu", "tanıtım videosu", "özelliğimizi anlatan video", "bu tarz video" denince kullan.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hsnaydin82/reels-explainer-video/tree/HEAD/reels-explainer-video

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Reels Bilgi Videosu (9:16 Motion Graphics)

Bir ürünü, özelliği veya hizmeti 45–75 saniyelik dikey bir bilgi videosuyla anlatırsın: kanca soru → adımlar → yaygın yanılgı → sonuç → kapanış. Kullanıcı yalnızca konuyu söyler; senaryoyu, animasyonu, altyazıyı, seslendirme metinlerini ve paylaşım metnini sen hazırlarsın. Sesler gelince MP4'ü sen üretirsin.

Bu klasördeki dosyalar:

  • templates/sablon.html — çalışan şablon (5 örnek sahne, animasyon motoru, oynatıcı). Her yeni videoya bundan başla.
  • scripts/peek.py — her sahnenin son karesini alıp tek önizleme görseli yapar (ucuz görsel kontrol).
  • scripts/esitle.py — sahne sürelerini ses dosyalarına göre ayarlar.
  • scripts/render.py — kareleri çekip sesi gömerek MP4 üretir.
  • references/seslendirme.md — seslendirme servisleri (ElevenLabs ve diğerleri), telaffuz ipuçları.

0. Gerekenler (ilk kullanımda kontrol et)

python --version (3.9+), ffmpeg -version, python -c "import playwright". Eksik varsa kullanıcıya ne olduğunu, neden gerektiğini söyle ve kurulum için onay iste; onaysız paket kurma:

  • Playwright (Microsoft, Apache-2.0): pip install playwright ve python -m playwright install chromium. Kareleri yerel tarayıcıda çeker.
  • FFmpeg (LGPL/GPL): görüntü ve sesi MP4'te birleştirir. https://ffmpeg.org Şablon fontları Google Fonts'tan yükler; render sırasında internet gerekir (yalnızca font dosyaları indirilir).

1. Marka bilgisi (ilk videoda bir kez sor)

Konu belli ama marka bilgisi yoksa tek mesajda sor, sonra başla:

  1. Marka adı (üst barda ve kapanışta; iki parça renkli gösterilebilir: "Marka Adı")
  2. Logo (SVG tercih; yoksa ana renkte basit bir harf/ikon kullan ve bunu söyle)
  3. Ana renk ve vurgu rengi (hex). Verilmezse şablondaki mavi + turuncu kalsın.
  4. Kapanış: alan adı, çağrı düğmesi metni (ör. "14 gün ücretsiz dene"), slogan
  5. Hedef kitle ve dil (varsayılan Türkçe)

Markayı yazarken kullanıcının yazımına birebir uy (büyük/küçük harf, bitişik/ayrı). Bilgileri sonraki videolar için hatırla (kullanıcının proje notları veya hafıza dosyası varsa oraya yaz).

2. Senaryo

  • 6–10 sahne, sahne başı 6–9 sn, toplam 45–75 sn.
  • Yapı: kanca (izleyicinin tanıdığı bir sorun, soru biçiminde) → adımlar (1, 2, 3…) → bir YAYGIN YANILGI sahnesi (kırmızı "YANLIŞ" damgası + "?") → sonuç → kapanış (logo, marka, slogan, CTA, alan adı).
  • Her sahnede: chip etiketi (ör. "2 · ETİKET"), 2 satırlık büyük başlık (2. satır vurgu renginde, satır başı ≤ 16 karakter), bir görsel (kart, form, liste, sayaç, telefon bildirimi…) ve tek cümlelik altyazı.
  • Altyazı = seslendirme metni. Cümle başı ≤ ~18 kelime. Vurgulanacak 1–2 kelimeyi *yıldız* içine al.
  • Örneklerde bir hikâye ve karakter kullan (aynı müşteri, aynı plaka/ürün, tutarlı tarihler ve sayılar). Zaman sırasını kontrol et: sahneler arasında mevsim, tarih, tutar çelişmesin.
  • Teknik iç detay yazma (veritabanı, dil, sunucu); kullanıcının diliyle anlat. Uydurma özellik yazma: emin olmadığın her ürün iddiasını kullanıcıya doğrulat ve teslimde listele. Örnek sayıları sahnede "örnek" diye belirt.

3. Animasyonu yaz

templates/sablon.html'i kopyala (ör. videolar/<konu>/<konu>.html), :root renklerini, logo symbol'ünü, üst bar ve kapanış metinlerini değiştir, sahneleri yeniden yaz. Kurallar:

  • Kare 540×960 tasarlanır; render'da 2× ölçekle 1080×1920 olur.
  • Sahne: <section class="scene" data-dur="7" data-alen="" data-sub="... *vurgu* ...">. data-alen boş kalır; esitle.py doldurur.
  • Yerleşim: chip top:96, başlık top:142, görsel alan .vis top:300 yükseklik ~450, altyazı altta. Görsel altyazıya taşmasın.
  • Animasyon: elemana class="a" ve style="--an:pop;--d:1.2s" (isteğe bağlı --du). Hazır: rise, pop, fade, drop, slideL, slideR, stamp, typeit (.yaz), tapk (.tap dokunuş halkası), grow (--w ile çubuk dolumu).
  • Sayaç: <span data-from="0" data-count="68" data-cd=".6" data-cdur="1.8" data-dec="0" data-suf=" gün">0</span>.
  • Başlık 1. satırın görünmesi --d:.1s, 2. satır --d:.25s; görsel öğeleri altyazının anlattığı sırayla 0,5–5 sn arasına yay.

Bilinen tuzaklar

  • .a ile kullanılan her keyframe opacity:1 içermeli. Yalnızca transform değiştiren keyframe elemanı görünmez bırakır.
  • Sınıf adı çakışması: tüm sahneler tek CSS'i paylaşır. Yeni öğelere sahneye özgü önek ver (.s4-bar, .lo-raf); .rk, .sn, .tab gibi kısa adlar başka bir sahnenin stiliyle çakışıp yerleşimi bozar.
  • Yazı yazma efekti clip-path ile yapılır (.yaz); width:Nch son karakterleri keser.
  • Uzun kod/numaralarda overflow-wrap:anywhere; word-break:break-all kelimeleri ortadan böler.
  • Şablonun sonundaki fit();go(0);requestAnimationFrame(loop); satırını değiştirme; render betikleri onu arar.

4. Görsel kontrol (ucuz)

Tam render yapma. python scripts/peek.py <video.html> her sahnenin sonundan bir kare alır ve onizleme.jpg üretir. Görsele bir kez bak: taşma, üst üste binme, görünmeyen öğe, kırılan satır, marka yazımı. Sorun varsa düzelt ve tekrar çalıştır. Konsol hatası basılırsa çöz. (Kullanıcının tarayıcıda açabileceği bir sayfa paylaşma imkânın varsa HTML'i oynatıcı olarak da sunabilirsin.)

5. Seslendirme metinlerini ver ve DUR

Teslim et: sahne sırasıyla altyazı metinleri, TTS için telaffuzlu hâlleri (yalnızca değişen satırlar; bkz. references/seslendirme.md), paylaşım metni ve kapak yazısı. Kullanıcıdan ses-01.mp3 … ses-NN.mp3 iste (her cümle ayrı dosya, video HTML'iyle aynı klasöre).

Ses dosyaları gelmeden MP4 üretme. Sessiz taslak MP4 zaman ve kaynak harcar; yalnızca kullanıcı açıkça isterse render.py video.html - cikti.mp4 ile üret.

6. Sesler gelince: tek seferde sesli MP4

Kullanıcıya ara onay sormadan sırayla çalıştır:

python scripts/esitle.py video.html <ses_klasoru>      # süreler: max(mevcut, 0.3 + ses + 0.5)
python scripts/peek.py video.html                      # hızlı son kontrol
python scripts/render.py video.html <ses_klasoru> <cikti.mp4> [muzik.mp3]

~70 sn video için kare çekimi birkaç dakika sürer; komutu arka planda veya uzun zaman aşımıyla çalıştır. Çıktı: 1080×1920, 30 fps, H.264 yuv420p, AAC 192k, +faststart. Bittiğinde ffprobe ile süreyi ve çözünürlüğü doğrula, birkaç kare alıp altyazı senkronuna bak, dosya yolunu ve boyutunu bildir. Müzik verilirse seslendirmenin altına ~-18 dB'de girer ve son 1,5 sn'de kısılır.

7. Paylaşım metni

Tüm platformlar için tek metin: kanca cümle, ✅ maddeli 3–5 satır özet, CTA + alan adı, 3–5 hashtag (kullanıcı farklı sayı isterse ona uy). Ayrıca bir Reels kapak yazısı öner (≤ 6 kelime, genelde kanca başlığı).

Teslim özeti

  • İlk tur: video HTML'i (yol veya bağlantı), doğrulanması gereken ürün iddiaları, seslendirme metinleri (orijinal + telaffuzlu), paylaşım metni, kapak yazısı, ses dosyası isteği. MP4 yok.
  • İkinci tur: sesli MP4 + tek satır bağlam (süre, boyut). Adım adım süreç anlatma.

Related Skills