Flow'larla çalışmak için agent skill

Flow-generator skill, bir yapay zeka kodlama aracının terminalden flow’larınızı oluşturmasına ve düzenlemesine olanak tanır. Ne oluşturmak veya değiştirmek istediğinizi sade bir dille söyleyin; araç, flow’un builder config’ini Adapty CLI aracılığıyla okur, yeniden yazar, bir önizleme oluşturur ve siz onayladıktan sonra taslak olarak kaydeder.

Bir skill, yapay zeka aracınızın ihtiyaç duyduğunda yüklediği bir dizi talimattır. Bu skill, flow config’in hata yapmaya en müsait kısımlarını kapsar: hangi düzenlemelerin yayını durdurduğunu, bir ekranı sildiğinizde hangi referansların bozulduğunu ve işlenmiş bir önizlemenin neyi kanıtlayıp neyi kanıtlayamayacağını.

Başlamadan önce

• Becerileri destekleyen bir AI kodlama aracı: Claude Code, GitHub Copilot CLI, OpenAI Codex ve Gemini CLI hepsinde çalışır.
• Adapty kataloğunuzdaki ürünler: Beceri, satış ekranı tasarlamadan önce ürünlerinizi listeler ve hangilerinin ekrana ekleneceğini sorar. Uygun ürün yoksa, sağladığınız mağaza ürün ID’lerinden yenisini oluşturabilir; bunu yapmadan önce onay ister.

Bununla neler yapabilirsiniz

Sıfırdan bir flow oluşturma

• Bir açıklamadan: “Fitness uygulamam için bir paywall, iki plan, yıllık önceden seçili.” Skill kompozisyonu seçer, doğrulanmış render pattern’lerinden oluşturur — tab’lar, plan kartları, toggle’lar, geri sayımlar, progress bar’lar, bottom sheet’ler — ve katalogınuzdan seçtiğiniz ürünleri kullanır.
• Bir ekran görüntüsünden veya tasarımdan: Bir referans verin, düzeni, renkleri, tipografiyi ve ikon stilini eşleştirir, ardından kapatamadığı her farkı size bildirir. Referans, rakibinizin paywallı, kendi ekranlarınızdan biri veya tasarım aracınızdaki bir frame olabilir. AI aracınız MCP üzerinden o tasarım aracına bağlıysa, frame’i doğrudan okur — kimsenin ekran görüntüsü dışa aktarması ya da tasarımı kelimelerle yeniden tanımlaması gerekmez.
• Dönüştüren kriterlere göre değerlendirilmiş: Size bir tasarım vermediğinizde, skill oluşturduğu ekran üzerinde Adapty’nin paywall-teardown kütüphanesini çalıştırır ve en yüksek sıralamayı alanları siz görmeden önce düzeltir. Kategorinizde satan pattern’lere göre oluşturulmuş bir ekran elde edersiniz, genel bir düzen değil.

Mevcut bir flow’u değiştirme

• Yeni pazarlara yerelleştirme: Bir yerel ayar ekler ve tüm yerelleştirilebilir alanları doldurur — başlıklar, buton etiketleri, plan açıklamaları, görsel alanları ve giriş yer tutucuları. Tek bir çalışan paywall’ı on farklı dile taşımanın en hızlı yolu budur.
• Tüm yerel ayarlarda metni aynı anda yeniden yazma: Yapıya dokunmadan ifadeleri değiştirir; fiyat değişkenlerini değil, bunların etrafındaki metni düzenler — böylece fiyatlar doğru çözümlenmeye devam eder.
• Flow yapısını yeniden düzenleme: Ekranları ekler, kaldırır ve yeniden sıralar; ardından bu değişikliğin bozduğu navigasyonu onarır ve erişilemeyen ekranları raporlar.
• Soru dizileri ve dallanma ekleme: Seçilebilir gruplar, seçenek ID’leri ve her yanıtı kendi ekranına yönlendiren koşullu aksiyonlar oluşturur — onboarding’i nitelikli bir paywall ziyaretine dönüştüren kişiselleştirme adımı budur.
• Test için varyantlar oluşturma: Mevcut çalışan bir flow’dan türetilmiş yeni bir flow oluşturur, ardından test etmek istediğiniz değişikliği uygular. Tema, fontlar, yerel ayarlar ve ürünler aktarılır; varyant yalnızca kasıtlı olarak farklılaştırdığınız yerde ayrışır.
• Bir sezon veya kampanya için yeniden tasarım: Referans bir görselden renkler örnekler ve her ekranı tek tek yeniden stillendirmek yerine yeni bir temayı tüm flow’a uygular.

