Kendi skill dosyanızı yazmak: iyi talimatın yapısı

Skill, bir işin yöntemini yazıya döken küçük bir talimat dosyasıdır. İyi yazılmış bir skill aynı işi her seferinde aynı kalitede yaptırır; kötü yazılmış olan ise kimsenin işine yaramaz. Bu derste iyi bir skill’in yapısını öğrenecek ve kendi işiniz için ilkini yazacaksınız.

Aklınıza bir soru mu takıldı?

Sorunuzu ya da aradığınız konuyu yazın Ders bul

Bu derste neler öğreneceksiniz?

• Bir skill dosyasının parçalarını
• İyi bir ad ve açıklamanın nasıl yazıldığını
• Adımları, örneği ve kontrolü nasıl yerleştireceğinizi
• Skill’i nasıl sınayacağınızı

Önce küçük bir iş seçin

Skill’i üç kez elle yaptığınız bir iş için yazın. İlk iki kez işi sohbette anlatın, üçüncüde sonucu beğendiğiniz konuşmayı kaydedin. Geliştirici belgeleri şu sırayı önerir: görevi önce skill olmadan deneyin, eksikleri görün, sonra yalnızca bu eksikleri kapatacak kadar talimat yazın.

Her iş skill gerektirmez. Aynı talimatı her sohbette kullanıyorsanız kalıcı talimat yeter. Yalnızca belirli işlerde devreye girmesini, kendi örneklerini ve kontrol adımlarını taşımasını istiyorsanız skill yazın. Claude’un yardım sayfası farkı şöyle koyar: projeler her sohbette yüklü duran sabit bilgi sağlar, skill’ler ise göreve özeldir ve yalnızca gerektiğinde devreye girer.

Bir skill’in parçaları

Claude’un belgelerine göre bir skill, ana dosyası “SKILL.md” olan bir klasördür. Dosya iki bölümden oluşur: başta ad ve açıklamayı içeren kısa bir üstbilgi, altında talimatlar.

• Ad: en çok 64 karakter; yalnızca küçük harf, rakam ve tire. “anthropic” ve “claude” sözcüklerini içeremez. “haftalik-bulten-taslagi” gibi işi anlatan bir ad seçin; “yardimci” gibi genel adlardan kaçının.
• Açıklama: skill’in ne yaptığını ve ne zaman kullanılacağını anlatır. Claude, bu açıklamaya bakarak skill’i çağırıp çağırmayacağına karar verir. Üçüncü kişi ağzıyla yazın (“Bülten taslağı hazırlar”, “Ben yardım ederim” değil) ve işi tetikleyecek kelimeleri koyun. Uzunluk sınırı kaynaklara göre değişir: claude.ai yardım sayfası 200, geliştirici belgesi 1.024 karakter yazıyor. Kısa tutmak her iki durumda da güvenlidir.
• Gövde: adımlar, kurallar ve örnekler. Belgelere göre gövdeyi 500 satırın altında tutun; uzun ayrıntıyı ayrı dosyalara koyup ana dosyadan bağlayın.

İyi talimat nasıl yazılır?

1. Bilinmeyeni yazın. Modelin zaten bildiğini anlatmayın. “Bülten nedir” yazmayın; “derneğin bültenleri hep ‘Merhaba komşularımız’ ile başlar” yazın.
2. Adımları numaralayın. Karmaşık işlerde kutucuklu bir kontrol listesi koyun.
3. Örnek verin. Bir iki girdi-çıktı örneği, uzun açıklamadan çoğu zaman daha iyi öğretir.
4. Yasakları açık yazın. “Tarih uydurma” gibi cümleler en çok işe yarayan satırlardır.
5. Kontrol adımı ekleyin. Çıktıyı bitirmeden önce bir kontrol belgesine karşı gözden geçirmesini isteyin.
6. Seçenek sunmayın. “İstersen A, istersen B” yerine bir varsayılan belirleyin.

Belgeler ayrıca serbestlik derecesini işe göre ayarlamayı önerir: yaratıcı işlerde genel yönerge, kırılgan ve sıralı işlerde kesin adımlar. Zamana bağlı bilgi (“2026’da şu geçerli”) yazmayın; güncelliğini yitirir.

Ücretsiz yol ve güvenlik

Claude’un yardım sayfasına göre skill’ler ücretsiz planda da vardır; kod yürütmenin açık olması gerekir. Klasörü zipleyin, zip’in kökünde skill klasörü olsun; sonra Claude’a yükleyip Customize bölümündeki Skills altında etkinleştirin. Kaydettiğiniz dosyada API anahtarı ya da parola bulundurmayın. İnternetten indirdiğiniz hazır bir skill’i etkinleştirmeden önce okuyun.

Adım adım uygulama

1. Üç kez elle yaptığınız bir işi seçin.
2. Aşağıdaki şablonu kendi işinize göre doldurun.
3. Klasörü ve dosyayı oluşturun; adı klasör adıyla aynı olsun.
4. Skill’i yükleyin ve etkinleştirin.
5. Skill’in çalışması gereken üç farklı istek yazın ve ne zaman çalışmaması gerektiğini de bir istekle sınayın.
6. Çalışmayan yeri talimata ekleyin.

Kontrol listesi

• Adı işi anlatıyor.
• Açıklama neyi ve ne zaman yaptığını söylüyor.
• Adımlar numaralı.
• Yasaklar açık yazılı.
• En az bir örnek var.
• Parola ya da anahtar yok.
• Üç istekle sınadım.

Sık yapılan hatalar

• Açıklamayı “yardımcı olur” gibi belirsiz bırakmak; skill hiç çağrılmaz.
• Her şeyi tek dosyaya doldurmak.
• Sınamadan paylaşmak.
• Gizli belge ya da kişisel veriyi skill’e gömmek.

Kendinizi deneyin

Kaynaklar

• Claude Geliştirici Belgeleri: Skill authoring best practices (İngilizce)
• Claude Yardım: How to create custom skills (İngilizce)
• Claude Yardım: What are skills? (İngilizce)

Son kontrol: 10 Kasım 2026

Kaynak: yzdersleri.com/ders/kendi-skill-dosyanizi-yazmak-iyi-talimatin-yapisi/ · Yapay Zeka Dersleri