Claude Skills API GA oldu: Neler değişti, nasıl kullanılır?

Anthropic, Claude Skills API'yi, computer use özelliğini ve Files API'yi 20 Ağustos 2026'da genel kullanıma açtı. Beta header'ları artık gerekmiyor; computer use tarafında tek turda birden fazla işlem yapılabiliyor ve yeni bir browser use aracı var. Ancak GA sürümü önemli bir noktayı değiştirmiyor: Skill'ler hâlâ yalnızca Claude onları çalıştırmaya karar verdiğinde devreye giriyor. Bu nedenle sürüm sabitleme ve aktivasyon tasarımı sizin sorumluluğunuzda olmaya devam ediyor.

20 Ağustos'taki GA sürümüyle neler değişti?

Geçiş yapana kadar mevcut beta entegrasyonlarınız çalışmaya devam ediyor. Anthropic'in duyuru yazısında öne çıkan somut değişiklikler ise şöyle:

• Beta header zorunluluğu kalktı. Güncel skills rehberi yalnızca iki ön koşul sıralıyor: Claude API anahtarı ve istekte etkinleştirilmiş code execution. GA öncesi rehberlerde gereken beta header'ları artık dokümantasyonda yer almıyor.
• Tek turda birden fazla işlem. Güncellenen computer use aracı, model başına tek işlem yerine birkaç işlemi birlikte yürütüyor: tıklama, yazma, tuş vuruşu ve ekran görüntüsü alma. Anthropic'in @ClaudeDevs hesabına göre erken erişim müşterileri, görev başına %20–40 daha az gidiş dönüş gördü.
• Browser use aracı. Ekran görüntülerini sayfa yapısıyla birleştirerek ajanın piksel koordinatları yerine belirli bir alanı ya da düğmeyi hedeflemesini sağlıyor. Araç, sigorta başvurusu gibi web portalı işlemlerine yönelik.
• Files API kapasitesi. Organizasyon başına 1 TB depolama, 5 kat yüksek hız limitleri (@ClaudeDevs paylaşımına göre 500 RPM) ve otomatik dosya süresi dolma özelliği sunuluyor.
• Uyumluluk seçeneği. Computer use artık Anthropic'in BAA'sı kapsamında HIPAA düzenlemelerine tabi iş yükleri için kullanılabiliyor.
• Bulut platformu erişimi. Skills API ve Files API, Microsoft Foundry üzerinden de kullanılabiliyor. Güncellenmiş computer use ve browser use araçları ise tarihi açıklanmadan Vertex AI için "yakında" olarak duyuruldu.

Files API, Skills API ve computer use birlikte nasıl çalışıyor?

Anthropic'in hasar yönetimi ajanı örneği, uçtan uca akışı gösteriyor: Önce dosya kimliğiyle başvuru belgesi alınır (Files API), ardından başvuru prosedürünü içeren bir skill uygulanır (Skills API), sigorta şirketinin portalı browser use ile tamamlanır (computer use) ve onay yeniden dosya olarak kaydedilir. Belgeler her istekte tekrar gönderilmek yerine bir kez yüklenir, sonrasında file_id ile referans verilir.

Yayınla birlikte gelen iki performans veri seti de sağlayıcı tarafı tarafından paylaşıldı. Duyuru yazısında araştırma mühendisi Davide Locatelli, en uzun hasar iş akışının 32 dakikadan 13 dakikaya indiğini ve tamamlama oranının %100'e ulaştığını belirtti. Asteroid kurucu ortağı David Mlčoch ise erken erişim döneminde sağlık sektörüne yönelik computer use akışlarını test etti:

"32-52% fewer model calls, 25-32% lower cost per task, 100% completion on every workflow, up from 77%" — @MlcochDavid

Messages API üzerinden Claude Skills API çağrısı yapmak

Bir skill eklemek için tek bir parametre yeterli: Messages API isteğindeki container nesnesine bir skills dizisi ekleniyor. Dizideki her kayıtta type (anthropic veya custom), skill_id ve isteğe bağlı version alanları bulunuyor.

Resmî skills rehberine göre bu parametreyle ilgili işleyiş şöyle:

• Code execution etkin olmalı ve modelin bunu desteklemesi gerekiyor. Rehberdeki örneklerde claude-opus-5, code_execution_20250825 araç türü ve max_tokens=4096 kullanılıyor.
• Tek bir istek en fazla 20 skill destekliyor.
• Skill'ler Anthropic'in code-execution sandbox ortamında çalışıyor: Ağ erişimi yok, çalışma anında paket kurulumu yok. Dönen container.id değerini turlar arasında yeniden kullanmadığınız sürece her istek için yeni bir container oluşturuluyor. Her yanıtta expires_at alanı da bulunuyor.
• Skill dosyalarını kendiniz barındırmanız gerekmiyor; Anthropic bunları container içinde çalıştırıyor.

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    tools=[{"type": "code_execution_20250825"}],
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "xlsx", "version": "20251013"},
            {"type": "custom", "skill_id": "skill_01...", "version": "skver_01..."},
        ]
    },
    messages=[{"role": "user", "content": "Build the Q3 revenue summary"}],
)

