Communitygithub.com

Videolu Siteler – Video-Web-Integration

Zeigt einem Agenten, wie „Videolu siteler“ geplant, erstellt oder geschnitten werden, sodass das konkrete Ergebnis ein Plan, ein Briefing oder eine Checkliste ist. Das Vorgehen durchläuft: Videolu siteler, 1. Tasarım görüşmesi, Tasarım yönü: üretilmiş değil, tasarlanmış görünsün. Verwende es, wenn ein neuer Auftrag nach diesem Handwerk verlangt.

Was ist Videolu Siteler – Video-Web-Integration?

Dieser Skill befähigt einen KI-Agenten, Video-Web-Projekte von der Konzeption bis zur Integration in einer statischen Website umzusetzen. Er führt den Agenten durch eine strukturierte Design-Besprechung, in der er den Charakter, den Ort, die Atmosphäre und die Produktionsmethode des Videos festlegt – immer mit einem klaren Fokus darauf, dass das Endergebnis „designed“, nicht nur „produziert“ aussieht. Der Skill beschreibt detailliert die Erstellung von Videos über die flow-video MCP (Anmeldung, Prompting auf Englisch, Produktion in 360p/720p, Fehlerbehandlung) und die anschließende Qualitätskontrolle mit ffprobe/ffmpeg. Außerdem werden die Integration in eine Webseite behandelt (autoplay, Loop, WCAG-Konformität, Scroll-Film-Implementierung) sowie die finale manuelle Prüfung auf Lesbarkeit, Movement-Reduced-Varianten und korrekte Videowiedergabe. Der Skill nutzt ein separates Referenzdokument für gestalterische Grundregeln und vermeidet generische Design-Muster.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cemilcanoz/videolu-siteler/tree/HEAD/skills/videolu-siteler

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Videolu siteler

Amaç: Video sitenin görsel dünyasının parçası olsun; sayfaya bir tanıtım filmi koymak bu işi karşılamaz. Önce sayfa kompozisyonu ve hareket birlikte tasarlanır, sonra o kompozisyon için video üretilir.

Kullanıcı yalnız tasarım kararlarını verir. Üretim, indirme, sıkıştırma, entegrasyon ve kontrolü sen yürütürsün; rutin teknik adımları kullanıcıya devretme.

1. Tasarım görüşmesi

Soruları tek mesajda, numaralı ve seçenekli sor; her sorunun yanında önerdiğin varsayılanı yaz ki kullanıcı "hepsi varsayılan" ya da "2: etkileyici, 5: direkt" diye kısaca cevaplayabilsin. Kullanıcının isteğinde zaten cevaplanmış soruyu atla; konuşma boyunca verdiği tercihi (ör. "deneme istemem") sonraki videolarda tekrar sorma. Soru aracın varsa (seçenekli soru kutusu) onu kullan.

  1. Konu ve amaç — Site ne için, kim ziyaret edecek? (tek cümle yeter)
  2. Videonun karakteri (yaratıcılık düzeyi)
    • Sade: fark edilmeyen, sakin atmosfer (buhar, ışık kayması, hafif yaprak hareketi); metin her zaman önde. Varsayılan.
    • Dengeli: hareket belirgin ama sakin; yavaş kamera kayması, doku ve ışık oyunu.
    • Etkileyici: sinematik; güçlü ışık, belirgin kamera hareketi, dramatik dönüşüm. Metin okunabilirliği için daha fazla karartma/maske gerekir.
  3. Videonun yeri (birden fazla seçilebilir)
    • Yalnız ana bölüm (hero) arka planı. Varsayılan.
    • Bölüm arka planları: ör. hakkımızda, ürün, iletişim bölümlerinin her biri için ayrı sahne.
    • Bölüm geçişleri: kaydırırken bir sahneden diğerine geçen kısa ara videolar.
    • Kart/galeri içi küçük döngüler: ürün veya hizmet kartlarında küçük, sessiz hareketler.
  4. Atmosfer ve palet — ör. sıcak sabah ışığı, karanlık neon, doğal toprak tonları, marka renkleri. Bilmiyorsa konudan sen öner.
  5. Üretim yolu
    • Önce deneme: her sahne önce ucuz 360p kısa deneme, beğenilince son kalite. Güvenli, toplamda biraz daha fazla kredi. Varsayılan.
    • Direkt son kalite: deneme atlanır, doğrudan 720p üretilir. Hızlı; beğenilmezse yeniden üretim tam fiyattır.
  6. Kalite ve yön — 720p (varsayılan) veya 720p'den 1080p yükseltilmiş indirme (abonelik gerekebilir); yatay 16:9 (varsayılan), mobil için ayrıca dikey 9:16 isteniyor mu?
  7. Olmazsa olmazlar — logo, metinler, bölüm listesi, dil, yayın hedefi (yoksa statik site).

