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

Flow-generator skill, AI aracınızın flow’larınızı oluşturmasını ve düzenlemesini sağlar. Ne yapmak istediğinizi sade bir dille anlatın; araç, Adapty CLI veya Adapty MCP sunucusu aracılığıyla flow’un builder yapılandırmasını okur, yeniden yazar, önizleme oluşturur ve siz onayladıktan sonra taslağı 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ğı.

Important

Flow oluşturucu skill’i deneyseldir ve değişiklikleri doğrudan kontrol panelinizdeki flow’lara kaydeder. Önce bir taslak veya kopya üzerinde çalıştırın ve yayınlamadan önce her değişikliği Flow & Paywall Builder’da gözden geçirin.

Başlamadan Önce

  • Adapty eklentisi olan bir AI aracı: Claude Code, Codex, Copilot CLI veya Gemini CLI gibi bir kodlama ajanı ya da claude.ai. Skill, Adapty CLI’ı tercih eder. Yalnızca MCP sunucusuyla çalışılıyorsa CLI’ı kurmanızı teklif eder; reddederseniz MCP üzerinden devam eder ve çalıştırılamayan her yerel doğrulama adımını isimli olarak listeler.
  • Adapty kataloğunuzda ürünler: Skill, satış yapacak bir ekran tasarlamadan önce ürünlerinizi listeler ve hangilerinin o ekrana ait olduğunu sorar. Hiçbiri uygun değilse, sağladığınız mağaza ürün kimliklerinden yeni bir ürün oluşturabilir; bunu yapmadan önce sorar.

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 lokalize edin: Bir yerel ayar ekler ve yerelleştirilebilir her alanı doldurur — başlıklar, düğme etiketleri, plan açıklamaları, görsel alanları ve giriş yer tutucuları. Tek bir çalışan paywallı on dile taşımanın en hızlı yolu budur.
  • Tüm yerel ayarlarda metni aynı anda yeniden yazın: Yapıya dokunmadan ifadeleri değiştirir ve fiyat değişkenlerinin etrafında düzenleme yapar, böylece fiyatlar doğru çözümlenmeye devam eder.
  • Flow’un yapısını yeniden düzenleyin: 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.
  • Testler ve dallanma ekleyin: Seçilebilir gruplar, seçenek kimlikleri ve her yanıtı kendi ekranına yönlendiren koşullu aksiyonlar oluşturur — bir onboarding’i nitelikli bir paywall ziyaretine dönüştüren kişiselleştirme adımı.
  • Test için varyantlar oluşturun: Zaten çalışan bir flow’un canlı sürümünü yeni bir flow’a kopyalar, ardından test ettiğiniz değişikliği uygular. Ekranlar, tema, yazı tipleri, yerel ayarlar, ürünler ve remote config’ler aktarılır; böylece varyant yalnızca istediğiniz yerde farklılaşır.
  • Bir sezon veya kampanya için yeniden tasarlayın: Referans bir görüntüden renkleri örnekler ve her ekranı tek tek yeniden stilize etmek yerine flow genelinde yeni bir tema uygular.
  • Daha önceki bir sürüme geri dönün: Flow’un sürüm geçmişinde daha önceki bir sürümü bulur ve bunu taslak olarak geri yükler ya da yeni bir flow’a kopyalar. Skill ardından düzenlemeye o sürümden devam eder.

Ne üretir

Plan zaman çizelgeli bir paywall

Oluşturulmuş bir finans paywallı: yeşil bir çizgiyle birbirine bağlı üç adımlı numaralı zaman çizelgesi, ardından yıllık fiyatının yanında aylık karşılığını gösteren seçili bir Yıllık plan kartı, seçili olmayan bir Aylık kart ve bir Devam Et butonu

İ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

Oluşturulmuş koyu temalı bir fitness paywall'u: başlık, ikonlu üç avantaj satırı, En iyi değer rozetli seçili Yıllık kart, seçilmemiş Aylık kart ve Antrenmanı başlat düğmesi

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

Yan yana üç oluşturulmuş ekran: ikinci seçeneğin seçili olduğu bir antrenman hedefi quiz'i, üç aşamaya bölünmüş sekiz haftalık bir plan ve Yıllık kartın üzerinde geri sayım bulunan bir teklif ekranı

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 eklentisinin bir parçasıdır.

Adapty eklentisini zaten kurduysanız bu skill’e sahipsiniz demektir. Ajanınız bunu listelemiyor ise eklenti README dosyasındaki komutla eklentiyi güncelleyin.

Eklentiyi bir kodlama ajanına kurmak için terminalinizde şunu çalıştırın:

npx adapty skills install

Eklentiyi yüklemek için ajanınızı yeniden başlatın. Eklentiyi claude.ai veya Claude desktop’a kurmak için Eklentiyi Kur bölümüne bakın. Diğer kurulum yöntemleri için eklenti README dosyasına göz atın.

