Agent Skills: AI Coding Agent'ları Nasıl "Eğitilir"? — GitHub'da 300K+ Yıldız Toplayan Yeni Paradigma

Bugün (9 Ağustos 2026) GitHub Trending'e baktığınızda dikkat çekici bir pattern görüyorsunuz: üç farklı "Agent Skills" reposu aynı anda listeyi domine ediyor. Matt Pocock'un skills reposu 210,267 yıldızla tepede, Addy Osmani'nin agent-skills'i 84,693 yıldızla紧随 ediyor, ve Google'ın skills reposu 16,853 yıldızla listeye girmiş durumda. Üçünün toplamı 311,000+ yıldız.

Peki bu "Agent Skills" konsepti nedir ve neden bu kadar popüler oldu?

---

Agent Skills Nedir?

Geleneksel yazılım dünyasında, bir junior developer'ı eğitmek için dokümantasyon, code review, pair programming ve mentorluk kullanırsınız. AI coding agent'lar için ise yeni bir paradigmaya ihtiyacımız var: Agent Skills.

Agent Skills, AI agent'lara (Claude Code, Codex, Cursor, Copilot, vb.) "nasıl çalışması gerektiğini" öğreten yapılandırılmış Markdown dosyalarıdır. Bunlar basit prompt'lar değil — iş akışları, kalite kapıları, doğrulama adımları ve anti-rasyonalizasyon tabloları içeren kapsamlı prosedürlerdir.

Matt Pocock'un tanımladığı gibi:

"Gerçek uygulama geliştirmek zordur. GSD, BMAD ve Spec-Kit gibi yaklaşımlar sürecin kontrolünü ele alarak size yardımcı olmaya çalışır. Ama bunu yaparken kontrolünüzü alır ve hataları çözmeyi zorlaştırır. Bu skill'lar küçük, uyarlanabilir ve birleştirilebilir olacak şekilde tasarlandı."

Neden Şimdi Patladı?

Üç temel neden var:

1. AI Agent'lar Yeterince İyi — Ama Yeterince İyi Değil

Claude 4, GPT-5, Gemini 2.5 gibi modeller artık karmaşık kod yazabiliyor. Ama "doğru" kod yazmak ile "iyi mühendislik" yapmak arasında büyük bir fark var. Agent'lar kod yazar, ama test yazmayı, code review yapmayı, mimari düşünmeyi "unutturur." Skills bu boşluğu doldurur.

2. Plugin Ekosistemleri Olgunlaştı

Claude Code'un plugin marketplace'i, Codex'in plugin sistemi, ve npx skills gibi evrensel yükleyiciler sayesinde artık skill paketlerini tek komutla yükleyebiliyorsunuz:

# Matt Pocock'un skills'lerini yükle
npx skills@latest add mattpocock/skills

# Addy Osmani'nin skills'lerini yükle
npx skills add addyosmani/agent-skills

# Claude Code plugin marketplace'ten yükle
/plugin marketplace add addyosmani/agent-skills

3. "Vibe Coding" Tartışması