Cevaplardan sonra tek kısa plan göster; kullanıcı onaylarsa veya "devam" derse üretime geç:

  • Tasarım fikri (bir paragraf).
  • Sahne listesi: her sahne için yer, kısa tarif, süre, çözünürlük, tahmini kredi.
  • Toplam tahmini kredi ve günlük ücretsiz kotayla (günde 50) karşılaştırma. Toplam kotayı aşıyorsa seçenek sun: sahne sayısını azalt, bazılarını 360p/kısa yap, üretimi günlere yay veya abonelik kredisi kullan.

Tasarım yönü: üretilmiş değil, tasarlanmış görünsün

Ayrıntılı, ölçülebilir kurallar references/tasarim-kurallari.md dosyasında: token planını yazmadan önce bölüm 1–6'yı, kodu yazarken 7–9'u oku; teslimden önce oradaki son kontrol listesini ekran görüntüleriyle uygula. "Zemin kuralları" kullanıcı açıkça aksini istemedikçe esnemez.

Videodan önce sayfanın yönünü belirle; video bu yöne hizmet eder. Kullanıcıya 2–3 yönü palet (4–6 adlandırılmış hex), yazı ailesi, sayfa kurgusu ve video planıyla (sahne sayısı + kredi) sun, birini önerip seçtir. Kullanıcı yön seçtiyse tekrar sorma.

  • Konunun kendi dünyasından başla. Malzemeler, süreç, yer, o işin kendi kelimeleri. Seramik atölyesi için "tüf taşı pembesi, ıslak kil grisi, fırın közü" gibi; "sıcak ve doğal" gibi her işe uyan sıfatlar yön değildir.
  • Videoyu hikâyenin taşıyıcısı yap, dekor değil. En güçlü kurgular:
    • Kaydırma filmi: sayfa bir sürecin anlatısıdır (ham madde → yapım → sonuç); her bölüm bir sahne, video kaydırmayla ilerler. Süreci olan her iş (zanaat, yemek, üretim, yolculuk) için ilk aday.
    • Canlı numune duvarı: ürün/malzeme çeşitleri küçük döngülerle gösterilir (sır, kumaş, kahve çekirdeği).
    • Zaman/yer kurgusu: bölümler günün saatleri veya mekânın yerleri; video ışığı buna göre değişir.
    • Tek atmosfer: yalnız gerçekten sade bir istek için.
  • Tek cesur öğe. Cesaretini bir yere harca (kaydırma filmi, dev bir başlık, bir renk anı); gerisi sakin ve disiplinli kalsın. Vurgu rengini yalnız anlamlı yerde kullan (ör. köz turuncusu yalnız fırın sahnesinde).
  • Kaçınılacak hazır kalıplar (kullanıcı açıkça istemedikçe): krem zemin + iri serif + kiremit/terrakota vurgu; siyah zemin + tek asit yeşili/kırmızı vurgu; birbirinin aynısı yuvarlak kart dizileri ve aynı gri gölge; başlık üstünde büyük harfli, harf aralıklı küçük etiket ("eyebrow"); "A · B · C" gibi noktayla birleştirilmiş meta satırları; bağlantı metnine yapıştırılmış "→"; başlıkta tek kelimeyi italik/renkli yapmak; uydurma istatistik şeridi ("%100 · 1000 °C · 6 çark"), uydurma yorum, logo duvarı; mor-mavi gradyan, kart içinde kart, ikon yerine emoji; her bölüme kayarak giren animasyonlar. Numara (01/02/03) yalnız içerik gerçekten sıralıysa.
  • Yazı: Konuya özgü seçilmiş bir başlık ailesi (her projede aynı fontlara uzanma), en fazla iki aile; satır uzunluğu 45–75 karakter (ideal ~65); gövde ≥16px, satır aralığı 1.5–1.65. Metin cümle düzeninde, sade, son kullanıcının dilinde; düğme ne yapacağını söylesin ("Kursa yazıl", "Gönder" değil).
  • Gerçek olmayan bilgi koyma. Fiyat, telefon, yorum, müşteri sayısı verilmediyse uydurma; örnek alan adı (.example) veya "bize yazın" kullan, örnek site olduğunu altbilgide söyle.
  • Önce plan, sonra sınav. Kodu yazmadan önce kısa bir token planı çıkar (renk, yazı, yerleşim, ilkeler) ve sor: "Bu plan, benzer başka bir site için de aynı çıkar mıydı?" Evetse o kısmı değiştir. Kurarken ekran görüntüsü alıp kendini eleştir; bitirmeden bir süsü çıkar.

