deha-video
Bir projeyi, modülü, özelliği ya da işi kod tabanından doğrulayıp seslendirmeli tanıtım/anlatım videosuna (HTML animasyon → gerçek MP4) çevirir; Google AI Studio (Gemini TTS) anahtarını saklar ve kullanır. Kullanıcı "video yap", "tanıtım videosu", "bunu videolaştır", "reels/shorts/dikey video", "modül tanıtımı", "seslendirmeli video", "/deha-video" dediğinde ya da var olan bir deha-video filmini revize ettirmek (ses değiştir, metni düzelt, yeniden render) istediğinde kullan. Başlamadan önce süre, ekran oranı, üretim modeli ve ses gibi seçimleri kullanıcıya sorar.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/dehasoft-tr--deha-video)HTML
<a href="/listings/dehasoft-tr--deha-video"><img src="/api/listings/dehasoft-tr--deha-video/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 145 lines
- ---
- name: deha-video
- description: Bir projeyi, modülü, özelliği ya da işi kod tabanından doğrulayıp seslendirmeli tanıtım/anlatım videosuna (HTML animasyon → gerçek MP4) çevirir; Google AI Studio (Gemini TTS) anahtarını saklar ve kullanır. Kullanıcı "video yap", "tanıtım videosu", "bunu videolaştır", "reels/shorts/dikey video", "modül tanıtımı", "seslendirmeli video", "/deha-video" dediğinde ya da var olan bir deha-video filmini revize ettirmek (ses değiştir, metni düzelt, yeniden render) istediğinde kullan. Başlamadan önce süre, ekran oranı, üretim modeli ve ses gibi seçimleri kullanıcıya sorar.
- ---
- # deha-video — projeyi doğrula, videoya çevir
- Bu skill tek bir işi yapar: gerçek bir ürünün ya da işin **gerçekten var olan** yanlarını bulur, teknik olmayan izleyiciye
- fayda diliyle anlatan bir film yazar, filmi zamanın saf fonksiyonu olan bir HTML animasyonu olarak kurar, yapay zekâ
- sesiyle seslendirir ve kare kare gerçek bir MP4'e çevirir. Skill klasörü: `~/.claude/skills/deha-video/`.
- - `scripts/anahtar.sh` — API anahtarı (durum / kaydet / test)
- - `scripts/yeni-film.sh` — şablondan film klasörü kurar (oran, fps)
- - `template/` — çalışan iskelet: `tools/` (seslendirme, render, miks, doğrulama), `js/engine.js`, `js/player.js`,
- `js/kit.js` (hazır sahne parçaları: telefon, panel, liste, kontrol listesi, sayaç, halka, grafik), yazı tipleri, CC0 ses efektleri
- - `gorunumler/` — sekiz renk ön ayarı (gece, kum, orman, yakut, kagit, neon, nane, seker)
- - `senaryolar/` — altı anlatım iskeleti (lansman-30sn, modul-tanitimi-60sn, once-sonra-60sn, surum-notlari-45sn, nasil-yapilir-90sn, urun-tanitimi-3dk)
- - `references/brief.md` — üretim ajanına verilecek ortak yönerge (ajan bunu okur)
- - `references/dersler.md` — ses modelleri, kotalar, sesler, sık yapılan hatalar
- ## 0. Anahtar
- `~/.claude/skills/deha-video/scripts/anahtar.sh durum` çalıştır. Anahtar skill klasöründe DEĞİL,
- `~/.config/deha-video/gemini.key` dosyasında (izin 600) durur; araçlar onu oradan kendileri okur.
- - Yoksa ya da `anahtar.sh test` hata veriyorsa kullanıcıdan Google AI Studio anahtarını iste ve
- `printf '%s' '<anahtar>' | ~/.claude/skills/deha-video/scripts/anahtar.sh kaydet` ile kaydet.
- - Anahtarı hiçbir zaman ekrana yazdırma, film klasörüne, betiklere, loglara, CREDITS dosyasına ya da gite koyma.
- Ajanlara anahtarın kendisini değil, "araçlar anahtarı kendileri okur" bilgisini ver.
- - Kullanıcı seslendirme istemiyorsa anahtar gerekmez.
- ## 1. Sor (AskUserQuestion)
- Kullanıcının mesajında zaten yanıtı olan soruyu sorma. Kalanları **tek** AskUserQuestion çağrısında sor (en çok dört soru);
- gerekiyorsa ikinci bir çağrıyla devam et. Önerdiğin seçeneği başa koy.
- Birinci çağrı:
- | Soru | Seçenekler |
- |---|---|
- | Süre | 30 sn · 60 sn · 2–3 dk · 5 dk (başka süre "Other" ile) |
- | Ekran | 9:16 dikey (Reels/Shorts) · 16:9 yatay · 1:1 kare · 4:5 |
- | Üretim modeli | Sonnet 5.5 (önerilen: hız/kalite dengesi) · Fable 5.2 (en yetenekli, pahalı) · Opus 5.5 · Haiku 5.5 (hızlı, kalite düşer, sıkı denetim ister) |
- | Ses | Kadın · Erkek · Seslendirme yok (yalnız yazı ve efekt) |
- İkinci çağrı (yalnız belirsizse):
- | Soru | Seçenekler |
- |---|---|
- | Konu | Kullanıcı konu vermediyse: kodu hızlıca tarayıp 3–4 somut konu öner (her biri bir video). Birden çok seçilebilir. |
- | Görünüm | Ajan seçsin (önerilen) · Marka renkleriyle · Koyu ve sinematik (gece, orman, yakut, neon) · Aydınlık ve canlı (kum, kagit, nane, seker) |
- | Film türü | Modül/özellik tanıtımı · Lansman/duyuru · Önce–sonra · Nasıl yapılır · Sürüm notları (senaryo iskeletini belirler) |
- | Dil | Türkçe · İngilizce |
- | Müzik/efekt | Yalnız ses efekti (önerilen) · Efekt yok · Kullanıcının vereceği müzik dosyası |
- Sormadan varsay ve yanıtta belirt: 30 fps; çıktı klasörü projenin YANINDA `<proje>-video/<film-adi>/` (commit zorunluluğu
- olan depoların içine yazma; kullanıcı başka yer derse oraya); seslendirme modeli sırası `references/dersler.md`'deki gibi.
- Kelime bütçesi: Türkçe anlatım yaklaşık 13–14 karakter/sn akar. 30 sn ≈ 45–50 kelime, 60 sn ≈ 90–100, 3 dk ≈ 280–300,
- 5 dk ≈ 470–500. Bölüm sayısı: 30 sn 3–4, 60 sn 6–7, daha uzun filmde her 12–18 saniyeye bir bölüm.
- ## 2. Kur
- Her film için:
- ```
- ~/.claude/skills/deha-video/scripts/yeni-film.sh "<hedef klasör>" <9:16|16:9|1:1|4:5|ENxBOY> \
- --baslik "<başlık>" --gorunum <ad> --senaryo <ad> [--fps 30]
- ~/.claude/skills/deha-video/scripts/yeni-film.sh --liste # görünümler ve senaryolar, açıklamalarıyla
- ```
- Betik şablonu kopyalar, boyutu ve seçilen görünümü (`css/gorunum.css`) yazar, senaryo iskeletini `tools/narration.json`
- olarak koyar, `npm install`'ı film klasörünün içinde çalıştırır ve taslak bir çizelge üretir; kurulumdan hemen sonra
- `node tools/still.mjs out/s --beats` çalışır durumdadır. `npm`'i asla başka bir klasörde çalıştırma.
- Görünüm bir başlangıç paletidir, zorunluluk değil: ajan renkleri filme göre değiştirebilir. Bir seride her filme farklı
- görünüm ver. Senaryo iskeletindeki köşeli parantezli satırlar yer tutucudur; ajan hepsini gerçek metinle değiştirir.
- ## 3. Ürettir
- Her film için bir üretim ajanı başlat (Agent aracı, `model`: kullanıcının seçtiği `sonnet` / `fable` / `opus` / `haiku`).
- Birden çok film birbirinden bağımsızdır: hepsini aynı mesajda başlat. Ajan görev metni kısa olur; ortak kurallar
- `references/brief.md`'dedir ve ajan onu okur. Görev metninde şunlar bulunur:
- 1. "Önce `~/.claude/skills/deha-video/references/brief.md` dosyasını oku ve tamamen uy."
- 2. Film klasörü (kurulmuş), konu ve izleyicinin sorusu ("... nasıl yaparım?").
- 3. Kaynaklar: hangi depolar/klasörler okunacak; varsa önceden yapılmış özellik envanteri.
- 4. Kullanıcının seçimleri: süre ve kelime bütçesi, oran, dil, ses (ad), seslendirme modeli sırası, efekt/müzik.
- 5. Görünüm: palet ve "yinelenen sahne" fikri. Seride her filme FARKLI bir görünüm ver; aynı görünümü iki kez verme.
- 6. Kullanıcının kendi beyanıyla gelen iddialar (kodda yoksa bile kullanılacaksa) ve yasaklar.
- Aynı anda birkaç ajan çalışacaksa: her birine farklı seslendirme modeli sırası ver (günlük kotalar küçük ve ortaktır) ve
- render için en çok 3 işçi kullanmalarını söyle. Haiku ile üretimde ajan sık sık yarıda bırakır: eksik adımı kendin tamamla.
- Ajanın işi beş adımdır ve sırası değişmez: (1) kodu oku, doğrulananları ve "iddia edilmeyecekler"i `OZELLIKLER.md`'ye yaz;
- (2) anlatım metnini yaz ve seslendir, her klibi yazıya döküp metinle karşılaştır; (3) sahneleri gerçek klip sürelerine
- bağlı kur; (4) kare kare bakıp düzelt; (5) render, miks, doğrulama.
- ## 4. Kendin doğrula
- Ajanın raporu kanıt değildir. Her film için:
- ```
- cd "<film klasörü>" && node tools/kontrol.mjs
- ```
- Bu, kodek/boyut/fps/süre/ses/siyah kare denetimini yapar ve `out/kontrol-a.jpg`, `out/kontrol-b.jpg` şeritlerini üretir.
- **Şeritleri Read ile aç ve bak.** Aradıkların: yarım kesilmiş başlık, boş alt bölüm, üst üste binen yazı, boş kart,
- sıfırda kalmış sayaç, okunmayacak kadar küçük etiket, yanlış Türkçe harf. Ayrıca film klasöründe anahtar dizgisini ara
- (olmamalı) ve `OZELLIKLER.md`'deki "iddia edilmeyecekler" ile anlatımı karşılaştır.
- ## 5. Sun
- Kullanıcıya her film için: MP4'ün tam yolu, süre ve boyut; bölüm bölüm içerik (süre + ne anlatıyor); **kod araştırmasının
- filme almadığı ya da düzelttiği iddialar**; gördüğün pürüzler; ses modeli ve ses adı. Açıkça söyle: sesi dinleyemezsin,
- hareketi izleyemezsin; telaffuz ve tempo kullanıcının kulağına kalır. Kanıtlamadığın şeyi "hazır" diye sunma.
- ## Revizyon
- Film klasöründe, yeniden ajan başlatmadan:
- | İstek | Komut |
- |---|---|
- | Sesi değiştir | `node tools/revoice.mjs --voice <ad>` (gerekirse `--model <ad>`) |
- | Tek cümleyi değiştir | `tools/narration.json`'da metni düzelt → `node tools/tts.mjs --only c03 --force` → `node tools/transcribe.mjs` → `node tools/build-vo.mjs` → `node tools/render.mjs` → `node tools/mix.mjs` |
- | Yalnız görsel düzeltme | `js/`/`css/` düzelt → `node tools/still.mjs out/s <sn> ...` ile bak → `node tools/render.mjs` → `node tools/mix.mjs` |
- | Müzik ekle | `node tools/mix.mjs --music <dosya> --music-gain 0.12` |
- | Erişilen ses modelleri | `node tools/modeller.mjs` |
- Metin değişince klip süreleri, dolayısıyla bütün çizelge kayar; sahneler kliplere bağlı kurulduğu için kendiliğinden uyar.
- Büyük görsel değişiklikte (yeni sahne, yeni görünüm) filmi yapan ajana SendMessage ile devam ettir ya da yeni ajan başlat.
- ## Değişmez kurallar
- - **Uydurma yok.** Kodda karşılığı olmayan özellik, sayı, yüzde, hız, müşteri sayısı, üstünlük iddiası ("en …"),
- rakip karşılaştırması filme girmez. Kullanıcının kendi beyanı kullanılabilir, ama `OZELLIKLER.md`'de "kullanıcı beyanı"
- diye işaretlenir ve kullanıcıya kodda bulunamadığı söylenir.
- - **Fayda dili.** İzleyici teknik değildir: API, sunucu, veritabanı, framework adı ekranda ve seste geçmez.
- - **Gizlilik.** `.env` açılmaz; gerçek müşteri/kişi verisi, şifre, anahtar hiçbir çıktıya girmez; ekranlar kurgusal
- veriyle çizilir ("Bayi A", "Örnek Ürün").
- - **Belirlenimcilik.** Her kare zamanın saf fonksiyonudur: `Date.now()`, kare başına `Math.random()`, önceki kareye
- bağımlılık yok. `window.seek(t)` ve `window.renderAt(t)` vardır.
- - **Gerçek MP4.** H.264 + yuv420p + AAC; WebM'i yeniden adlandırmak yok. Üretilemediyse bunu açıkça söyle.
- - **Tek ses, tek model.** Bir filmin bütün klipleri aynı model ve aynı sesle üretilir; kota biterse hepsi yeni modelle
- baştan üretilir. Eksik anlatımla final render alınmaz.
README.md · README · 165 lines
- # deha-video
- Bir projeyi, modülü ya da özelliği **kodundan doğrulayıp** seslendirmeli tanıtım videosuna çeviren Claude Code skill'i.
- Çıktı gerçek bir MP4'tür (H.264 + AAC); görüntü bir HTML animasyonundan kare kare alınır, ses Google Gemini ile üretilir.
- Dehasoft'ta e-ticaret altyapısının tanıtım filmlerini (uzun tanıtım, 60 saniyelik lansman, BayiGöz, Hakediş, Teklif,
- Kasa Arkası gibi modüllerin dikey videoları) üretirken kurulan yöntemin paketlenmiş hâlidir.
- ## Ne yapar
- 1. **Sorar.** Süre, ekran oranı, üretim modeli, ses; gerekirse konu, görünüm, film türü.
- 2. **Doğrular.** Üretim ajanı konunun kodunu okur; gerçekten çalışanları ve *iddia edilmeyecekleri* `OZELLIKLER.md`'ye yazar.
- 3. **Yazar ve seslendirir.** Teknik olmayan izleyiciye fayda diliyle anlatım; her ses klibi yazıya dökülüp metinle karşılaştırılır.
- 4. **Kurar.** Sahneler ses kliplerinin gerçek süresine bağlı kurulur: ses ya da metin değişince film kendiliğinden kayar.
- 5. **Render eder.** Başlıksız Chromium her kareyi alır, FFmpeg MP4'e çevirir, ses −16 LUFS'e karıştırılır.
- 6. **Denetler.** Kodek, boyut, süre, ses, siyah kare taraması ve göz kontrolü için kare şeritleri.
- ## Kurulum
- ```bash
- git clone https://github.com/dehasoft-tr/deha-video.git
- cd deha-video && ./kur.sh
- ```
- `kur.sh` depoyu `~/.claude/skills/deha-video` olarak bağlar ve gereksinimleri denetler:
- | Gereksinim | Kurulum |
- |---|---|
- | Node.js 20+ | [nodejs.org](https://nodejs.org) ya da `nvm` |
- | FFmpeg | `brew install ffmpeg` |
- | Playwright Chromium | `npx playwright install chromium` |
- | Google AI Studio anahtarı | yalnız seslendirme için; aşağıya bakın |
- macOS üzerinde geliştirildi ve denendi.
- ### API anahtarı
- Anahtar **depoda durmaz**. Her kullanıcı kendi anahtarını kendi makinesine kaydeder:
- ```bash
- pbpaste | ~/.claude/skills/deha-video/scripts/anahtar.sh kaydet # panodaki anahtarı kaydeder
- ~/.claude/skills/deha-video/scripts/anahtar.sh test # çalışıyor mu, hangi ses modelleri var
- ```
- Anahtar `~/.config/deha-video/gemini.key` dosyasına, yalnız sahibinin okuyabileceği izinle yazılır. Araçlar oradan okur;
- film klasörlerine, loglara ya da gite yazılmaz. Anahtarı [aistudio.google.com](https://aistudio.google.com) üzerinden alabilirsiniz.
- ## Kullanım
- Claude Code'da, videosunu istediğiniz projenin klasöründe:
- ```
- /deha-video
- ```
- ya da doğrudan söyleyin: *"Hakediş modülü için 60 saniyelik dikey tanıtım videosu yap."* Skill eksik kalan seçimleri sorar:
- | Soru | Seçenekler |
- |---|---|
- | Süre | 30 sn · 60 sn · 2–3 dk · 5 dk |
- | Ekran | 9:16 dikey · 16:9 yatay · 1:1 kare · 4:5 |
- | Üretim modeli | Sonnet · Fable · Opus · Haiku |
- | Ses | Kadın · Erkek · Seslendirme yok |
- Film, projenin yanında `<proje>-video/<film-adi>/` klasörüne üretilir; bitmiş video `out/final.mp4`'tür.
- `index.html` tarayıcıda açılınca aynı film oynatıcıyla izlenir.
- ### Sonradan değiştirmek
- Film klasöründe:
- ```bash
- node tools/revoice.mjs --voice tr-tr-storyteller-1 # sesi değiştir, yeniden render et
- node tools/tts.mjs --only c03 --force # tek cümleyi yeniden seslendir (metni narration.json'da düzelttikten sonra)
- node tools/build-vo.mjs && node tools/render.mjs && node tools/mix.mjs
- node tools/mix.mjs --music muzik.mp3 --music-gain 0.12 # müzik ekle
- node tools/kontrol.mjs # MP4'ü denetle, kare şeritlerini üret
- ```
- ## Şablonlar
- ```bash
- scripts/yeni-film.sh --liste
- scripts/yeni-film.sh ../proje-video/hakedis 9:16 --gorunum yakut --senaryo modul-tanitimi-60sn --baslik "Hakediş"
- ```
- ### Görünümler (`gorunumler/`)
- | Ad | Karakter | Uygun olduğu konu |
- |---|---|---|
- | `gece` | Koyu lacivert, kehribar vurgu | Kurumsal, sinematik |
- | `kum` | Sıcak açık zemin, mercan vurgu | Mobil uygulama, samimi |
- | `orman` | Koyu yeşil, limon vurgu | Saha, harita, denetim |
- | `yakut` | Bordo, altın vurgu | Ödül, kampanya, premium |
- | `kagit` | Açık gri-mavi, lacivert ve turuncu | Belge, teklif, sözleşme |
- | `neon` | Siyaha yakın, pembe ve camgöbeği | Veri, analiz, rapor |
- | `nane` | Ferah yeşil-beyaz, kırmızı vurgu | Sepet, kasa, perakende |
- | `seker` | Parlak pembe-turkuaz, sarı başlık | Oyunbaz, sosyal medya |
- Görünüm bir başlangıç paletidir; üretim ajanı filme göre uyarlar. Yeni görünüm eklemek için aynı on bir CSS değişkenini
- tanımlayan bir dosya koymak yeterlidir.
- ### Senaryolar (`senaryolar/`)
- | Ad | Süre | Yapı |
- |---|---|---|
- | `lansman-30sn` | 30 sn | Kanca, üç vuruş, kapanış |
- | `surum-notlari-45sn` | 45 sn | Yeni sürüm, üç yenilik, nasıl alınır |
- | `modul-tanitimi-60sn` | 60 sn | Sorun, çözüm, üç yetenek, yönetici kazancı, kapanış |
- | `once-sonra-60sn` | 60 sn | Eski düzen, dönüşüm, yeni düzen, kazanç |
- | `nasil-yapilir-90sn` | 90 sn | Giriş, dört adım, sonuç |
- | `urun-tanitimi-3dk` | 2,5–3 dk | Sorun, tek merkez, yetenekler (soru–çözüm–kazanç), final |
- Senaryolar anlatım iskeletidir: bölüm adları, cümle başına ton yönlendirmesi ve yer tutucu metin içerir.
- ### Hazır sahne parçaları (`template/js/kit.js`)
- Telefon, panel, satır listesi, kontrol listesi, sayı kutusu, ilerleme çubuğu, puan halkası, çubuk grafik, etiket ve
- dokunma halkası. Hepsi tek bir ilerleme değerinden (0–1) çizilir, bu yüzden kare kare render ile uyumludur.
- Kullanımı `references/brief.md` içinde ve başlangıç filminde (`template/js/film.js`) gösterilir.
- ## Klasör yapısı
- ```
- SKILL.md skill tanımı: soru akışı, üretim adımları, kurallar
- kur.sh kurulum ve gereksinim denetimi
- scripts/
- anahtar.sh API anahtarı: durum | kaydet | test
- yeni-film.sh şablondan film klasörü kurar
- references/
- brief.md üretim ajanının yönergesi
- dersler.md ses modelleri, kotalar, sesler, sık görülen kusurlar
- gorunumler/ renk ön ayarları
- senaryolar/ anlatım iskeletleri
- template/ film iskeleti
- tools/ tts, transcribe, build-vo, render, mix, kontrol, revoice, still, modeller, taslak-timeline
- js/ engine (zaman motoru), kit (parçalar), film (başlangıç filmi), player (oynatıcı)
- css/ assets/ stiller, yazı tipleri, ses efektleri, logo
- ```
- ## Kurallar
- - **Uydurma yok.** Kodda karşılığı olmayan özellik, sayı, yüzde, hız, müşteri sayısı, üstünlük iddiası ve rakip
- karşılaştırması filme girmez. Araştırma çoğu zaman ilk fikri düzeltir; skill bunu size bildirir.
- - **Fayda dili.** İzleyici teknik değildir; API, sunucu, framework adı geçmez.
- - **Gizlilik.** `.env` açılmaz; gerçek müşteri verisi, şifre ya da anahtar hiçbir çıktıya girmez; ekranlar kurgusal veriyle çizilir.
- - **Tek ses, tek model.** Bir filmin bütün klipleri aynı ses ve aynı modelle üretilir.
- - **Dürüst teslim.** Skill sesi dinleyemez ve hareketi izleyemez; telaffuz ve tempo için son söz izleyen kişidedir.
- ## Bilinen sınırlar
- - **Ses kotası.** Gemini seslendirme modellerinin günlük istek sınırı küçüktür (en iyi modelde ücretli ilk katmanda günde
- 100 istek); 60 saniyelik bir film 12–15 istek harcar. Kota dolunca skill sıradaki modele geçer.
- - **Marka adları** ses modelinde sık yanlış okunur; skill her klibi yazıya döküp denetler, yine de dinleyerek doğrulayın.
- - **macOS varsayımı.** FFmpeg yolu ve Chromium bulma mantığı macOS'a göredir; `FFMPEG`, `FFPROBE`, `CHROME_PATH` ortam
- değişkenleriyle değiştirilebilir.
- ## İçerik kaynakları
- - Yazı tipleri: Inter, Instrument Serif (SIL Open Font License 1.1)
- - Ses efektleri: Freesound, CC0 1.0 — whoosh (Kinoton #351256), sweep (moogy73 #425700), ping (arseniiv #614833),
- shimmer (adh.dreaming #632344), impact (tgerginov #665093), drop (paespedro #174718)
- - Seslendirme: Google Gemini TTS (yapay zekâ sesi)
- Dehasoft iç kullanımı içindir.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.