Kurulum

Skill'i Claude'a ekle

Dört dosyayı doğru dizine koymak yeterli. Kurulumdan sonra ayrı bir "etkinleştirme" adımı yok.

Kurulum nasıl çalışır?

Claude Code, iki dizindeki skill'leri kendiliğinden tanır:

• ~/.claude/skills/ — kişisel: bütün projelerinde geçerli olur.
• <proje>/.claude/skills/ — projeye özel: repoda durur, ekiple paylaşılır.

Dosyalar yerine konduğunda Claude, yeni oturumda skill'in adını ve açıklamasını görür. Blogla ilgili bir istek geldiğinde açıklamayla eşleştirir ve SKILL.md dosyasını okur.

Yöntemler

1 · Claude'a söyle (en az sürtünme). Terminal sözdizimi ezberlemeye gerek yok, işletim sistemi fark etmez. Claude Code'a şu cümleyi ver:

github.com/system-conf/master-blog-skill deposundan
skills/master-blog klasörünü ~/.claude/skills/ altına kur

2 · Plugin (güncelleme alır). /plugin marketplace add system-conf/master-blog-skill ardından /plugin install master-blog@system-conf. Diğer yollar güncelleme almaz; bu skill'in kaynak kaydı 3 ayda bir tazelendiği için fark önemli.

3 · kur.sh (tek komut). 1,8 KB'lık okunabilir script; dosyaları siteden indirdiği için her zaman güncel sürümü kurar ve sonunda doğrulamayı kendi çalıştırır.

curl -fsSL https://system-conf.github.io/master-blog-skill/kur.sh -o kur.sh
less kur.sh     # 40 satır — okumadan çalıştırma
sh kur.sh       # projeye özel: sh kur.sh --proje

curl | sh tek satırını bilerek önermiyoruz: okumadan çalıştırmayı öneren bir kurulum, kendi güvenlik politikamızla çelişirdi.

4 · Diğer yollar. Depoyu klonlamak (eşikleri değiştirecek ya da katkı verecekseniz), dosyaları tek tek almak (ağ kısıtlı ortam) ve Claude uygulamasının Ayarlar bölümünden yükleme. Ayrıntılar kurulum panelinde.

Kurulumu doğrula

Hangi yolu seçersen seç, son adım aynı:

python3 ~/.claude/skills/master-blog/scripts/surum-kontrol.py

Sürümü, bilgi tazeliğini ve güncelleme gerekip gerekmediğini yazar. kur.sh bunu zaten kendisi çalıştırır.

Sonra: yeni bir Claude oturumu başlat (mevcut oturum eski skill listesini taşır) ve dene — *"master-blog skill'iyle içerik envanterimi çıkar"*. Skill devredeyse ilk iş proje keşfi olur ve aday için veri gerekçesi ister.

Güncel kalmak

Bu skill'in bilgi tabanı zamanla bayatlar: zengin sonuç tipleri kaldırılır, rapor alanları değişir, bot adları eklenir. Skill bunu kendisi bildirir — her oturumun başında yaşını kontrol eder:

python3 scripts/surum-kontrol.py

Script, yayınlanmış sürümü surum.json adresinden okur. Ağ yoksa --cevrimdisi ile yalnızca tazelik ölçülür — bu bir hata değil, raporda belirtilir.

Plugin kurulumunda güncelleme tek komut: /plugin update master-blog. Dosya kurulumunda güncelleme gelmez; skill sana "yeni sürüm var" der ama kopyalamayı sen yaparsın. Bu proje özelinde plugin kurulumunun asıl avantajı budur.

Sık sorulanlar

Skill her mesajda mı yükleniyor? Hayır. Normalde yalnızca adı ve açıklaması bağlamda durur; iş eşleştiğinde tam dosya okunur.

Mevcut blog skill'imle çakışır mı? Açıklamaları farklıysa çakışmaz. Aynı işi yapan iki skill varsa, birinin açıklamasına "şu durumda diğerini kullan" satırı eklemek en temiz çözümdür.

Projeye özel mi, kişisel mi kuralım? Ekip aynı süreci kullanacaksa projeye özel kurulum daha iyidir: repoda sürümlenir, herkeste aynı olur.

Değiştirebilir miyim? Evet, MIT lisanslı. Ama eşikleri skill dosyasını düzenleyerek değiştirme — güncellemede silinir. Projenin köküne master-blog.toml koy:

[esikler]
IC_LINK_MIN = 2
KELIME_MIN = 400

Profil bazlı önerilen değerler için kullanım senaryolarına bak.