Claude Kodunu Bir Laravel Geliştiricisi Gibi Düşünmeye Öğretmek: Ajan Yeteneklerinin Tanıtımı

Son zamanlarda Claude Code ile projeler geliştirmekteyim ve beni rahatsız eden bir şey vardı: Her yeni proje sıfırdan başlıyordu. Claude, Pest’i PHPUnit yerine kullandığımı, Action sınıfları üzerine görüşlerim olduğunu ya da temel yığınımın Livewire 4 + Flux UI olduğunu bilmiyordu. Her oturumda aynı şeyleri yeniden açıklamak zorunda kalıyordum.

Çözüm daha uzun istemler yazmak değildi. Çözüm beceriler geliştirmekti.

Claude Kod Becerileri Nedir?

Claude Code, Claude’a belirli bir alanda nasıl davranacağını anlatan yapılandırılmış bir Markdown dosyası olan SKILL.md konvansiyonunu destekler. Bunu, görev için kapsamlı bir sistem istemi gibi düşünün, yeniden kullanılabilir bir modül olarak paketlenmiştir.

Bir beceri şu konumlarda bulunabilir:

• ~/.claude/skills/ — Tüm projelerinizde genel olarak kullanılabilir
• .claude/skills/ — Belirli bir projeye özgü

Claude Code, ilgili bir istekle karşılaştığında, eşleşen beceriyi okur ve talimatlarına uyar. Beceri, ön bilgiler, tetikleyici ifadeler, adım adım iş akışları ve şablonlar gibi referans dosyalarını içerebilir.

Neden agent-skills’i Geliştirdim?

20’den fazla açık kaynaklı Laravel paketi yönetiyorum ve 2015’ten beri Laravel geliştiricilerini eğitiyorum. Yıllarca aynı mimariyi — sözleşmeler, trait’ler, action sınıfları, servis sağlayıcıları yazarak — geçirdiğim için sadece kodu tekrar etmediğimin, aynı zamanda kararları da tekrar ettiğimin farkına vardım.

agent-skills, bu kararları Claude Code’a kodlamak için bir yolum. Claude’a sıfırdan istem yazmak yerine, oturduğumda bir şey inşa etmek için kullandığım aynı zihinsel modeli veriyorum.

İçinde Neler Var?

Repo mevcutta dört alanı kapsamaktadır:

Geliştirme ve Kalite

• pest-testing — Livewire desteği, mimari testler ve fabrika kalıbı ile Pest testleri üretir. arch()->preset()->laravel() kontrolleri istediğimi bilir, sadece özellik testleri değil.
• code-quality — PHPStan + Pint + Rector iş akışını otomatikleştirir. Bunu bir PR öncesinde çalıştırın, sonrasında değil.
• php-best-practices — PHP 8.2+ modernizasyonu ve kod incelemesi, eksik readonly özellikler, türü belirtilmemiş parametreler ve yapıcı yükseltim fırsatları gibi konuları işaret eder.
• design-patterns — Karar matrisine sahip Laravel’e özgü kalıp rehberliği. Bu bir Job, Action veya Pipeline mı olmalı? Beceri, Claude’un bunu bağlamda cevaplamasına yardımcı olur.
• livewire-flux — Livewire 4 için Flux UI ile bileşen kalıpları. Artık bileşen yapımımdan sıfırdan bahsetmeme gerek kalmadı.

Proje Yaşam Döngüsü

• project-docs — Ürün spesifikasyonundan sonrası değerlendirmeye, tam SDLC dökümantasyon aracı zinciri.
• project-requirements — SRS, kullanıcı hikayeleri, teklifler ve wireframe’ler. Bir müşteri brifingi geldiğinde hızlı bir şekilde yapılandırılmış çıktı almanız için kullanışlı.
• roadmap-generator — Markdown ve stilize HTML ile aşamalı yol haritaları. Müşterilere teklif sunarken veya sprint planlarken bunu kullanırım.
• api-lifecycle — Yönetişim yoluyla API tasarımı. Versiyonlama, deprece yerler ve OpenAPI dökümantasyon kalıplarını kapsar.

Dağıtım ve Operasyonlar

• ci-cd-pipeline — GitHub Actions + Docker iş akışı otomasyonu. php artisan optimize ve göç güvenliği kontrolleri gibi Laravel’e özgü adımları içerir.
• package-dev — Laravel paket iskelet oluşturma, test etme ve yayınlama otomasyonu. Bu kişisel; tüm Cleanique Coders paketlerimde kullandığım aynı yapıyı kodlar.

İş ve Tasarım

• sales-planner — Fiyatlandırma, teklif oluşturmada, pazarlama metni ve mali planlama. Özellikle hızlı bir şekilde müşteri brifinginden teklife geçmeniz gereken soloprenörler için kullanışlı.
• svg-logo-system — Çoklu platformda dışa aktarmalı SVG logo tasarımı. Geliştirici ve tasarımcı olduğunuzda kullanışlıdır.

Meta

• self-update — Bir oturum sırasında öğrenilen düzeltmeler, tercihler ve püf noktaları ile CLAUDE.mdyi otomatik günceller. Bu zamanla birikir.

Beceri Yapısı

Her beceri tutarlı bir formatı takip eder:

skills/[skill-name]/
├── SKILL.md              # Beceri tanımı ve talimatlarla YAML ön bilgisi
└── references/           # Şablonlar, kalıplar, örnekler
    ├── template-a.md
    └── patterns-b.md