Claude Code eklentiyi otomatik olarak güncellemez. Yeni skill’leri yayımlandıkça almak için Claude Code’da /plugin komutunu çalıştırın, Marketplaces bölümünü açın, adapty seçeneğini seçin ve Enable auto-update seçeneğini etkinleştirin. Diğer ajanlardaki güncelleme komutu için eklenti README dosyasına bakın.

Ardından ne istediğinizi sade bir dille açıklayın. İsteklerin çoğu şu kategorilerden birine girer:

  • Flow’u tanımlayın: Uygulamanın ne yaptığını, ekranda ne satıldığını, hangi planın önceden seçili olacağını belirtin.
  • Bir tasarıma yönlendirin: Ekran görüntüsü, kendi ekranlarınızdan biri ya da tasarım aracınızdaki bir çerçeve.
  • Belirli bir düzenleme isteyin: Flow adını ve değişikliği belirtin — yeni bir yerel ayar, farklı metin, ekstra bir ekran ya da quiz yanıtına göre bir dal.
  • Sorularını yanıtlayın: Hangi ürünlerin bir ekrana ekleneceğini sorar; gerçek bir değer bilmeden bunu kendisi uydurmaz.

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ç veya oluştur. Düzenleme işleminde, flow’un config’ini getirir ve bulduklarını raporlar — ekranlar, diller, ürünler ve navigasyon grafiği — böylece herhangi bir değişiklik yapılmadan önce yanlış bir flow yakalanır. Düzenlemeye başlamadan önce skill, getirilen config’in bir kopyasını yedek olarak saklar. Sürüm geçmişi yayınlanmış her sürümü korur, ancak bir taslağın önceki hallerini korumaz; dolayısıyla hiç yayınlanmamış bir taslak için bu kopya, geri dönmenin tek yoludur. Yeni çalışmalar için, zaten içerik barındıran bir flow’un üzerine oluşturma yapmak 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 zaten bir tarayıcı sekmesinde açık tutuyorsanı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 durumda olan bir flow’u Dirty olarak işaretler ve ekibinizdeki herkes bu durumu görür. Kullanıcılarınız ise 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ı ele alır. Skill’in doğrulanmadı olarak raporladığı her şeyi test edin — dallanmalar, geçiş düğmeleri ve render ettiği dilden farklı 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’a eklenmemiş bir flow kimseye ulaşmaz; Draft durumdaki bir flow da placement’a eklenemez — dolayısıyla önce yayımlayın. Bkz. Flow’ları kaydetme ve yayımlama.

Sonuç yanlışsa skill’den geri almasını isteyin. Skill, flow’un sürümlerini listeler, seçtiğiniz sürümü taslak olarak geri yükler ve sonucu gösterir. Geri yükleme mevcut taslağın yerini alır; bunu yapmadan önce skill sizi uyarır ve taslağı yeni bir flow olarak çoğaltmayı teklif eder. Hiç yayımlanmamış bir taslak için geçmişte daha önceki bir durum bulunmaz; bu durumda skill’den yedek kopyayı geri yazmasını isteyin. Flow’u Flow & Paywall Builder’da elle de düzeltebilirsiniz. Her iki durumda da kaydedilen taslak kullanıcılarınız için hiçbir şeyi değiştirmez.

The version history also undoes a bad publish. Ask the skill to go back to the version that was live before: it restores that version as the draft, and you publish the draft when you’re ready.

Ö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.

Resim ve videolarınızı ekleyin

Skill, bilgisayarınızdaki bir resim veya videoyu yükler ve döndürülen URL’yi flow’a bağlar; böylece medyayı Flow & Paywall Builder’a elle eklemeniz gerekmez. Bunun için bir dosya yolu gerekir, resmin kendisi değil: sohbete bir resim yapıştırdığınızda veya ekleyip gönderdiğinizde, yapay zeka aracı pikselleri alır ama dosyayı almaz, dolayısıyla yükleyecek bir şey yoktur.

Dosyaları 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.

Formats and size limits match a manual upload in the Flow & Paywall Builder — see Görseller, videolar ve ikonlar. SVG tek istisnadır: yüklenemez, bu yüzden skill tek renkli glifleri doğrudan satır içi olarak çizer.

Skill, videoyu adapty flows media upload-video komutuyla yükler. Video, en fazla 30 saniye uzunluğunda, en fazla 50 MB boyutunda, genişlik ve yüksekliği en az 640 piksel olan bir MP4 veya WebM dosyası olmalıdır. GIF desteklenmez ve skill, animasyonlu bir görseli videoya dönüştürmez. Skill yalnızca MCP sunucusu üzerinden çalıştığında henüz video yükleyemez: boş bir yer tutucu içeren bir video öğesi yerleştirir ve klibi Flow & Paywall Builder’da siz yüklersiniz.