Girdi belgeleri ters yönde ilerleyen bir akışla ekleniyor: Önce Files API üzerinden yükleniyor, ardından container upload bloğunda referans gösteriliyor. İstek yapısı standart Anthropic Messages API formatında olduğundan doğrudan API anahtarıyla veya AIReiter's Claude API gibi Anthropic uyumlu bir relay üzerinden kullanılabiliyor.

Yerleşik skill'lerde pptx, xlsx, docx ve pdf gibi kısa, okunabilir kimlikler kullanılıyor. Sürümler ise 20251013 ya da latest gibi tarih biçimli değerler alıyor. Özel skill'ler, çalışma alanınıza kapsamlanmış skill_01... kimlikleriyle oluşturuluyor.

Özel Skill yayınlama: reddedilmenize yol açan kurallar

Özel bir skill, en üst düzeyinde YAML frontmatter içeren bir SKILL.md dosyası bulunan dizindir. Bu frontmatter'da name ve description yer alır; dizine isteğe bağlı olarak script'ler ve referans dosyaları da eklenebilir. Çalışabilecek en temel dosya şu şekildedir:

---
name: eu-claims-filing
description: Use when filing or amending EU insurance claims. Loads the
  carrier-specific submission procedure, required fields, and rejection
  codes before filling any portal form.
---

# EU claims filing procedure
1. Pull the intake document by file_id ...

Yükleme işlemi ZIP arşiviyle veya tek tek dosyalarla yapılabiliyor; Python SDK, files_from_dir sunuyor. Ancak skill çalıştırılmadan önce Anthropic katı sınırları denetliyor. Tüm sınırlar skills rehberinde listelenmiş durumda:

Aynı rehbere göre yönetim, ant CLI aracı veya onun arkasındaki API uç noktaları üzerinden yapılıyor. Dosyadan sabitlenmiş sürüme giden yol şöyle:

ant skills create ./eu-claims-filing   # returns skill_01...
ant skills:versions create skill_01...  # returns skver_01... — pin this in production

İlk kullanımda ekipleri şaşırtan iki davranış var: Yeni sürüm tam bir anlık görüntüdür. Tüm dosya setini yeniden yüklersiniz; dahil edilmeyen dosyalar önceki sürümden aktarılmaz. Ayrıca bir skill'i silmek, ona ait tüm sürümleri de siler.

Production kontrol listesi: sürümü sabitleyin, izole edin, önbelleği koruyun

Production ortamında en sık sorun çıkaran noktalar değişebilir sürümler, çalışma alanı genelindeki yetkiler ve cache miss durumları. Skills rehberi bu üç konuda da açık uyarı veriyor.

1. Sürümleri sabitleyin. latest kullanırsanız veya hiç sürüm belirtmezseniz, çalışma alanına erişimi olan herhangi biri yeni bir sürüm yüklediğinde dağıtımdaki ajanın çalıştırdığı içerik anında değişir. Production'da skver_... kimliklerini sabitleyin; latest değerini aktif geliştirme için kullanın.
2. Çalışma alanını tenant sınırı kabul edin. Bir çalışma alanındaki her API anahtarı, o alandaki tüm özel skill'leri okuyabilir, çağırabilir ve silebilir. İzolasyon sınırı kullanıcı veya oturum değil, çalışma alanıdır. Çok kiracılı uygulamalarda tenant başına bir çalışma alanı kullanın ve varsayılan 100 çalışma alanı sınırını hesaba katın.
3. Önbellekleme için skill listesini sabit tutun. Sırası dahil skill listesindeki her değişiklik, system prompt önekini değiştirir ve prompt cache'i geçersiz kılar. Özel sürümleri sabitlemek de bu öneki korur; aksi hâlde yeniden yüklenen bir latest açıklaması onu değiştirebilir. Token başına ücretlendirmede, istekler arasında değişen bir skill listesi cache hit tasarrufunu fark ettirmeden ortadan kaldırır.
4. pause_turn durumunu yönetin. Uzun süren skill'ler stop_reason: "pause_turn" döndürebilir. Devam etmek için dönen içeriği sonraki istekte yeniden gönderin veya işlemi kesmek için konuşmayı değiştirin.
5. Veri saklama yaklaşımınızı bilin. Agent Skills, sıfır veri saklama düzenlemelerinin dışındadır. Skill tanımları ve yürütme verileri Anthropic'in standart saklama politikasına tabidir. Compliance API etkinse Activity Feed, etkinleştirildiği andan itibaren skill ve skill sürümü oluşturma ile silme işlemlerini kaydeder.
6. Doğru hataları yakalayın. Çağrıları anthropic.BadRequestError yakalayacak şekilde sarın ve skill kaynaklı hataları diğer geçersiz istek hatalarından ayırın.
7. Kullanılmayacak skill'leri eklemeyin. Dokümantasyon bunu doğrudan belirtiyor: Kullanılmayan skill'lerin dahil edilmesi performansı etkiler.

