Bir uygulamayı yerelleştirmek eskiden SDK eklemek, provider bağlamak ve anahtarları elle yönetmek demekti. AI kodlama agent'larıyla daha kısa bir yol var: bir Skill kur, bağlama işini agent yapsın. globalize.now, açık bir agent Skill'i olarak gelen, AI destekli yerelleştirme altyapısıdır. Tek komut çalıştırırsın, agent'ın playbook'u okur ve yeni bir altyapıyı sen bakımını yapmadan kod tabanın çeviriye hazır bir yapıya kavuşur.

Agent Skill'i nedir?

Agent Skill'i, bir kodlama agent'ının okuyup uyguladığı küçük bir talimat paketidir. Açık Skills ekosistemi üzerinden dağıtılır ve Skills CLI ile kurulur, örneğin npx skills add owner/repo. Aynı komut Claude Code, Cursor, Codex, OpenCode ve elliden fazla başka agent'ta çalışır.

Skill'in kendisi bir SKILL.md dosyası ve varsa destekleyici dosyalardan oluşur, agent'ının zaten baktığı dizine yerleşir. CLI onu tek bir kanonik kopyaya bağlar ve kurulumu bir lockfile'a kaydeder. Böylece Skill, bir vendor hesabında durmak yerine projenin geri kalanıyla birlikte sürümlenir. Hatta bir herkese açık registry bile var: Skill'i diğer bağımlılıklar gibi bulur, okur ve sabitlersin.

Dikkat çeken değişim şu: skill, agent'ının entegre olduğu bir ürün değildir. Agent'ının özümseyip kodunda uyguladığı bilgidir. Bu fark, ekibe yeni biri katıldığı anda ortaya çıkar. Depoyu klonlar, skill zaten oradadır ve onun agent'ı yerelleştirmeyi senin agent'ınla aynı şekilde yürütür.

i18n'i neden SDK yerine skill olarak sunmalı?

Çünkü uluslararasılaştırmanın zor kısmı refactor'dur ve skill, agent'ına bunu senin yerine yapmayı öğretir. SDK ise kodunun çeviriye uygun yapılandırıldığını varsayar. Koda gömülü metinleri bulmak, bir anahtar şeması tasarlamak, dil dosyaları oluşturmak ve çalışma zamanı kütüphanesini bağlamak yine sana kalır.

Yapay zekayla üretilen uygulamalarda durum daha da kötüdür, çünkü coding agent'lar çeviri mimarisini değil, çalışan bir ekranı hedefler. Çıktı genellikle doğru ve yayına hazırdır, ama anahtarlı bir çağrı yerine <button>Submit order</button> gibi metinlerle doludur. Bunu tüm projeye çarptığında yerelleştirme bir yapılandırma değişikliği değil, bir refactor olur.

Kendi haline bırakılırsa sorun katlanır. Aynı etiket üç ufak farkla yazılır, sayaçlar 1 messages biçiminde görünür ve ilk dili eklediğinde yarısı İngilizce, yarısı başka dilde olan ekranlarla karşılaşırsın. Skill bunların hepsini tek geçişte yakalamak için tasarlanmıştır, yani yüzlerce küçük ticket'a dönüşmeden önce.

Skill, bu refactor'u agent'ının çalıştırabileceği talimatlara dönüştürür. Framework'ünü algılar, zaten kullandığın next-intl ya da i18next gibi i18n çalışma zamanını doğrular, İngilizce metinleri çıkarır, anahtarları ve dil dosyalarını üretir. Sürümleyip bakımını yapacağın yeni bir runtime eklemezsin. Skill kurulumu yapar ve yolundan çekilir.

Skill, MCP sunucusundan nasıl ayrılır?

MCP sunucusu agent'ının çağırdığı bir servistir, skill ise projendeki dosyalardır. Model Context Protocol, agent'lara çalışan bir sunucu üzerinden canlı araç ve veri vermenin iyi bir yoludur. Ama sunucuyu senin ya da bir sağlayıcının barındırması gerekir ve agent'ın buna erişebilmesi şarttır.