Sahne sayısını yerleşime göre belirle: yalnız hero → 1; bölüm arka planları → bölüm başına 1 (en fazla 4–5); geçişler → 3–5 sn kısa klipler; kart döngüleri → 3–4 sn, 360p çoğu zaman yeter (küçük gösterilir).

2. Video üretimi (flow-video MCP)

  1. flow_status çağır. loggedIn=false ise dönen message'ı kullanıcıya aynen söyle (ilk giriş mi, Google'ın ara sıra istediği şifre doğrulaması mı, telefon onayı mı), sonra flow_login çağır: Flow penceresini öne getirir ve kullanıcı bitirene kadar bekler. Şifreyi, kodu veya onayı asla sen girme; Flow sekmesini kendi tarayıcı aracınla açmaya çalışma (oturum yalnız aracın Chrome profilinde var).
  2. İstemi İngilizce yaz; şunları ayrı ayrı tarif et: sahne/özne, kamera, ışık, palet, metin için boş bırakılacak alan (empty left third for headline gibi), hareket, no text, no logos. Seçilen karaktere göre:
    • Sade: static camera, subtle, slow, continuous, loop-friendly motion, düşük kontrast, sakin ışık.
    • Dengeli: slow dolly/pan, belirgin ama yumuşak hareket, ışık ve doku değişimi.
    • Etkileyici: cinematic, dramatic lighting, belirgin kamera hareketi veya dönüşüm (ör. camera pushes through, light sweeps across); yine de metin alanını ve döngüye uygun başlangıç/bitişi iste.
    • Bölüm geçişi: başlangıç karesi önceki bölümün, bitiş karesi sonraki bölümün paletine uysun.
    • Aynı sitedeki sahneler: ortak palet, ışık yönü ve stil cümlesini her istemde tekrarla ki seri tutarlı görünsün.
  3. Üretim yolu kullanıcının seçimine göre:
    • Önce deneme: resolution: "360p", seconds: 4. Sonucu kendin incele (aşağıdaki kontrol); beğenmediğin yeri istemde düzelt. İyiyse aynı istemle 720p ve gereken süre (genelde 8 sn) üret. Kullanıcıya denemeyi göstermen gerekmez; yalnız belirgin bir yön değişikliği gerekiyorsa sor.
    • Direkt son kalite: doğrudan 720p ve planlanan süreyle üret. Sonuç kontrolde açıkça kusurluysa (metin alanı dolu, istenmeyen yazı/logo, yanlış konu) bir kez düzeltilmiş istemle yeniden üret ve bunu kullanıcıya söyle; ikinci üretimin kredisi planı aşıyorsa önce sor.
    • Birden fazla sahne varsa önce hero sahnesini üret ve kontrol et; stil tuttuysa diğerlerini aynı stil cümlesiyle üret.
    • Kaydırma filmi için istemlere "Scene N of a short film about …" diye başla ve mekân, ışık yönü, palet ve kamera cümlesini her sahnede birebir tekrarla; sahneler aynı yerde geçiyormuş gibi görünür. 3–5 sn sahneler yeterli.
  4. Zaman aşımı (TIMEOUT) veya indirme hatası gelirse aynı istemi tekrar üretme: video çoğu zaman Flow'da üretilmiştir, yeniden üretmek krediyi iki kez harcar. Hata mesajındaki proje URL'siyle flow_download çağır (kredi harcamaz); NOT_READY derse biraz bekleyip tekrar dene. Ancak projede video yoksa yeniden üret.
  5. Teslimden sonra her dosyayı ffprobe ile ölç ve kurguyu gerçek süreye göre kur. Araç süreyi Flow'da ayarlayıp doğrular; geçersiz süre istenirse OPTION_UNAVAILABLE döner (aralık genelde 3–15 sn).
  6. outDir her zaman ver (sitenin media/src klasörü; ham dosya orada master olarak kalır); verilmezse dosyalar ajanın o an çalıştığı klasöre iner.
  7. Kredi bilinci: ücretsiz hesaba günde 50 kredi verilir; 720p ≈ 3 kredi/sn, 360p ≈ 1 kredi/sn. maxCredits sınırını aşacaksan kullanıcıya maliyeti söyle, onay al. Günlük kredi bittiyse bunu açıkça söyle; başka ücretli servise sessizce geçme.
  8. Hata kodları: LOGIN_REQUIRED → kullanıcıdan giriş; OVER_BUDGET → onay; GENERATION_FAILED → istemi (genelde gerçek kişi/marka/şiddet içeriğini) yumuşatıp bir kez yeniden dene; TIMEOUT → yukarıdaki 4. madde.

