{"slug": "claude-skills-api-ga-ya-cikti-yenilikler-ve-nasil-kullanilir", "title": "Claude Skills API GA'ya Çıktı: Yenilikler ve Nasıl Kullanılır", "summary": "Anthropic has announced the general availability of the Claude Skills API as of August 20, 2026, allowing developers to create, version, and manage custom skills via the /v1/skills endpoints without beta headers. The release, accompanied by computer use, a new browser tool, and the Files API, positions skills as the production stack for building agents on the Claude Platform. The API supports both Anthropic-provided skills and custom skills, with validation rules for SKILL.md metadata and a versioning model that requires re-uploading all files for new versions.", "body_md": "Claude Beceriler API'si 20 Ağustos 2026 itibarıyla genel kullanıma sunuldu. Artık beta başlığı kullanmadan `https://api.anthropic.com/v1/skills`\n\nüzerinden özel beceriler oluşturabilir, sürümleyebilir ve yönetebilirsiniz. Bu beceriler, kendi altyapınızı barındırmanıza gerek kalmadan Claude'un kod sanal alanında çalışır. Anthropic bu sürümü bilgisayar kullanımı, yeni tarayıcı aracı ve Dosyalar API'siyle birlikte duyurdu ve Claude Platformu'nda aracı oluşturmak için üretim yığını olarak konumlandırdı.\n\nBeceriler kavramı sizin için yeniyse, [Claude Becerileri Rehberimiz](https://apidog.com/tr/blog/claude-skills?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) bu fikri baştan sona açıklar. Bu makale ise API katmanına odaklanır: uç noktalar, sürümleme modeli, becerileri bir Mesajlar çağrısına yükleyen istek yapısı ve genel kullanıma sunulmayla giderilmeyen çalışma alanı kapsamı ile anlık görüntü sürümleme gibi konular.\n\nTüm işlemler düz HTTP üzerinden yapılır. Bu nedenle burada gösterilen istekleri [Apidog](https://apidog.com/?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) içinde oluşturabilir, değişkenlerle yönetebilir ve regresyon testlerine bağlayabilirsiniz.\n\nBir beceri, belirli bir görevi yerine getirmek için gereken dosyaları içeren bir klasördür. Klasörün kökünde, `name`\n\nve `description`\n\nalanlarını içeren YAML ön bilgisine sahip bir `SKILL.md`\n\ndosyası bulunur. Komut dosyaları, şablonlar ve referans dosyaları bu dosyanın çevresinde yer alır.\n\nBir istek beceriyi içerdiğinde Claude, talimatları yalnızca görev gerektirdiğinde yükler ve paketlenmiş komut dosyalarını kod sanal alanında çalıştırır.\n\n`SKILL.md`\n\nön bilgisinin doğrulama kuralları şunlardır:\n\n`name`\n\nen fazla 64 karakter olabilir.`name`\n\nyalnızca küçük harf, sayı ve kısa çizgi içerebilir.`anthropic`\n\nve `claude`\n\nkelimeleri ayrılmıştır.`description`\n\nboş olamaz ve en fazla 1024 karakter olabilir.`display_name`\n\nalanı en fazla 255 karakter olabilir.Beceriler iki kaynaktan gelir:\n\n`type: \"anthropic\"`\n\n) `pptx`\n\n, `xlsx`\n\n, `docx`\n\nve `pdf`\n\ngibi kısa kimlikler kullanılır. Bu beceriler tarih tabanlı sürümlere, örneğin `20251013`\n\n, sahip olabilir.`type: \"custom\"`\n\n) sizin tarafınızdan yüklenir, çalışma alanınıza özel olur ve `skill_01AbCdEfGhIjKlMnOpQrStUv`\n\ngibi oluşturulmuş kimlikler alır.20 Ağustos 2026 itibarıyla öne çıkan değişiklikler şunlardır:\n\n`x-api-key`\n\nve `anthropic-version: 2023-06-01`\n\nbaşlıklarıyla kullanılabilir.Bu sürümle birlikte genel kullanıma sunulan Dosyalar API'si de beceriler için önemlidir. Çünkü beceriler çoğu zaman bir sunum dosyası veya doldurulmuş elektronik tablo gibi çıktılar üretir. Bu dosyaları Dosyalar API'si üzerinden alabilirsiniz.\n\nBeceriler API'sinin uç noktaları `/v1/skills`\n\naltında bulunur:\n\n| İşlem | Uç nokta |\n|---|---|\n| Beceri oluşturma | `POST /v1/skills` |\n| Becerileri listeleme | `GET /v1/skills` |\n| Beceri bilgilerini alma | `GET /v1/skills/{skill_id}` |\n| Beceri silme | `DELETE /v1/skills/{skill_id}` |\n| Yeni sürüm oluşturma | `POST /v1/skills/{skill_id}/versions` |\n| Sürümleri listeleme | `GET /v1/skills/{skill_id}/versions` |\n\nBeceri oluştururken tüm dosya kümesini yüklersiniz. Yeni sürüm oluştururken de mevcut beceri kimliğine karşı dosyaların tamamını yeniden gönderirsiniz.\n\nApidog'da bu akış, `{{skill_id}}`\n\nve `{{skill_version}}`\n\nortam değişkenlerini kullanan altı kayıtlı istekten oluşan tek bir klasör olarak modellenebilir. Böylece bir sürümü geliştirme veya üretim ortamına taşımak için istekleri düzenlemek yerine yalnızca değişkeni değiştirirsiniz.\n\nMinimal bir özel beceri için bir klasöre ve yükleme isteğine ihtiyacınız vardır. Örneğin, depoda aşağıdaki marka raporu becerisini tuttuğunuzu varsayalım:\n\n```\nbrand-report/\n  SKILL.md\n  templates/report.html\n  scripts/build_report.py\n```\n\n`SKILL.md`\n\ndosyası şu şekilde başlayabilir:\n\n```\n---\nname: brand-report\ndescription: Generates the weekly brand performance report as a formatted HTML document from a CSV of metrics. Use when asked for a brand report, weekly summary deck, or performance writeup.\n---\n```\n\nDosyaları multipart form verisi olarak yükleyin:\n\n```\ncurl -X POST https://api.anthropic.com/v1/skills \\\n  -H \"x-api-key: $ANTHROPIC_API_KEY\" \\\n  -H \"anthropic-version: 2023-06-01\" \\\n  -F 'files[]=@brand-report/SKILL.md;filename=brand-report/SKILL.md' \\\n  -F 'files[]=@brand-report/templates/report.html;filename=brand-report/templates/report.html' \\\n  -F 'files[]=@brand-report/scripts/build_report.py;filename=brand-report/scripts/build_report.py'\n```\n\nYanıt, oluşturulan `skill_id`\n\nile ilk sürümün `skver_*`\n\nkimliğini döndürür.\n\nBu iki değeri saklayın:\n\n`skill_id`\n\n, sonraki Mesajlar isteklerinde kullanılır.SDK yardımcıları bu isteği genellikle sarmalar. Kullandığınız SDK sürümüne göre tam multipart alan adlarını [Beceriler API referansında](https://platform.claude.com/docs/en/build-with-claude/skills-guide) doğrulayın.\n\n`description`\n\nalanını yönlendirme kuralı gibi yazın\nClaude, bir beceriyi yükleyip yüklemeyeceğine karar verirken `description`\n\nalanını okur. Bu alanı tek satırlık bir etiketten çok yönlendirme kuralı gibi yazın.\n\nÖrneğin şu bilgileri açıklamaya ekleyin:\n\nKullanıcıların kullandığı tetikleyici ifadeleri açıklamada listelemek, genel bir tanımdan daha kullanışlıdır.\n\nBeceriler doğrudan mesaja eklenmez. `container`\n\nparametresinde belirtilen kod yürütme aracı üzerinden çalışırlar:\n\n```\nresponse = client.messages.create(\n    model=\"claude-opus-5\",\n    max_tokens=4096,\n    container={\n        \"skills\": [\n            {\"type\": \"anthropic\", \"skill_id\": \"pptx\", \"version\": \"latest\"},\n            {\n                \"type\": \"custom\",\n                \"skill_id\": \"skill_01AbCdEfGhIjKlMnOpQrStUv\",\n                \"version\": \"latest\"\n            }\n        ]\n    },\n    messages=[\n        {\n            \"role\": \"user\",\n            \"content\": \"Build the Q3 revenue deck from the attached numbers\"\n        }\n    ],\n    tools=[\n        {\n            \"type\": \"code_execution_20250825\",\n            \"name\": \"code_execution\"\n        }\n    ],\n)\n```\n\nBu yapıyı kullanırken şu kurallara dikkat edin:\n\n`tools`\n\niçinde etkinleştirin.`\"latest\"`\n\nen yeni sürümü kullanır. Belirli bir `skver_*`\n\nkimliği veya Anthropic becerileri için tarih sürümü kullanarak davranışı sabitleyebilirsiniz.`\"latest\"`\n\nkullanmak daha akıcı bir iterasyon sağlar; üretimde sabit bir sürüm, beklenmeyen davranış değişikliklerini önler.Bir beceri belge dosyası ürettiğinde yanıt içinde bir `file_id`\n\nalırsınız. Dosyayı şu Dosyalar API uç noktasıyla indirebilirsiniz:\n\n```\nGET /v1/files/{file_id}/content\n```\n\nTemel üretim döngüsü şöyledir:\n\n`file_id`\n\ndeğerini alın.Sürümleme modelindeki en önemli ayrıntı şudur: Yeni sürüm bir delta değil, becerinin eksiksiz bir anlık görüntüsüdür.\n\nŞu isteği gönderdiğinizde:\n\n```\nPOST /v1/skills/{skill_id}/versions\n```\n\nbecerinin tüm dosya kümesini yeniden yüklersiniz. İstekten çıkardığınız dosyalar önceki sürümden devralınmaz. Ayrıca yeni sürümdeki `SKILL.md`\n\ndosyasının `name`\n\nalanı, mevcut becerinin adıyla eşleşmelidir.\n\nBecerileri derleme yapıtları gibi yönetin:\n\n`skver_*`\n\nsürümüne geri dönün.Eski sürümler erişilebilir kaldığı için geri alma işlemi, üretimde kullanılan tek bir sürüm dizesini değiştirmek kadar basittir.\n\nÖzel beceriler tüm çalışma alanına açıktır. Bir son kullanıcıya, konuşmaya veya oturuma özel değildir. Çalışma alanındaki her API anahtarı bu becerilere erişebilir.\n\nKiracıların kendi becerilerini yüklediği çok kiracılı bir ürün çalıştırıyorsanız, tüm kiracıları tek bir çalışma alanında toplamak veri izolasyonu açısından sorun oluşturabilir.\n\nÇözüm, Dosyalar API'sindeki yaklaşıma benzer: her kiracı için ayrı bir çalışma alanı oluşturun. Çalışma alanı bir izolasyon sınırı görevi görür. Her kuruluş, bir hesap ekibiyle iletişime geçmeden 100'e kadar çalışma alanına sahip olabilir.\n\nAnahtarlar, dosyalar ve beceriler bu sınırı devralır. Bu nedenle çalışma alanı tasarımıyla ilgili tek bir karar, bu üç kaynağın izolasyonunu birlikte belirler.\n\n`pause_turn`\n\nve konteyneri yeniden kullanma\nBeceri yürütmeleri tek bir model turundan uzun sürebilir. Bu durumda iki mekanizma kullanılır.\n\n`pause_turn`\n\nYanıt aşağıdaki durma nedeniyle tamamlanmadığında:\n\n```\nstop_reason: \"pause_turn\"\n```\n\nasistan içeriğini mesaj geçmişine ekleyin ve aynı `container.id`\n\ndeğeriyle isteği yeniden gönderin. Kod sanal alanı kaldığı durumdan devam eder.\n\n`container`\n\nnesnesi önceki yanıttan alınan bir `id`\n\nkabul edebilir. Böylece kurulu dosyalar ve çalışma durumu çok turlu konuşma boyunca korunur.\n\nÖrneğin beceri:\n\nHer iki desen de durumlu HTTP dizileri oluşturur. Bu istekleri elle doğrulamak yerine Apidog senaryosuna bağlayabilirsiniz:\n\n`stop_reason`\n\ndeğerini doğrulayın.`container.id`\n\ndeğerini ortam değişkenine aktarın.`file_id`\n\niçeriğinin indirilebildiğini doğrulayın.[Apidog CLI](https://apidog.com/tr/blog/apidog-cli-claude-skills-api-test-automation-guide?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) aynı senaryoyu CI içinde çalıştırabilir. Böylece bir beceri sürümü güncellemesinin hattı bozup bozmadığını otomatik olarak kontrol edebilirsiniz.\n\nBecerilerin başka bir satıcının ekosisteminde nasıl çalıştığını karşılaştırmak isterseniz, önceki incelememizde [Postman'ın Claude becerisini](https://apidog.com/tr/blog/postman-claude-skill?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) ele almıştık.\n\nGenel kullanıma sunulma aşamasında Beceriler API'si Claude API'si ve Microsoft Foundry üzerinden kullanılabilir.\n\nBeceriler Anthropic'in yönettiği sanal alanda yürütülür. Bu nedenle dağıtım süreci sizin tarafınızda konteyner imajı, çalışma zamanı yaması veya ölçeklendirme düğümü yönetmenizi gerektirmez. Dağıtım, beceri dosyalarının yüklenmesiyle sınırlıdır.\n\nBununla birlikte model uyumluluğunu kontrol etmeniz gerekir. İstek, yukarıdaki örnekteki `claude-opus-5`\n\ngibi kod yürütme aracının desteklediği bir modeli kullanmalıdır. Yeni başlıyorsanız [Claude Opus 5 API rehberimiz](https://apidog.com/tr/blog/claude-opus-5-api?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) temel istek yapısını açıklar.\n\nHayır. 20 Ağustos 2026'dan itibaren `/v1/skills`\n\nve `container.skills`\n\nparametresi Claude API'sinde standart başlıklarla çalışır. SDK'nızı yükselttikten sonra sabitlenmiş beta bayraklarını kaldırın.\n\nBeceriler Claude'un kod sanal alanında, kod yürütme aracının ağ kısıtlamalarıyla çalışır. Açık ağ erişimini varsaymak yerine, becerinin ihtiyaç duyduğu dosyaları klasörüne paketleyin.\n\nHarici API çağrılarını uygulama katmanınızda tutun. Böylece bu çağrıları doğru şekilde kontrol edebilir ve test edebilirsiniz.\n\nBir istek en fazla 20 beceri yükleyebilir. Claude, hangilerine ihtiyaç duyduğunu belirlemek için becerilerin `description`\n\nön bilgilerini okur.\n\nBu nedenle `description`\n\nalanlarını pazarlama metni gibi değil, yönlendirme kuralları gibi yazın.\n\nKonsept aynıdır, ancak çalışma zamanı farklıdır.\n\nClaude Code, dosya sisteminizdeki beceri klasörlerini keşfeder. Beceriler API'si ise becerileri sunucu tarafında, sürümlenmiş kaynaklar olarak barındırır ve Mesajlar API çağrıları sırasında kullanır.\n\nHer iki yaklaşım da `SKILL.md`\n\nön bilgisine sahip klasör biçimini paylaşır. Bu nedenle [Claude Code](https://apidog.com/tr/blog/claude-skills?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) için yazdığınız bir beceri genellikle az sayıda değişiklikle Beceriler API'sine taşınabilir.\n\nBeceriler API'sinin genel kullanıma sunulması, becerileri deneysel bir özellikten operasyonel bir API yüzeyine dönüştürüyor. Temel yapı şu bileşenlerden oluşuyor:\n\nEn hızlı değer elde eden ekipler becerileri diğer dağıtılabilir yapıtlar gibi yönetir: CI içinde klasörün tamamını paketler, üretimde sürümleri sabitler ve konteyner yaşam döngüsü için otomatik testler çalıştırır.\n\nAltı uç noktayı [Apidog](https://apidog.com/?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation) içinde modelleyin, sürüm güncellemesini bir test senaryosuna bağlayın ve hatalı bir beceri sürümünün sunum oluşturucunuzu bozduğunu kullanıcılarınızdan önce tespit edin. Sistemi bir öğleden sonra kurmak için [Apidog'u ücretsiz indirin](https://apidog.com/download?utm_source=dev.to&utm_medium=wanda&utm_content=n8n-post-automation).", "url": "https://wpnews.pro/news/claude-skills-api-ga-ya-cikti-yenilikler-ve-nasil-kullanilir", "canonical_source": "https://dev.to/tobiass_hoffmann/claude-skills-api-gaya-cikti-yenilikler-ve-nasil-kullanilir-4jll", "published_at": "2026-08-24 08:31:49+00:00", "updated_at": "2026-08-24 08:43:11.674681+00:00", "lang": "en", "topics": ["artificial-intelligence", "ai-products", "developer-tools", "ai-agents"], "entities": ["Anthropic", "Claude", "Apidog", "Files API"], "alternates": {"html": "https://wpnews.pro/news/claude-skills-api-ga-ya-cikti-yenilikler-ve-nasil-kullanilir", "markdown": "https://wpnews.pro/news/claude-skills-api-ga-ya-cikti-yenilikler-ve-nasil-kullanilir.md", "text": "https://wpnews.pro/news/claude-skills-api-ga-ya-cikti-yenilikler-ve-nasil-kullanilir.txt", "jsonld": "https://wpnews.pro/news/claude-skills-api-ga-ya-cikti-yenilikler-ve-nasil-kullanilir.jsonld"}}