Plugin
Skill, alt ajan, komut ve hook'ları tek bir sürümlenebilir pakette toplayan ve bir pazar yeri (marketplace) üzerinden dağıtılabilen yapıdır.
Skill'i klasör kopyalayarak kurarsan, o kopya orada donar — sen kaynağı güncellesen bile kullanıcıdaki sürüm eski kalır.
Plugin bunu çözer: sürüm numarası vardır, güncelleme gelir, kaldırmak tek komuttur.
Yapı: Paket kökünde .claude-plugin/plugin.json (ad, sürüm, açıklama, lisans) ve isteğe bağlı skills/, agents/, commands/, hooks/ dizinleri. Pazar yeri için ayrıca .claude-plugin/marketplace.json.
Sürümleme: version alanı SemVer'dir ve kullanıcı yalnızca bu numara yükseltildiğinde güncelleme alır. Sürüm üç yerde birden tutarlı olmalıdır: plugin.json, skill frontmatter'ı ve değişiklik günlüğü — aksi hâlde kullanıcı elindeki sürümün ne olduğunu bilemez.
Yol çözümü: Plugin içinden script çağırırken ${CLAUDE_PLUGIN_ROOT} yer tutucusu kurulum dizinine çözülür. Dosya olarak kurulmuş bir skill'de bu değişken bulunmaz; bu yüzden iyi yazılmış bir skill script yolunu sırayla dener, tahmin etmez.
Kurulum: Pazar yeri eklenir, sonra plugin kurulur. Depo doğrudan pazar yeri olarak kullanılabilir.
Bu skill'in bilgi tabanı (kaynaklar.md) 3 ayda bir tazeleniyor. Dosya kopyalayarak kuran kullanıcı bu tazelemelerin hiçbirini almaz — yani zamanla bayat bilgiyle çalışan bir skill'e sahip olur. Sürümlü dağıtım bu projede kolaylık değil, doğruluk meselesidir.
/plugin marketplace add system-conf/master-blog-skill /plugin install master-blog@master-blog-marketplace
Sonraki sürümde plugin.json içindeki version yükseltilir; kullanıcı güncellemeyi görür.
"Plugin sadece paylaşım kolaylığı." Asıl kazanç sürümleme ve güncelleme; tek kullanıcılı kurulumda bile değerlidir. "Plugin kurmak skill'i otomatik açar." Kurulum yalnızca dosyaları yerine koyar; tetiklenme yine açıklamaya bağlıdır.