Ne üretir

Plan zaman çizelgeli bir paywall

İki plan kartının üzerinde numaralı bir zaman çizelgesi. Cihazda render edildiğinden mağaza fiyatları çözümlemiştir — Adapty’nin yıllık plan için hesapladığı aylık fiyat dahil.

Tek bir cümleden paywall

Brifing sadece “bir paywall ekranı ekle” şeklindeydi — referans yok, kaynak flow yok. $0.00 bir önizleme yer tutucusudur; rozette Best value yazıyor çünkü kimse indirim bilgisi sağlamadı.

Üç ekranlı bir flow

Quiz, plan, teklif; aralarındaki navigasyon bağlantılı şekilde kurulmuş. Geri sayım çiziliyor, ama gerçekten çalışıp çalışmadığını ancak bir cihazda görebilirsiniz.

Beceriyi yükleyin

Beceri, adapty-skills deposunda adapty-integration, ads-manager ve paywall-teardown ile birlikte gelir. Aşağıdaki komutların her biri dördünü birden yükler.

claude plugin marketplace add adaptyteam/adapty-skills
claude plugin install adapty-skills@adapty

git clone https://github.com/adaptyteam/adapty-skills.git
cp -r adapty-skills/skills/* ~/.copilot/skills/

gemini skills install https://github.com/adaptyteam/adapty-skills

git clone https://github.com/adaptyteam/adapty-skills.git
cp -r adapty-skills/skills/* ~/.agents/skills/

npx skills add adaptyteam/adapty-skills --all

Ardından isteyin — slash komutlarını skill’lere eşleyen araçlarda /flow-generator, eşlemeyenlerde ise “Use the flow-generator skill” yazmanız yeterli.

Buradan itibaren sade bir dille çalışırsınız. İsteklerin büyük çoğunluğu şu kategorilerden biridir:

• Flow’u tanımlayın: Uygulamanın ne yaptığını, ekranın ne satacağını, hangi planın önceden seçili olacağını belirtin.
• Bir tasarıma yönlendirin: Bir ekran görüntüsü, kendi ekranlarınızdan biri veya tasarım aracınızdaki bir çerçeve.
• Belirli bir düzenleme isteyin: Flow’un adını ve değişikliği belirtin — yeni bir dil, farklı metin, ek bir ekran veya bir quiz yanıtına göre dal.
• Sorularını yanıtlayın: Hangi ürünlerin bir ekrana ekleneceğini sorar; uydurmayı reddettiği gerçek sayılar için bilgi verin.

Nasıl çalışır

Skill’in oluşturduğu her şey yerel bir dosyada toplanır. Son adıma kadar kontrol panelinize hiçbir şey ulaşmaz.

1. Kurulum ve kimlik doğrulama. Skill, gerekirse Adapty CLI’ı yükler veya günceller, ardından Adapty oturumunuzu doğrular ve uygulama ID’nizi okur. Oturum açmadıysanız tarayıcı üzerinden giriş sayfasını açar ve işlemi tamamlamanızı bekler.

2. Flow’u seçin veya oluşturun. Düzenleme işleminde, flow’un yapılandırmasını getirir ve bulunanları raporlar — ekranlar, yerel ayarlar, ürünler ve gezinme grafiği — böylece herhangi bir değişiklik yapılmadan önce yanlış flow yakalanır. Önce getirilen yapılandırmanın yedeğini alır. Yeni çalışmalar için, zaten içerik barındıran bir flow üzerine oluşturmak yerine yeni bir flow oluşturur.

3. Yapılandırmayı doğrulayın. Araç, yerel dosyaya karşı iki doğrulama ve Adapty’ye karşı bir doğrulama çalıştırır. Yerel çift, dahili referansların hâlâ uyumlu olduğunu ve özelliklerin doğru biçimlendirildiğini kontrol eder. adapty flows config validate komutu ise yayımlamayı kontrol eden servisi çalıştırır; bu nedenle yeşil bir sonuç, yapılandırmanın yayımlanabilir olduğu anlamına gelir. Üç adımın hiçbiri herhangi bir şey kaydetmez.

4. Önizleme ve yineleme. Skill, değiştirilen her ekranı ekran görüntüsü olarak render eder ve inceler. Bir referans görsel sağladıysanız, render’ı dosyayla öğe öğe karşılaştırır — renk, yazı tipi, ikon stili, oranlar — ve kapatabildiği farkları kapatır. Yanlış görünen her şey skill’i 3. adıma geri götürür; bu da bir kaydetme yerine bir ekran görüntüsüne mal olur.

5. Onayla ve kaydet. Mevcut bir config’in üzerine yazmak için açık onayınız gerekir. Skill, dokunduğu her ekran için işlenmiş bir öncesi-sonrası görünümü gösterir, görsel değişiklik içermeyen değişiklikleri listeler, tarayıcınızda bir ekranı canlı olarak açar ve yedek dosyanın adını belirtir. Ancak bunların ardından yazar.

Çalıştırmanın ardından

Skill size kaydedilmiş bir taslak bırakır. Kullanıcılara ulaştırmak için:

1. Flow’u Flow Builder’da açın. Flow’u zaten bir tarayıcı sekmesinde açtıysanız, sayfayı yenileyin — Flow Builder, CLI üzerinden yapılan değişiklikleri otomatik olarak almaz.
2. Neyin değiştiğini inceleyin. Adapty, kaydetmeden önce Published durumunda olan bir flow’u Dirty olarak işaretler ve ekibinizdeki herkes bu durumu görür. Kullanıcılarınız en son yayınlanan sürümü görmeye devam eder.
3. Gerçek bir cihazda önizleyin. Flow’ları önizleme sayfası, Adapty mobil uygulaması üzerinden QR kodu akışını ele alır. Skill’in doğrulanmamış olarak bildirdiği her şeyi test edin — dallanmalar, geçişler ve render ettiği dil dışındaki herhangi bir yerel ayar.
4. Yayınlayın. Flow Builder’ın sağ üst köşesindeki Publish to Live düğmesine tıklayın. Bir placement içinde bulunmayan bir flow kimseye ulaşmaz; Draft durumundaki bir flow da bir placement’a eklenemez — bu nedenle önce yayınlayın. Bkz. Flow’ları kaydetme ve yayınlama.

Sonuç yanlışsa yedeği geri yükleyin: skill, ilk düzenleme öncesinde config’i kopyalar ve dosyayı onay mesajında adlandırır. Skill’den o dosyayı geri yazmasını isteyin ya da hatayı Flow Builder’da manuel olarak düzeltin. Her iki durumda da kaydedilmiş bir taslak, kullanıcılarınız için hiçbir şeyi değiştirmez.

Örnek promptlar

Skill, komutları, config formatını ve kendi doğrulama adımlarını zaten taşıdığından, bir promptun bunların hiçbirini açıklamasına gerek yok. Hangi flow olduğunu ve bittiğinde ne doğru olması gerektiğini söylemeniz yeterli.

Bir paywall’u çevir

Add Brazilian Portuguese to my "Summer 2026" paywall. Translate every
localizable field, not just the headline, and tell me what you couldn't.

Tasarımdan oluştur

Build a new paywall flow from the "Winter promo" frame in our Figma file.
Show me my products first and let me pick which ones go on it.

Dallanan bir quiz ekle

Add a quiz screen before my paywall: "What's your main goal?" with three
options, each routing to its own benefit screen, then on to the paywall.

Metni yeniden yaz

Rewrite the headline and CTA on my onboarding to be shorter and more direct.
Keep the price variables working, and apply it to every locale.

Test varyantı oluştur

Copy my "Main paywall" into a new flow and make the monthly plan the
preselected one. Leave the original alone.

Bir kampanya için yeniden tasarla

Re-theme my paywall flow to match the colors in ./design/spring.png.
Copy and layout stay as they are.

Ekran ekleme

Add a social proof screen between the quiz and the paywall in my activation
flow — star rating and two testimonials. Ask me for the real numbers.

Görsellerinizi verin

Bu skill, bilgisayarınızdaki bir görseli yükler ve dönen URL’yi flow’a bağlar; böylece medyayı Flow Builder’a elle eklemeniz gerekmez. Görsele değil, dosya yoluna ihtiyaç duyar: bir görseli sohbete yapıştırdığınızda veya ekleyip gönderdiğinizde, AI aracınız piksel verilerini alır ama dosyayı almaz, dolayısıyla yüklenecek bir şey olmaz.

Varlıkları bilgisayarınızdaki bir klasöre koyun, ardından aracı o klasöre yönlendirin:

The hero images are in ./design/paywall/. Use hero-calm.png on the first
screen and the three icons in ./design/paywall/icons/ for the benefit rows.

Formatlar ve boyut sınırları, Flow Builder’daki manuel yüklemeyle aynıdır — bkz. Görseller, videolar ve simgeler. SVG tek istisnadır: yükleme başarısız olduğundan araç, tek renkli glifleri satır içi olarak çizer.

Her yükleme, medya kitaplığınıza ayrı bir varlık ekler ve hiçbir CLI komutu bunu silmez; dolayısıyla bir derlemeyi yeniden çalıştırdığınızda kopyalar birikir.

Aracın bulamadığı bir dosya adı girerseniz, benzer görünenleri otomatik olarak seçmek yerine sizden onay ister. Yanlış bir dosya, ekranda doğru şekilde render edilen ancak yanlış görseli içeren bir sonuç üretir ve bu durumu iş akışında yakalayacak hiçbir şey yoktur.

Kendi ajanını getir

Adapty’nin Flow Builder içinde bir de AI Editör’ü var. Aralarındaki fark, hangisinin daha fazla özelliğe sahip olduğu değil — işin hangi ortamda gerçekleştiğidir.

AI Editör, Adapty’nin ajanıdır; açık olan ekran üzerinde çalışır. Skill ise tam tersi bir düzenlemedir: senin ajanın, senin modelin, senin araç setin ve Adapty de kullanmayı bildiği araçlardan biri. AI aracının erişebildiği her şey beraberinde gelir — reponu, tasarım dosyaların, MCP sunucuların, kendi prompt’ların ve bağlamın.

AI Editor’ü, halihazırda builder içindeyken önünüzdeki ekranı yeniden biçimlendirmek istediğinizde kullanın. Skill’i ise kendi ortamınızdan çıkmadan flow çalışmalarını halletmek istediğinizde kullanın.

Becerinin yapmayacakları

Beceri, flow’larınızı canlı içerik olarak ele alır; çünkü yayınlanmış bir flow gerçek kullanıcılara hizmet vermektedir.

• Yayınlama sizde kalır: Adapty CLI’ın publish komutu yoktur, bu nedenle yetenek kaydedilmiş taslakta durur.
• Üzerine yazma onayınızı gerektirir: Bir kaydetme işlemi tüm yapılandırmanın üzerine yazar; kısmi yazma veya geri alma yoktur. Onay, flow’un adını, ID’sini, durumunu ve yetenek düzenlemeden önce aldığı yedek dosyayı gösterir.
• Eş zamanlı düzenleme yazmayı başarısız kılar: İlk sonrasındaki her yazma işlemi, yapılandırmanın updated_at zaman damgasını Adapty’ye geri gönderir. Bu sürede bir takım arkadaşınız flow’u kaydettiyse, Adapty çalışmalarının üzerine yazmak yerine yazma işlemini reddeder.
• Bir flow’u silmek kontrol paneli işlemi olarak kalır: CLI’ın delete komutu yoktur, bu nedenle yeteneğin sizin için oluşturduğu bir flow, onu kontrol panelinden kaldırana kadar orada kalır.
• Gerçek sayılar ve varlıklar sizden gelir: Puanlar, yorum sayıları, indirim yüzdeleri ve mağaza fiyatları hiçbir zaman uydurulmaz. Bir şablon siz sağlamadığınız bir şeye ihtiyaç duyduğunda, yetenek onu sizden ister ya da öğeyi dışarıda bırakır ve hangisini yaptığını söyler.

Sınırlamalar

Çalıştırmalar zaman alır

Beceri, her değişiklikten sonra doğrular ve yeniden oluşturur; bu sayede bozuk bir yapılandırma kontrol panelinize yansımaz — ancak bu durum çalıştırmayı bir sohbet yanıtından yavaş yapar. Küçük bir düzenleme birkaç dakikada tamamlanır. Dallanan çok ekranlı bir flow yazmak 10 ila 40 dakika alır. Başlatın ve beklemek yerine geri dönün.

Videolar ve özel yazı tipleri manuel kalır

Beceri görsel yükler, video yüklemez; özel yazı tipi dosyaları da yüklemez. Her ikisi için de slotu oluşturur ve yüklemeyi size bırakır:

• Video: Beceri, videonun yer alacağı konuma bir medya öğesi ekler; böylece Flow Builder’da dosyayı değiştirdiğinizde düzen zaten hazır olur.
• Fonts: Beceri, tasarımınızın gerektirdiği metin stillerini oluşturur ve bunları bir yer tutucu yazı tipine bağlar. Fontu Flow Builder’a yükleyin ve ilgili stillere atayın.

Önizleme tek bir ekranı, tek bir durumda gösterir

Becerinin önizleme sayfası yalnızca tek bir ekran çizer ve flow’u adım adım göstermez. Aşağıdakilerin hiçbirini gösteremez. Her birini gerçek bir cihazda test edin — nasıl yapılacağını Flow önizleme bölümünde bulabilirsiniz:

• Gezinme ve dallanma: Gezinme eylemi taşıyan bir buton önizlemede olduğu yerde kalır, dolayısıyla koşullu bir rota tetiklenemez. Her ekran ayrı bir render’dır.
• Toggle ve çoklu seçim: Toggle satırı ve çoklu seçim satırı, varsayılan durumları ne olursa olsun kapalı konumda çizilir. Tekli seçim satırları ve ürün kartları ise seçili durumlarını doğru şekilde render eder.
• Çizildiği dil dışındaki her dil: Önizleme, flow’un varsayılan dilini ve dil listesinin sırasını yok sayar; bu nedenle bir çeviri görsel olarak hiç doğrulanamaz. Flow Builder’da dili değiştirip kapsayıcısından taşan metinleri kontrol edin.
• Çalışma zamanında çözümlenen her şey: Gerçek fiyatlar, mağaza para birimi ve kullanıcı girişi. Fiyat değişkeni, gerçek değeri yerine literal token olarak render edilir; bu token her fiyattan daha uzundur ve metni sabitlenmiş bir butonun altına itebilir — fiyat çözümlendiğinde bu örtüşme ortadan kalkar.
• Sayfanın bilmediği ekran boyutları: Güvenliği ekran yüksekliğine bağlı bir düzen, bunu kanıtlamak için küçük bir telefona ihtiyaç duyar.

Sırada ne var

• Flow’ları kaydet ve yayımla — taslağı tamamlamak için bu adımı takip edin.
• Sık karşılaşılan sorunlar — flow’un yayımlanmasını engelleyen durumlar.
• Adapty Flow Builder’da yerel ayar ekle — aynı yerelleştirme işini elle yapma.
• Adapty’yi AI ajanları ve kodlama araçlarıyla yönet — diğer Adapty becerileri ve AI araçları.