API'nin çözemediği aktivasyon sorunu

GA sürümü skill'lerin çevresindeki altyapıyı iyileştirdi; Claude'un hangi skill'i seçeceğini değil. Aşağıdaki kullanıcı tartışmalarında tekrar eden konu şu: Skill'ler ikinci bir system prompt gibi değil, tetiklendiğinde çalışan prosedürler gibi davranıyor.

"My problem with Claude Skills is that they are not skills. Nothing forces Claude to actually use them. Claude does whatever it wants... These are just md files." — @Yampeleg, GA öncesinde yazıldı; çağırma mekanizması değişmedi

Skill'lerin gerçekten çalışıp çalışmadığını tartışan r/ClaudeAI başlığı, pratik çözümleri iyi özetliyor:

"userstyle gets prepended every turn but skills only fire when claude decides to invoke based on the description." — u/samxu01

"Skills must have a simple, clear metadata description that also focuses on an action that Claude is doing." — u/Chadum

Bu tartışmalardan çıkan dört kural var:

• Açıklamayı bir persona etrafında değil, tetikleyici ifadeler ve yapılacak eylem etrafında yazın.
• Adımları, kontrolleri, kuralları ve araç seçimlerini gövdeye koyun. u/MartinMystikJonas'ın testi şu: "If your skills define steps agent should do, things it should check, rules it should follow and tools it should use then it is useful."
• u/Actual_Committee4670'a göre Claude'un yerel olarak iyi yapamadığı işleri kodlayın.
• Her tur uygulanması gereken gereksinimleri system prompt'a veya CLAUDE.md'ye taşıyın. u/samxu01'ın yukarıda belirttiği gibi bunlar her turda başa eklenir. Hook'ları ise commit öncesi gibi yaşam döngüsü anları için ayırın.

Kısa cevaplar

Skills API için hâlâ beta header'larına ihtiyacım var mı?

Hayır. 20 Ağustos 2026'daki GA sürümünden bu yana ön koşullar, Claude API anahtarı ve etkinleştirilmiş code execution ile sınırlı. Güncel dokümantasyonda beta header bulunmuyor.

Skill'ler context window'u tüketiyor mu?

Başlangıçta yalnızca metadataları tüketiyor. Skills rehberine göre Claude, her skill'in frontmatter'ını en başta alıyor, dosyaları container'a kopyalıyor ve tam talimatları yalnızca görev gerektirdiğinde yüklüyor. Dokümanların kullanılmayan skill'lere karşı uyarmasının nedeni de bu.

Skill ile MCP arasındaki fark nedir?

Skill, Claude'un ağ erişimi olmayan sandbox ortamında çalışan talimat ve script paketidir. MCP ise Claude'u canlı harici sistemlere bağlar; Anthropic bu ayrımı skills genel bakışında yapıyor. Bir hasar iş akışı ikisini birlikte kullanabilir: Poliçe veritabanı için bir MCP sunucusu, başvuru prosedürü için bir skill.

Tek bir SKILL.md, Claude.ai, Claude Code ve API'de çalışabilir mi?

SKILL.md formatı ortak, ancak dağıtım yöntemi her yüzeyde farklı: API'de çalışma alanına yüklenen skill'ler, Claude Code'da .claude/skills dizinleri ve Claude.ai uygulamasında plan düzeyindeki yüklemeler kullanılıyor.

Skills API, sıfır veri saklama kapsamında çalışır mı?

Hayır. Agent Skills, sıfır veri saklama düzenlemelerine dahil değildir; skill tanımları ve yürütme verileri standart saklama politikasına tabidir.

İhtiyaca göre doğru mekanizma

Seçimi, ne zaman devreye girmesi gerektiğine göre yapın:

20 Ağustos, skill mekanizmasını production kullanımı için hazır hâle getirdi; ancak bu tablodaki seçenekleri birbirinin yerine geçebilir yapmadı.

İlgili okumalar: model ve token bazında Claude API fiyatlandırması ve Claude Code'da Claude skill kaydetme.