SKILL.md ön bilgisi şu şekilde görünmektedir:

---
name: pest-testing
metadata:
  compatible_agents: [claude-code]
  tags: [testing, pest, laravel, livewire]
description: "
  Generates Pest PHP tests for Laravel applications.
  Trigger phrases: "write tests", "generate test", "tulis test"...
---

description bölümünün hem İngilizce hem de Malayca tetikleyici ifadeleri içerdiğine dikkat edin. Bu, isteme sürekli geçiş yaptığım için kasti bir durumdur.

30 Saniyede Kurulum

# Tüm becerileri genel olarak yükleme
curl -fsSL https://raw.githubusercontent.com/nasrulhazim/agent-skills/main/install.sh | bash

Bu, her projede becerilerin kullanılabilir olduğu ~/.claude/skills/ dizinine her şeyi bırakır. Sadece bir tanesine ihtiyacınız varsa:

cp -r skills/pest-testing /path/to/your-project/.claude/skills/

Kickoff.my Temeli

Pek çok beceri, Kickoff.my bootstrap yığınını başlangıç noktası olarak varsayıyor:

• Livewire 4 + Flux UI
• Pest ile mimari testi
• PHPStan / Larastan
• Rector + Laravel Pint
• GitHub Actions CI
• Spatie Permission, Activity Log, Media Library

Kickoff’un zaten sağladığının üzerine inşa etmeyi amaçlıyoruz. Eğer Kickoff kullanmıyorsanız, beceriler yine de çalışacaktır — sadece referans dosyalarında bazı varsayımları ayarlamanız gerekecektir.

Uygulamada Görmek

Bugün sabah çalıştırdığım üç beceri — ekstra bir istem olmadan, sadece eğik komutu çağırarak işe yaradı.

project-docs: Dökümantasyon Sağlık Raporu

Bu, project-docs becerisinin kendisi için bir sağlık kontrolü gerçekleştirmesi. 18/100 puan aldı — bu sert duyulsa da, tam anlamıyla amaç da bu. Klasör yapısını, rozeti uyumluluğunu, SDLC kapsamını denetledi ve belirli yüksek öncelikli boşlukları rahatsız etti: eksik docs/ dizini, ürün spesifikasyonu yok, API dökümanları yok, destek iş akışı yok. Ve ardından bana öncelikli bir eylem listesi sundu.

Sadece “belge durumunuz daha iyi olabilir.” gibi belirsiz bir şey değil. Net bir puan, bir ayrıntı ve beş kesin sonraki adım verildi. İşte bir beceri gerçek iş yapıyor.

/svg-logo-system: Marka Brifingi Alma

/svg-logo-system komutunu Kickoff projesinin içerisinde çalıştırdım. Beceri anında marka brifingini almak için devreye girdi — isim, hedef kitle, kişilik anahtar kelimeleri, renk yönelimi ve stil tercihini soruyordu. Cevaplarımı gündelik bir paragraflada verdim (İngilizce ve Malayca karıştırarak) ve ihtiyacı olan her şeyi çıkardı.

Marka Brifingi Çıkarma → 25 SVG Kavramı

Gündelik paragrafımdan, beceri tam bir marka brifingi yapılandırdı: Kickoff, Laravel geliştiricileri, minimal + geliştirici odaklı kişilik, Emerald #059669 ana, #0B1120 koyu arka plan, Figtree’den esinlenen temiz sans-serif. Ardından doğrudan 25 SVG logo kavramı üretmeye geçti.

Çıktı: Etkileşimli Galeride 25 Kavram

İşte becerinin ürettiği şey — emerald + koyu deniz mavisi paletini koruyan 25 farklı kavramın etkileşimli bir HTML galerisi. Rocket Wordmark, Bracket Code, Terminal Prompt, Soyut K Yolları, Terminal Penceresi gerçek composer komutlarını gösteriyor — her kavram markaya uygun ve geliştiriciye özgü. Önizlemede hem karanlık hem de aydınlık mod arasında geçiş yapabilirsiniz.

Bir kavram seçtiğinizde beceri, bir sonraki adımda ne demeniz gerektiğini kesinlikle belirtir: “Seçildi: #21 — Speed Lines. Devam etmek için Claude’a ‘#21 ile devam et’ de.” Tüm iş akışı — brifing alma, kavram üretimi, seçim, iyileştirme — hiçbir belirsizlik olmadan beceri tarafından yönlendirilir.

Daha Büyük Resim

Beceriler, AI destekli geliştirme hakkında ileriye dönük düşündüğüm şekil. Claude’a uzun bir istem vermektense, ona tekrar kullanılabilir bir uzmanlık modülü vermek.

Aynı şekilde, Eloquent kullandığımızda ham SQL yazmıyorsak, her yeni oturum açtığımızda konvansiyonlarımızı yeniden açıklamamalıyız.

Ayrıca, bu doğrudan 2026 eğitim programıma besleniyor; amacım AI’nin sadece bir kod tamamlama aracı olmadığını göstermek — kendi mimari yargınızı yansıtacak şekilde yapılandırabileceğiniz bir sistemdir.

Yenilikçi bir Laravel geliştiricisi iseniz ve yığınınızı tekrar açıklamaktan bıktıysanız, agent-skills‘i denemenizi öneriyorum. Ve kendi paylaşmaya değer becerileriniz varsa, PR’lar açıktır.

Repo: github.com/nasrulhazim/agent-skills