GitHub CLI ile Agent Skill Yönetimi: Tam Rehber
Geçen hafta bir müşterimle Copilot entegrasyonu üstünde çalışırken, adam bana dönüp “Aşkın abi, ben bu skill’leri her projede tek tek mi kuracağım?” dedi. O an kafamda bir ampul yandı, hani şu npm install yazarsın da paket iner ya, işte onun gibi bir şey neden yok diye uzun süredir düşünüyordum. E tabi GitHub da aynı boşluğu görmüş olacak ki gh skill diye bir komut çıkarmış. Açık söyleyeyim, beklediğimden erken geldi bu iş.
Frontmatter ile Taşınabilir Provenance
Bence en akıllıca taraflardan biri bu. gh skill, bir skill kurduğunuzda SKILL.md dosyasının frontmatter kısmına tracking metadata yazıyor; repo adı, ref ve tree SHA orada dürüyor. Veri dosyanın içinde yaşadığı için sız o skil’i kopyalasanız da taşısanız da başka projeye atsınız da provenance bilgisi onunla birlikte gidiyor. Agent’lar taşır, scriptler taşır, insanlar zaten durmadan taşır… ama nereden geldiği ve hangi versiyonda olduğu hep belli kalıyor.
Türkiye’deki Şirketler İçin Ne Anlama Geliyor?
Durun bir saniye, bunu ayrıca söylemem lazım: Türkiye’deki kurumsal müşterilerimde AI agent kullanımı hâlâ erken aşamada dolaşıyor. Bankalar, telekom şirketleri derken insanlar Copilot lisanslarını yeni yeni almaya başlıyorlar (evet, süreç biraz ağır ilerliyor). Ama bu skil ekosistemi olgunlaştıkça işler ciddi biçimde değişecek gibi dürüyor.
Evet, doğru duydunuz.
Şunu söyleyeyim, Neden? Çünkü düşünün: Şirketinize özel coding standartlarınız var, Türkçe dokümantasyon kurallarınız var, KVKK’ya uygun kod review akışı istiyorsunuz… Bunları bir kere yazıp gh skill publish ile private repo üzerinden yayınlayabilirsiniz tabi ki. Sonra yeni gelen geliştiriciye direkt gh skill install sirketim/coding-standards dersiniz. Konu kapanır gibi olur.
Kendi gözlemim şu: Türkiye’de bu tarz araçların benimsenmesi biraz kişiye bağlı ilerliyor (hani takımda biri çıkıp “bakın bu iş iyiymiş” demeli). Genelde bir champion gerekiyor; ekipte tek kişi bile bunun değerini görüp göstermezse herkes eski alışkanlıklara devam ediyor. Eğer bu yazıyı okuyan teknik liderseniz, o champion sız olabilirsiniz (kendi tecrübem) — bence çok yerinde bir karar —
Kendi deneyimimden konuşuyorum, Maliyet tarafına gelirsek — gh skill, GitHub CLI’ın parçası olduğu için ekstra ücret istemiyor doğal olarak. Ama Copilot lisansı kişi başı aylık $19 (Business) veya $39 (Enterprise). TL hesabıyla düşününce 5 kişilik ekipte aylık yaklaşık 700-1500 TL bandına denk geliyor gibi düşünebilirsiniz; küçük startup için can sıkabilir ama enterprise tarafında zaten lisanslar alınmış oluyor ve skil yönetimi bedava bonus gibi kalıyor.
Bunu biraz açayım.
Peki Küçük Ekip ile Enterprise Arasında Ne Fark Var?
| Özellik | Küçük Ekip (3-5 kişi) | Enterprise (50+ kişi) |
|---|---|---|
| Skill Scope | User scope yeterli | Project scope + merkezî repo |
| Sürüm Sabitleme | Zorunlu değil ama faydalı olabilir | Kesmeyen şekilde pin kullanın |
| Dondurulmuş Yayınlar | Nice to have | Zorunlu gibi düşünün |
| Kendi Skill Geliştirme | 1-2 tane yeterli olur çoğu zaman | Ekip bazlı library kurmak daha mantıklı olur |
| Düzeltme/Güncelleme Ritmi | Haftalık gh skill update |
Bunu CI/CD pipeline’a bağlayın bence |
Birkaç hafta önce tanıdığım 4 kişilik bir startup’ta Copilot skil’lerini devreye aldılar. Iki ay içinde dokümantasyon yazma süresi neredeyse yarıya indi dediler (ben de şaşırdım açıkçası). Ama enterprise tarafında hikâye farklı; orada approval süreci var, security review var, compliance var… Hani ne farkı var diyorsunuz, değil mi? aynı araç ama yaklaşım bambaşka oluyor.
Kendi Skill’ınızı Yazmak İsterseniz Ne Yapacaksınız?
Sadece skil kurmak değil, yazmak da mümkün tabi ki; hatta bana sorarsanız asıl değer burada yatıyor biraz da burada ortaya çıkıyor desek yanlış olmaz. Bir SKILL.md dosyası oluşturuyorsunuz ve agent’ın izleyeceği (belki yanılıyorum ama) talimatları içine koyuyorsunuz. Basit örnek şöyle:
---
name: turkish-code-review
version: 1.0.0
description: Türkçe kod review standartları
---
# Türkçe Kod Review Skill
Bu skil kod review sırasında Türkçe geri bildirim verir.
## Kurallar
1. Değişken isimleri İngilizce olmalı
2. Yorum satırları Türkçe yazılabilir
3. KVKK kapsamındaki veriler loglanmamalı
4. Her public method'un XML dokümantasyonu olmalı
İlginç olan şu ki, Daha sonra yayınlamak için:
gh skill publish
Yanı, Evet işte bu kadar gibi görünüyor ama aslında öyle değil; hmm, burada küçük bir parantez açayım çünkü iyi skil yazmak sanıldığı kadar kolay değil daha doğrusu kolay görünmüyor diyelim. Agent’ın talimatları nasıl yorumladığını anlamanız lazım; fazla detay verirseniz kilitleniyor gibi oluyor, fazla gevşek bırakırsanız da iş görmüyor.
Ben ilk skil’ımı yazdığımda agent sürekli yanlış dosyalara dalıyordu mesela; talimatları daraltınca toparladı.
Evet, doğru duydunuz.
test etmeden production’a almayın.
Bende Hangi Eksikler Göze Çarptı?
Bilmem anlatabiliyor muyum, Açık konuşayım, her şey güllük gülistanlık değil tabi ki; birkaç nokta beni rahatsız etti açıkçası.
Size bir şey söyleyeyim, Biri şu discovery tarafı — gh skill search var ama npm’deki gibi zengin registry yok henüz. Hangi skil’in ne kadar kullanıldığını, topluluk puanını, güvenilirlik skorunu göremiyorsunuz. Şu an biraz “güvendiğin repo’dan çek” mantığıyla ilerliyor. İlerde marketplace gelir mi bilmem ama şimdilik ortada yok.
İkincisi offline çalışma senaryosu. Bazı kurumsal müşterilerde internet erişimi kısıtlı oluyor, özellikle bankalar ve kamu kurumlarında. Skil’leri internal registry’den kurmak konusu henüz netleşmiş değil. GitHub Enterprise Server tarafında nasıl davranacağını görmek gerekiyor.
Üçüncüsü işe sürümler arasında breaking change olduğunda ne yapacağınız meselesi. Changelog mekanizması yok şu an ; gh skİll update size yalnızca “güncelleme var” diyor ama neyin değiştiğini anlamak için commit log’a bakmanız gerekiyor. Kağıt üstünde temiz, pratikte biraz uğraştırıcı.
Hemen Başlamak İsteyenlere İlk Adımlar
Lafı dolandırmadan söyleyeyim : denemek istiyorsanız şu adımları izleyin :
gh upgradeile CLI’ı v2.90.0+ sürümüne yükseltingh skİll searchile mevcut skİll’lere göz atıngh skİll install github / awesome — copilotile birkaç skİll kurun- Kendinize basit bir skİll yazın (bir SKILL.md yeter )
- Ekiple paylaşın, geri bildirım toplayın
E tabi daha önce GitHub Copilot CLI deneyiminiz varsa geçiş oldukça rahat olacaktır. Bu konuda GitHub Copilot CLI Nedir ve Nasıl Kurulur: İlk Adımlar yazısına bakabilirsiniz — temel kurulum adımları hâlâ geçerli.
.NET tarafında agent skİll geliştirmek isteyenler için.NET Agent Skills : Üç Yöntem, Tek Sağlayıcı yazısı da faydalı olur ; orada farklı yaklaşımları karşılaştırmıştık.
Son bir not: CopIot metriklerini takip etmek isteyenler Copilot CLI Metrikleri Artık Birleşik : Ne Değişti ? yazısına da göz atsın — skİll kullanımının etkisini ölçmek önemli.
Sıkça Sorulan Sorular
gh skill komutu ücretli mi?
Hayır, gh skill GitHub CLI’ın bir parçası, yanı neredeyse tamamen ücretsiz. Ama skill’leri kullanabilmek için bir AI agent host’una ihtiyacın var — mesela Copilot Business/Enterprise lisansı gibi. CLI’ın kendisi aslında bedava.
Agent skill’leri sadece GitHub Copilot’ta mı çalışıyor?
İşin garibi, Hayır, açık Agent Skills spesifikasyonunu takip ettikleri için Claude Code, Cursor, Codex. Gemini CLI gibi farklı agent host’larında da çalışıyorlar. Bence bu en güzel yanlarından biri. --agent flag’iyle hangi agent’ı hedeflediğini belirleyebilirsin.
Skill güvenliğini nasıl sağlarım?
Version pinning (--pin), immutable releases ve content-addressed change detection kullan. Tecrübeme göre en önemli nokta şu: sadece güvendiğin repo’lardan skill kur. Kurumsal ortamdaysan skill’leri mutlaka security review’dan geçir.
Yazdığım skill’i private repo’da tutabilir mıyım?
İnanın, Evet, private repo’dan skill yayınlayıp ekibinle paylaşabilirsin. Erişim yetkileri GitHub’ın standart repo izin yapısıyla yönetiliyor. Açıkçası bu, özellikle Enterprise müşteriler için ideal bir senaryo.
gh skill update çalıştırınca pinlenmiş skill’ler de güncelleniyor mu?
Hayır, pinlenmiş skill’ler güncelleme sırasında atlanıyor. Pin’i bilinçli olarak kaldırman ya da yeni bir versiyona pin’lemen gerekiyor. Bu kasıtlı bir tasarım kararı hani — kazara güncelleme riskini ortadan kaldırıyor.
Kaynaklar ve İleri Okuma
GitHub Blog: Manage Agent Skills with GitHub CLI
GitHub CLI Resmî Dokümantasyonu
GitHub Copilot Resmî Dokümantasyonu
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
4 comments