Skill'in arkasında servis yoktur. Deponla birlikte gelen metin ve koddan ibarettir, ağ çağrısı olmadan çalışır ve her değişiklik gibi bir PR'da görünür. Bir kod tabanını uluslararasılaştırmak gibi tek seferlik kurulum işlerinde, ayakta tutman gereken bir servisten dosyalar daha iyidir. Skill'in ne yapacağını okursun, çalıştırırsın ve diff'i gözden geçirirsin.

Skill'ler birbirini de tamamlar. Birkaçını birden kurabilirsin ve yan yana dururlar, çünkü her biri yalnızca talimattır; çalıştırıp ücretini ödeyeceğin ayrı bir süreç değildir.

globalize.now agent skill olarak nasıl kurulur?

Tek komut, gerisini agent'ın halleder.

npx skills add globalize-now/globalize-skills --all

--all bayrağı, makinendeki tüm agent'lar için tüm skill'leri kurar. Hangi agent'ı kullandığından emin değilsen güvenli varsayılan budur. CLI, globalize.now skill'ini agent'ının skill aradığı yere bırakır. Zaten kullandığın agent'larla çalışır, Claude Code ve Cursor dahil.

Sonrasında agent'ından i18n kurulumunu yapmasını istersin ve o yol haritasını izler: framework'ü algılar, çalışma zamanı kütüphanesini doğrular, kullanıcıya görünen İngilizce metinleri bulur, anahtarları ve dil dosyalarını üretir. Geliştiricilerin tanıdığı kısım öncesi ve sonrasıdır.

// before
<button>Submit order</button>

// after
<button>{t("checkout.submit_order")}</button>

Anahtarlar, skill'in senin için oluşturup güncel tuttuğu dil dosyalarına yerleşir:

/locales
  en.json
  de.json
  es.json
  fr.json

İngilizce dosyan, agent'ın bulduğu metinlerle dolar. Diğer diller üretilir ve her push'ta güncel tutulur; yeni bir pazar eklemek bir sprint değil, bir dil dosyasıdır.

Kurulumdan sonra çeviriler her Git push'unda senkronize olur. Hiçbir şey dışa aktarmazsın, temizlenecek kuyruk da yoktur. Eğer uygulamanı vibe coding ile yapıyorsan işin bundan ibarettir. Ayrıntıları merak eden bir geliştiriciysen aynı skill refactor'u temiz biçimde yürütür ve geride standart dil dosyaları bırakır.

Çevirilerim deponda mı kalıyor?

Evet. Skill'in ürettiği dil dosyaları, diğer kaynak dosyalar gibi depona commit edilir. Lock-in açısından en önemli nokta budur.

Bazı yaklaşımlar çevrilmiş metinlerini bir build adımına ya da barındırılan bir panele taşır; ayrıldığın gün çeviri katmanın da seninle birlikte gider. Depo içinde duran dil dosyalarıyla ise en.json, de.json ve diğerleri projendeki sıradan dosyalardır. Skill yarın ortadan kalksa bile uygulaman sahip olduğu her dili yayınlamaya devam eder. Ayrılmak, skill'i bir daha kurmamak demektir; taşınacak hiçbir şey yoktur, çünkü sana ait hiçbir şey hiçbir zaman başka bir yerde durmadı. globalize.now bu yüzden uygulamanın etrafını sarmak yerine, anahtarları ve dil dosyalarını üreterek stack'inin altyapı katmanında yer alır.

Skill modeli seni bir satıcıya bağlar mı?

Hayır; üstelik lock-in'den kaçınmak onu tercih etmenin nedenidir. Skill, kapalı bir eklenti mağazasından değil, desteklenen her agent'ın okuyabildiği açık bir registry'den kurulur. Çıktı, zaten seçtiğin çalışma zamanı kütüphanesi için standart dil dosyalarıdır; sonradan çözmek zorunda kalacağın kapalı bir biçim değil.

Skill'in ne yaptığını çalıştırmadan önce tam olarak okuyabilirsin, çünkü yalnızca dosyalardan ibarettir. Gerekçe yerine adım adım anlatım istersen yapay zekayla üretilen bir uygulamayı yerelleştirme rehberi aynı kurulumu baştan sona anlatır.

globalize.now koda gömülü uygulama metinlerini çeviriye hazır dil dosyalarına dönüştürür ve sen yayına aldıkça güncel tutar.

globalize.now'ı ücretsiz dene