Son aylarda "vibe coding" (AI'ya her şeyi rastgele yaptırmak) ile "gerçek mühendislik" arasındaki tartışma alevlendi. Agent Skills, bu tartışmanın "gerçek mühendislik" tarafının somut cevabı. Matt Pocock'un reposunun alt başlığı tam olarak bunu söylüyor: "Skills for Real Engineers. Straight from my .agents directory."

Agent Skills Nasıl Çalışır?

Bir Agent Skill, tipik olarak şu yapıdadır:

SKILL.md
├── Frontmatter (ad, açıklama, tetikleyici koşullar)
├── Genel Bakış (ne yapar)
├── Ne Zaman Kullanılır (tetikleyici koşullar)
├── Süreç (adım adım iş akışı)
├── Rasyonalizasyonlar (bahaneler + çürütmeler) ⚡
├── Kırmızı Bayraklar (tehlike işaretleri)
└── Doğrulama (kanıt gereksinimleri)

Anti-Rasyonalizasyon Tabloları — En İlginç Yenilik

Her skill, AI agent'ların adım atlamak için kullanabileceği bahaneleri ve bunların çürütmelerini içerir:

Bahane	Çürütme
"Testleri sonra eklerim"	Test olmadan doğrulama yapılamaz. Önce test, sonra kod.
"Bu çok basit, speklere gerek yok"	Basit değişiklikler en sinsi bug'ları üretir.
"Zaten çalışıyor"	"Çalışıyor" ≠ "doğru". Kanıt göster.

Bu tablolar, AI agent'ların "tembellik" yapmasını engellemek için tasarlanmış — adeta agent'lara "disiplin" öğreten bir mekanizma.

Slash Commands ile İş Akışı

Addy Osmani'nin paketi 8 temel slash command ile tüm development lifecycle'ı kapsar:

Komut	Ne Yapar	Temel İlke
/spec	Ne yapılacağını tanımla	Kod öncesi spek
/plan	Nasıl yapılacağını planla	Küçük, atomik görevler
/build	Artımlı olarak kodla	Bir seferde bir dilim
/test	Çalıştığını kanıtla	Testler kanıttır
/review	Merge öncesi gözden geçir	Kod sağlığını iyileştir
/webperf	Web performansını denetle	Ölçmeden optimize etme
/code-simplify	Kodu basitleştir	Açıklık, zekilikten önemli
/ship	Production'a gönder	Hızlı olan güvenli olandır

3 Farklı Yaklaşım, 3 Farklı Felsefe

Matt Pocock (mattpocock/skills) — 210,267 ⭐

Felsefe: Mühendislik disiplini, domain-driven design, test-driven development.

Öne çıkan skill'lar:

• /grill-me — Agent'ın sizi projeniz hakkında amansızca sorguladığı bir "grilling" seansı. En popüler skill'ı.
• /grill-with-docs — Aynı grilling, ama CONTEXT.md ve ADR'leri de güncelliyor. Shared language (ortak dil) oluşturuyor.
• /tdd — Red-green-refactor döngüsü, zorunlu.
• /improve-codebase-architecture — Codebase'i tarayıp "derinleştirme fırsatları" buluyor. HTML rapor üretiyor.

Matt Pocock'un yaklaşımı Pragmatic Programmer ve Domain-Driven Design gibi klasik mühendislik kitaplarından ilham alıyor. Skills'leri composable (birleştirilebilir) ve model-agnostic (herhangi bir modelle çalışabilir).

Addy Osmani (addyosmani/agent-skills) — 84,693 ⭐

Felsefe: Production-grade, kurumsal düzeyde mühendislik becerileri.

Öne çıkan skill'lar:

• interview-me — Kullanıcıyı ~%95 güven seviyesine ulaşana kadar tek tek sorularla sorguluyor.
• doubt-driven-development — Her önemli kararı adversarial bakış açısıyla sorgulama: CLAIM → EXTRACT → DOUBT → RECONCILE → STOP.
• security-and-hardening — OWASP Top 10 önleme, auth pattern'ları, secrets yönetimi.
• observability-and-instrumentation — Yapılandırılmış logging, RED metrikler, OpenTelemetry tracing.

24 skill + 4 uzman persona (code-reviewer, test-engineer, security-auditor, web-performance-auditor) ile tam bir development lifecycle paketi.

Google (google/skills) — 16,853 ⭐

Felsefe: Google ürünleri ve teknolojileri için özel agent skill'ları.

Google'ın yaklaşımı daha spesifik — kendi ekosistemleri (Cloud, Firebase, Android, vb.) için optimize edilmiş skill'lar.

Kendi Agent Skill'lerinizi Nasıl Yazarsınız?

Bir Agent Skill yazmak için ihtiyacınız olan:

1. SKILL.md Dosyası Oluşturun

---
name: my-custom-skill
description: Agent'ı [görev] boyunca yönlendirir. Şu durumlarda kullanılır...
---

## Genel Bakış
Bu skill, [problem] çözmek için tasarlanmıştır.

## Ne Zaman Kullanılır
- [Koşul 1] olduğunda
- [Koşul 2] tespit edildiğinde

## Süreç
1. [Adım 1]
2. [Adım 2]
3. Doğrulama: [Kanıtları kontrol et]

## Rasyonalizasyonlar
| Bahane | Çürütme |
|--------|---------|
| "[Yaygın bahane]" | "[Neden yanlış olduğu]" |

## Kırmızı Bayraklar
- [Tehlike işareti 1]
- [Tehlike işareti 2]

## Doğrulama
- [ ] [Kanıtlama gereksinimi 1]
- [ ] [Kanıtlama gereksinimi 2]

2. Projenize Yerleştirin

# Proje düzeyinde
.agents/skills/my-custom-skill/SKILL.md

# Kişisel düzeyde
~/.agents/skills/my-custom-skill/SKILL.md

3. Agent Tarafından Keşfedilmesini Sağlayın

Claude Code, Codex, Cursor gibi araçlar .agents/ dizinini otomatik tarar. Veya AGENTS.md dosyanızda referans verin.

Prime Agent: Bir Adım Ötesi

Bugünün trending'inde ayrıca PrimeIntellect-ai/prime-agent (9,328 ⭐, bugün +2,483) var. Bu repo, Agent Skills konseptini bir üst seviyeye taşıyor:

• Recursive Language Model (RLM) — Context'i değişken, tool'ları fonksiyon çağrısı olarak kullanma
• Continual Harness — Agent'ın kendi skill'larını iyileştirebilmesi (/refine komutu ile)
• Daemon-backed sessions — Terminal kapansa bile agent çalışmaya devam ediyor

Prime Agent, agent'ların sadece "öğrenilen" değil, aynı zamanda "öğrenen" varlıklar olabileceğini gösteriyor.

Bu Trend Ne Anlama Geliyor?

Agent Skills trend'inin üç önemli çıkarımı var:

1. "Prompt Engineering" → "Agent Engineering"

Artık AI'ya tek bir prompt yazmak yerine, davranışlarını yapılandıran skill paketleri oluşturuyoruz. Bu, yazılım mühendisliğinin yeni bir disiplini.

2. Mühendislik Bilgisi Codify Ediliyor

Onlarca yıllık mühendislik deneyimi — TDD, DDD, Clean Architecture, Security Best Practices — artık Markdown dosyalarında agent'lar tarafından uygulanabilir formda.

3. "Doğru Şekilde Çalışan AI" Mümkün

Skills ile donatılmış bir agent, sadece kod yazan değil, test eden, review yapan, mimari düşünen, güvenlik denetimi yapan bir ekip arkadaşı haline geliyor.

Öğrenmeye Nereden Başlamalı?

Agent Skills konseptini anlamak ve kendi skill'lerinizi yazmak istiyorsanız:

1. Temelleri öğrenin: AI agent'ların nasıl çalıştığını, prompt engineering'i ve context engineering'i anlayın.
2. Mevcut skill'ları inceleyin: mattpocock/skills ve addyosmani/agent-skills repolarını fork'layın, SKILL.md dosyalarını okuyun.
3. Küçük başlayın: Tek bir iş akışı için bir skill yazın (örneğin: code review süreci).
4. İteratif geliştirin: Agent'ın davranışını gözlemleyin, skill'ı güncelleyin.

Bu alanda derinlemesine bilgi edinmek ve AI destekli geliştirme süreçlerini profesyonel düzeyde yönetmek istiyorsanız, CoddyKit üzerindeki ilgili kurslara göz atabilirsiniz. Özellikle AI/ML ve modern yazılım mühendisliği kategorilerindeki eğitimler, Agent Skills yazma ve yönetme konusunda sağlam bir temel oluşturacaktır.

Sonuç

Agent Skills, AI çağında yazılım mühendisliğinin nasıl yapılacağına dair en somut ve pratik cevaplardan biri. 311,000+ yıldız yanılıyor olamaz — geliştiriciler, AI agent'larının sadece "kod yazan" değil, "iyi mühendislik yapan" araçlar olmasını istiyor.

Ve bu istek, Markdown dosyalarıyla karşılanıyor. Bazen en güçlü çözümler, en basit formatlarda gelir.

---

Bu yazı 9 Ağustos 2026 tarihli GitHub Trending verilerine dayanmaktadır.

Yıldız sayıları makale yayınlandığı andaki gerçek değerlerdir.