3. Videoyu kontrol et ve web için hazırla

  • ffprobe ile gerçek süre/boyutu ölç; istenen süreyi üretilen süre sanma.
  • Birkaç kare çıkarıp bak (ffmpeg -ss 1 -i in.mp4 -frames:v 1 f1.jpg): metin alanı boş mu, istenmeyen yazı/logo var mı, palet uyuyor mu?
  • Teslim kopyası: sessiz, web için sıkıştırılmış MP4 (H.264, -an -crf 26 -preset slow -movflags +faststart), gerekirse WebM; poster olarak oynatmanın başladığı kare (ilk kare kararmayla başlıyorsa birkaç kare ileriden al); hero videosu yaklaşık 10 sn için ≤2 MB.
  • Döngü: başı ve sonu benzemiyorsa yalnız loop eklemek kusursuz değildir; kısa bir crossfade veya ileri-geri (ping-pong: [0]reverse ile concat) döngüsü yap ya da bunu kullanıcıya söyle.
  • Gömülü siyah şerit: bazı üretimlerde kenarlarda siyah bant olur. ffmpeg -i in.mp4 -vf cropdetect=24:2:0 -f null - ile ölç, crop=…,scale=1280:720 ile temizle.
  • Kaydırmayla sarılacak video sık anahtar kare ister, yoksa geri sararken takılır: -c:v libx264 -crf 26 -g 6 -keyint_min 6 -sc_threshold 0 -an -movflags +faststart. 720p 5 sn sahne bu ayarla yaklaşık 0,5–1,2 MB olur.
  • ffmpeg yoksa kullanıcıya kurulum komutunu öner (Windows: winget install Gyan.FFmpeg, macOS: brew install ffmpeg).

