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 talep üzerine yüklediği bir dizi talimattır. Bu skill, flow yapılandırmasında hata yapılması kolay kısımları kapsar: hangi düzenlemeler yayını durdurur, bir ekranı sildiğinizde hangi referanslar bozulur ve render edilmiş bir önizlemenin neyi kanıtlayıp neyi kanıtlayamayacağı.

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.

Skill’i yükleyin

Skill, adapty-skills deposuyla birlikte adapty-integration, flow-audit, migrate-placements, ads-manager, paywall-teardown ve onboarding-teardown ile birlikte gelir. Bu komutların her biri yedi skill’in tamamını 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 & Paywall Builder’da açın. Flow’u daha önce bir tarayıcı sekmesinde açtıysanız, sayfayı yenileyin — Flow & Paywall Builder, CLI üzerinden yapılan bir yazma işlemini otomatik olarak algılamaz.
2. Nelerin 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 son yayımlanan sürümü görmeye devam eder.
3. Gerçek bir cihazda önizleyin. Flow’ları önizleme, Adapty mobil uygulaması üzerinden QR kodu akışını kapsar. Aracın doğrulanmamış olarak bildirdiği her şeyi test edin — dallanmalar, geçiş düğmeleri ve işlendiği dil dışındaki tüm yerel ayarlar.
4. Yayımlayın. Flow & Paywall Builder’ın sağ üst köşesindeki Publish to Live düğmesine tıklayın ya da terminalden adapty flows publish komutunu çalıştırın. Bir placement içinde yer almayan bir flow kimseye ulaşmaz; Draft durumundaki bir flow da placement’a eklenemez — bu nedenle önce yayımlayın. Bkz. Flow’ları kaydetme ve yayımlama.

Sonuç yanlışsa yedekten geri yükleyin: Araç, ilk düzenlemeden önce config’i kopyalar ve dosya adını onay mesajında belirtir. Araçtan o dosyayı geri yazmasını isteyin ya da flow’u Flow & Paywall Builder’da elle 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 sağlayın

Bu beceri, bilgisayarınızdan bir görsel yükler ve dönen URL’yi flow’a bağlar; böylece Flow & Paywall Builder’a görselleri elle eklemeniz gerekmez. Bir resim değil, dosya yolu gereklidir: sohbete bir görsel yapıştırır ya da eklerseniz, AI aracınız piksel verilerini alır ama dosyayı almaz; dolayısıyla yüklenecek bir şey olmaz.

Görselleri bilgisayarınızda 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.

Biçimler ve boyut sınırları, Flow & Paywall Builder’daki manuel yüklemeyle aynıdır — bkz. Görseller, videolar ve ikonlar. SVG bunun tek istisnasıdır: yükleme başarısız olduğundan araç, tek renkli glifleri doğrudan satır içine çizer.

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

Aracın bulamadığı bir dosya adı belirtirseniz, benzer görünene geçiş yapmak yerine size sorar. Yanlış bir dosya, ekranda doğru şekilde render edilen ancak yanlış görseli içeren bir sonuç üretir; iş akışındaki hiçbir şey bunu yakalamaz.

Kendi agentınızı getirin

Adapty’nin Flow & Paywall Builder içinde ayrıca bir AI Editörü de bulunmaktadır. Aralarındaki fark, hangisinin daha fazla özelliğe sahip olduğuyla ilgili değil — işin hangi ortamda gerçekleştiğiyle ilgilidir.

AI Editörü, Adapty’nin agentıdır ve açık olan ekranda çalışır. Skill ise tam tersi bir düzenlemedir: sizin agentınız, sizin modeliniz, sizin araç setiniz ve Adapty de bunların kullanmasını bildiği bir araç olarak. AI aracınızın halihazırda erişebildiği her şey onunla birlikte gelir — repo’nuz, tasarım dosyalarınız, MCP sunucularınız, kendi prompt’larınız ve bağlamınız.

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 sizin elinizde: Skill yalnızca kaydedilmiş taslak oluşturur ve hiçbir zaman yayınlamaz. Yayınlamayı kendiniz Flow & Paywall Builder’da ya da adapty flows publish komutuyla yapın.
• Üzerine yazmak onayınızı gerektirir: Bir kayıt, yapılandırmanın tamamının yerini alır; kısmi yazma ya da geri alma yoktur. Onay, flow’un adını, kimliğini, durumunu ve skill’in düzenlemeden önce aldığı yedek dosyayı belirtir.
• Eş zamanlı düzenleme yazmayı başarısız kılar: İlk yazmanın ardından gelen her yazma işlemi, yapılandırmanın updated_at zaman damgasını Adapty’ye geri gönderir. Bu süre zarfında bir ekip arkadaşınız flow’u kaydetmişse Adapty, çalışmalarının üzerine yazmak yerine yazma işlemini reddeder.
• Flow silme işlemi kontrol paneli üzerinden yapılır: CLI’nin silme komutu olmadığından, skill’in sizin için oluşturduğu bir flow, siz onu kontrol panelinden kaldırana kadar varlığını sürdürü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, sağlamadığınız bir değer gerektirdiğinde skill ya sizden ister ya da ilgili öğeyi dışarıda bırakır ve hangisini yaptığını belirtir.

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, video için medya öğesini doğru konuma yerleştirir; bu sayede Flow & Paywall Builder’da dosyayı değiştirdiğinizde düzen zaten hazır olur.
• Yazı Tipleri: Beceri, tasarımınızın gerektirdiği metin stillerini oluşturur ve bunları bir yer tutucu yazı tipine bağlar. Yazı tipini Flow & Paywall Builder’a yükleyin ve ilgili stillere atayın.

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

Skill’in önizleme sayfası 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 düğme önizlemede yerinde kalır, dolayısıyla koşullu bir rota tetiklenemez. Her ekran ayrı bir render’dır.
• Geçiş ve çoklu seçim: Bir geçiş satırı ve çoklu seçim satırı, varsayılan değerleri ne olursa olsun kapalı konumda çizilir. Tek seçim satırları ve ürün kartları ise seçili durumlarını düzgün render eder.
• Çizdiği dil dışındaki herhangi bir dil: Önizleme, flow’un varsayılan dilini ve dil listesinin sırasını yoksayar; bu nedenle bir çeviri görsel olarak doğrulanamaz. Flow & Paywall Builder’da dili değiştirin ve kapsayıcısından taşan metinleri arayın.
• Çalışma zamanında çözümlenen her şey: Gerçek fiyatlar, mağaza para birimi ve kullanıcı girdisi. Bir fiyat değişkeni, gerçek token değerini literal olarak render eder; bu değer herhangi bir fiyattan daha uzun olup metni yerleşik bir düğmenin altına itebilir — fiyat çözümlendiğinde kaybolan bir çakışma.
• Sayfanın bilmediği ekran boyutları: Güvenliği görüntü alanı yüksekliğine bağlı olan bir düzen, bunu kanıtlamak için kısa bir telefona ihtiyaç duyar.

Sırada ne var

• flow-audit skill — bu skill’in bıraktığı taslağın yayına almadan önce üretime hazır olup olmadığını kontrol eden salt okunur denetim.
• Flow’ları kaydet ve yayınla — skill’in bıraktığı taslağı tamamla.
• Yaygın sorunlar — bir flow’un yayınlanmasını engelleyen şeyler.
• Adapty Flow & Paywall Builder’a dil ekle — aynı yerelleştirme işlemini elle yapma.
• Adapty’yi yapay zeka ajanları ve kodlama araçlarıyla yönet — diğer Adapty skill’leri ve yapay zeka araçları.