Her yükleme, medya kitaplığınıza ayrı bir öğe olarak eklenir ve hiçbir CLI komutu bunları kaldırmaz; bu nedenle derlemeyi yeniden çalıştırdığınızda kopyalar birikmeye başlar.

Araçların bulamadığı bir dosya adı girerseniz, yakın görünene yönlendirmek yerine sorar. Yanlış bir dosya, ekranda görsel olarak doğru görünen ancak hatalı resim içeren bir sayfa üretir; bunu iş akışında hiçbir şey 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 Editorflow-generator skill
Kimin ajanıAdapty’nin, tarayıcıdaSizin: bir kodlama ajanı veya claude.ai
Ne görebilirAçık ekranınız ve eklediğiniz görsellerAI aracınızın erişebildiği her şey
Bir prompt’un kapsamıTek ekranTüm flow — ekranlar, navigasyon, yerelleştirmeler
YerelleştirmeKapsanmıyorBir yerel ayar ekler ve yerelleştirilebilir her alanı doldurur
Geri almaPrompt başına tek tıklamaBir flow yedek kopyası, sürüm geçmişi ve her kayıt öncesi onayınız
KurulumYokAdapty eklentisi, ayrıca Adapty CLI veya MCP sunucusu

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.

Skill’in yapmayacakları

Skill, 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 kontrolünüzde: Skill yalnızca kaydedilmiş taslak oluşturur, hiçbir zaman yayınlamaz. Yayınlamak için Flow & Paywall Builder’ı ya da adapty flows publish komutunu kullanın.
  • Üzerine yazmak onayınızı gerektirir: Bir kayıt işlemi tüm config’in üzerine yazar; kısmi yazma yapılmaz, taslak için geri alma seçeneği yoktur. Onay ekranında flow’un adı, ID’si, durumu ve skill’in düzenlemeden önce aldığı yedek dosya gösterilir.
  • Geri yükleme taslak olarak kalır: Skill, önceki bir sürümü taslak olarak geri yükler ve hiçbir zaman yayınlamaz. Mevcut taslağın üzerine yazmadan önce sizden onay ister.
  • Kaydedilmemiş değişiklikler sizin elinizde: Skill başka bir sürümü açmadan veya geri yüklemeden önce, henüz kaydedilmemiş değişiklikleri kaydetmek mi, atmak mı yoksa mevcut sürümde kalmak mı istediğinizi sorar.
  • Eş zamanlı düzenleme yazmayı başarısız kılar: İlk yazma işleminden sonraki her yazma, config’in updated_at zaman damgasını Adapty’ye geri gönderir. Bu süre içinde bir takım arkadaşınız flow’u kaydetmişse, Adapty onların çalışmasının üzerine yazmak yerine yazma işlemini reddeder.
  • Bir flow’u silmek kontrol paneli işlemidir: CLI’da silme komutu bulunmadığından, skill’in sizin için oluşturduğu flow, siz kontrol panelinden kaldırana kadar orada kalır.
  • Gerçek sayılar ve varlıklar sizden gelir: Puanlar, inceleme sayıları, indirim yüzdeleri ve mağaza fiyatları asla uydurulmaz. Bir şablonda sağlamadığınız bir değer gerektiğinde skill ya onu sizden ister ya da öğeyi dışarıda bırakır ve hangisini yaptığını belirtir.
Note

Okuma, doğrulama ve önizlemeler hiçbir şeye mal olmaz ve hiçbir şeyi değiştirmez. Bir config kaydetmek, kontrol panelinize ulaşan tek eylemdir ve onayınızı gerektirir.

Sınırlamalar

Çalıştırmalar zaman alır

Skill, her değişikliği yaptıktan sonra doğrulama ve yeniden render işlemi gerçekleştirir; bu sayede hatalı bir config kontrol panelinize ulaşmaz — ancak bu durum bir çalıştırmayı sohbet yanıtından daha yavaş kılar. Küçük bir düzenleme birkaç dakikada tamamlanır. Dallanan yapıya sahip çok ekranlı bir flow hazırlamak 10 ila 40 dakika sürebilir. Başlatın ve izlemek yerine geri dönün.

Özel fontlar manuel kalır

Skill, özel font dosyalarını yüklemez. Tasarımınızın gerektirdiği metin stillerini oluşturur ve bunları bir yer tutucu yazı tipine bağlar. Fontu Flow & Paywall Builder’da yükleyip bu stillere atayın.

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

Skill’in önizleme sayfası tek bir ekran çizer ve flow’u baştan sona göstermez. Aşağıdakilerin hiçbirini gösteremez. Her birini gerçek bir cihazda test edin — nasıl yapacağınızı 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