4. Siteye bütünleştir

  • Yazılar, butonlar ve etkileşim web katmanında kalır; video kadrajı onlara yer bırakır. Mobil kadrajı ayrıca düşün (object-position, gerekirse 9:16 ayrı video).
  • <video autoplay muted loop playsinline preload="metadata" poster="..." width height>. Medya hatasında poster görünür kalsın. Hero posterini <link rel="preload" as="image" fetchpriority="high"> ile önden yükle; hero genelde sayfanın en büyük öğesidir (LCP).
  • 5 saniyeden uzun veya döngüdeki her otomatik oynayan videoya herkes için görünür, klavyeyle ulaşılabilen bir durdur/oynat düğmesi koy (WCAG 2.2.2); bu yalnız hareket azaltma kullanıcıları için değildir.
  • Ekran dışında ve gizli sekmede durdur (IntersectionObserver + visibilitychange).
  • prefers-reduced-motion açıksa durağan poster göster ve görünür bir "Hareketi aç" kontrolü sun; bu kontrol hem videoyu hem CSS animasyonlarını yönetsin.
  • Videoyu görünür bir oynatıcı çerçevesine koyma; maske, kırpma ve renk uyumuyla yüzeye yerleştir. Destekleyici CSS/SVG hareketleri amaca hizmet etsin.
  • Hareket bütçesi: sayfada tek odak anı olsun; aynı anda tek video oynar, video bölümünde ayrıca giriş animasyonu veya paralaks olmaz. Kullanıcı birden fazla video yeri seçtiyse bunlar aynı anda değil sırayla görünür olur.
  • Birden fazla video varsa: aynı anda yalnız görünen bölümün videosu oynasın; diğerleri preload="none" ile yüklenmesin, görünür olunca yüklensin. Bölüm geçiş videolarını kaydırmaya bağlayabilirsin (görünür olunca bir kez oynat veya currentTime'ı kaydırma oranına bağla); mobilde ağır geliyorsa poster + kısa CSS geçişine düş. Kart döngüleri küçük ve 360p olsun, yalnız görünürken oynasın.
  • Kaydırma filmi kurulumu: <section class="film"> içinde position: sticky; top: 0; height: 100svh; margin-bottom: -100svh bir sahne (tüm videolar üst üste, yalnız etkin olan görünür) ve ardından her sahne için ~150–160vh yüksekliğinde bir bölüm. Filme overflow: clip ver; yoksa negatif margin yüzünden sahne film bittikten sonra da sonraki bölümün üstünde kalır. Kaydırmada hangi bölümün ekran ortasında olduğunu ve bölüm içi ilerlemeyi hesapla, video.currentTime = ilerleme × süre yap; videoları play() etme. Güncellemeyi requestAnimationFrame ile yap, arka planda durduğu için kısa bir setTimeout yedeği ekle. Hareket kapalıyken (prefers-reduced-motion veya düğme) sahneler ilk karede/posterde durağan kalsın, bölüm değişimi yine çalışsın. Yazılar videoya gömülmez; her bölümün yazısı yapışkan bir başlık + tek cümle olarak web katmanında durur, yalnız yazının durduğu köşe karartılır.
  • Varsayılan teslim: bağımlılıksız statik site (index.html + css + js + media). Kullanıcı bir framework veya yayın hedefi söylediyse onu kullan.

5. Sonuç kontrolü

  • Masaüstü ve mobil genişlikte metin okunabilirliği, kadraj, taşma ve medya yüklenmesi.
  • Videonun gerçekten oynadığını doğrula (currentTime ilerliyor mu); ekran görüntüsü oynatma kanıtı değildir.
  • Hareket azaltma yolunu ve "Hareketi aç" kontrolünü dene.
  • Kullanıcıya: sitenin yolu/bağlantısı, kullanılan kredi, video dosyaları ve bilinen sınırlar (ör. döngü birleşimi). Teknik başarıyı estetik onay yerine koyma; beğenmediği yeri sor.

Sınırlar

  • flow-video, kullanıcının kendi tarayıcı profilindeki Flow arayüzünü otomatikleştirir; Google arayüzü değişirse araç hata verebilir. Bu durumda hatayı açıkça bildir.
  • Kullanıcının Google hesabı yoksa veya yeterli kredisi yoksa akış kesintiye uğrar.
  • Bu skill, yalnızca video-odaklı projeler içindir; salt statik bir site oluşturma veya video içermeyen tasarım çalışmaları kapsam dışıdır.

Verwandte Skills