Addyosmani Skills

web-quality-skills/skills/accessibility

WCAG 2.2 yönergelerini takip ederek web erişilebilirliğini denetleyin ve iyileştirin. "Erişilebilirliği iyileştir", "a11y denetimi", "WCAG uyumluluğu", "ekran okuyucu desteği", "klavye navigasyonu" veya "erişilebilir hale getir" istendiğinde kullanın.

agent-skills/skills/api-and-interface-design

Kararlı API ve arayüz tasarımına rehberlik eder. API'ler, modül sınırları veya herhangi bir genel arayüz tasarlarken kullanın. REST veya GraphQL uç noktaları oluştururken, modüller arasında tip sözleşmeleri tanımlarken veya ön yüz ile arka yüz arasında sınırlar belirlerken kullanın.

web-quality-skills/skills/best-practices

Modern web geliştirme en iyi uygulamalarını güvenlik, uyumluluk ve kod kalitesi için uygulayın. "En iyi uygulamaları uygula", "güvenlik denetimi", "kodu modernleştir", "kod kalitesi incelemesi" veya "güvenlik açıklarını kontrol et" istendiğinde kullanın.

agent-skills/skills/browser-testing-with-devtools

Gerçek tarayıcılarda Chrome DevTools MCP üzerinden test yapar. Tarayıcıda çalışan herhangi bir şeyi oluştururken veya hata ayıklarken kullanın. DOM'u incelemeniz, konsol hatalarını yakalamanız, ağ isteklerini analiz etmeniz, performans profili çıkarmanız veya gerçek çalışma zamanı verileriyle görsel çıktıyı doğrulamanız gerektiğinde kullanın. chrome-devtools MCP sunucusunun yapılandırılmış olmasını gerektirir.

agent-skills/skills/ci-cd-and-automation

CI/CD pipeline kurulumunu otomatikleştirir. Derleme ve dağıtım hatlarını kurarken veya değiştirirken kullanın. Kalite kapılarını otomatikleştirmeniz, CI'da test çalıştırıcılarını yapılandırmanız veya dağıtım stratejileri oluşturmanız gerektiğinde kullanın.

agent-skills/skills/code-review-and-quality

Çok eksenli kod incelemesi yapar. Herhangi bir değişikliği birleştirmeden önce kullanın. Kendiniz, başka bir ajan veya bir insan tarafından yazılmış kodu incelerken kullanın. Kodun ana dala girmeden önce birden çok boyutta kalitesini değerlendirmeniz gerektiğinde kullanın.

agent-skills/skills/code-simplification

Kodu netlik için sadeleştirir. Davranışı değiştirmeden kodu yeniden düzenlerken kullanın. Kod çalışıyor ancak olması gerekenden daha zor okunuyor, bakımı yapılıyor veya genişletiliyorsa kullanın. Gereksiz karmaşıklık biriktirmiş kodu incelerken kullanın.

agent-skills/skills/context-engineering

Ajan bağlam kurulumunu optimize eder. Yeni bir oturum başlatırken, ajan çıktı kalitesi düştüğünde, görevler arasında geçiş yaparken veya bir proje için kural dosyaları ve bağlam yapılandırmanız gerektiğinde kullanın.

web-quality-skills/skills/core-web-vitals

Daha iyi sayfa deneyimi ve arama sıralaması için Core Web Vitals (LCP, INP, CLS) optimizasyonu yapın. "Core Web Vitals'ı iyileştir", "LCP'yi düzelt", "CLS'yi azalt", "INP'yi optimize et", "sayfa deneyimi optimizasyonu" veya "düzen kaymalarını düzelt" istendiğinde kullanın.

agent-skills/skills/debugging-and-error-recovery

Sistematik kök neden hata ayıklamayı yönlendirir. Testler başarısız olduğunda, derlemeler bozulduğunda, davranış beklentilerle eşleşmediğinde veya beklenmedik bir hatayla karşılaştığınızda kullanın. Tahmin yürütmek yerine kök nedeni bulmak ve düzeltmek için sistematik bir yaklaşıma ihtiyaç duyduğunuzda kullanın.

agent-skills/skills/deprecation-and-migration

Kullanımdan kaldırma ve geçişi yönetir. Eski sistemleri, API'leri veya özellikleri kaldırırken kullanın. Kullanıcıları bir uygulamadan diğerine geçirirken kullanın. Mevcut kodu sürdürmeye veya sonlandırmaya karar verirken kullanın.

agent-skills/skills/documentation-and-adrs

Kararları ve dokümantasyonu kaydeder. Mimari kararlar alırken, genel API'leri değiştirirken, özellikler yayınlarken veya gelecekteki mühendislerin ve ajanların kod tabanını anlaması için gerekli olacak bağlamı kaydetmeniz gerektiğinde kullanın.

agent-skills/skills/doubt-driven-development

Her önemsiz olmayan kararı, yürürlüğe girmeden önce yeni bağlamlı bir çekişmeli incelemeye tabi tutar. Doğruluğun hızdan daha önemli olduğu durumlarda, yabancı bir kod üzerinde çalışırken, risklerin yüksek olduğu (üretim, güvenlik hassasiyeti olan mantık, geri döndürülemez işlemler) veya güvenli bir çıktıyı daha sonra hata ayıklamaktansa şimdi doğrulamanın daha ucuz olacağı her an kullanın.

agent-skills/skills/frontend-ui-engineering

Üretim kalitesinde, erişilebilir, duyarlı kullanıcı arayüzleri oluşturur. Arayüzler ve sayfalar oluştururken veya değiştirirken, bileşenler geliştirirken, düzenler uygularken, WCAG erişilebilirlik gereksinimlerini karşılarken, durum yönetimi yaparken veya çıktının yapay zeka tarafından üretilmiş gibi değil, üretim kalitesinde görünmesi ve hissettirmesi gerektiğinde kullanın.

agent-skills/skills/git-workflow-and-versioning

Git iş akışı uygulamalarını yapılandırır. Herhangi bir kod değişikliği yaparken kullanın. Commit, branching, çakışma çözümleme veya birden fazla paralel akışta çalışmayı organize etmeniz gerektiğinde kullanın. Bir sürüm çıkarırken, semantik versiyon artışı seçerken, etiketleme yaparken veya changelog yazarken kullanın.

agent-skills/skills/idea-refine

Ham fikirleri, yapılandırılmış ıraksak ve yakınsak düşünme yoluyla keskin, uygulanabilir kavramlara dönüştürür. Bir fikir hâlâ belirsiz olduğunda, bir plana bağlanmadan önce varsayımları strese test etmeniz gerektiğinde veya tek bir seçenekte birleşmeden önce seçenekleri genişletmek istediğinizde kullanın. "Fikir üret", "bu fikri geliştir" veya "planımı strese test et" ifadeleriyle tetiklenir.

agent-skills/skills/incremental-implementation

Değişiklikleri aşamalı olarak teslim eder. Birden fazla dosyayı etkileyen herhangi bir özellik veya değişiklik uygulanırken kullanın. Bir kerede büyük miktarda kod yazmak üzereyken veya bir görev tek adımda tamamlanamayacak kadar büyük hissettirdiğinde kullanın.

agent-skills/skills/interview-me

Kullanıcının gerçekte ne istediğini, ne istemesi gerektiğini düşündüğü şey yerine çıkarır. Bunu, altta yatan niyet hakkında ~%95 güvene ulaşana kadar her seferinde tek soru soran bir görüşme yoluyla başarır. Bir talep belirsiz olduğunda ("bana X'i yap" ama "kimin için" veya "neden şimdi" olmadan), kullanıcı açıkça çağırdığında ("interview me", "grill me", "are we sure?", "stress-test my thinking") veya herhangi bir plan, şartname ya da kod var olmadan önce belirsiz gereksinimleri sessizce doldururken kendinizi yakaladığınızda kullanın.

agent-skills/skills/observability-and-instrumentation

Kodu enstrümante ederek üretim davranışının görünür ve teşhis edilebilir olmasını sağlar. Loglama, metrik, izleme veya uyarı eklerken kullanın. Üretimde çalışan ve çalıştığına dair kanıta ihtiyaç duyduğunuz bir özelliği dağıtırken kullanın. Üretim sorunları raporlandığında ancak mevcut verilerden ne olduğunu anlayamadığınızda kullanın.

web-quality-skills/skills/performance

Web performansını optimize ederek daha hızlı yüklenme ve daha iyi kullanıcı deneyimi sağlar. "Sitemi hızlandır", "performansı optimize et", "yüklenme süresini azalt", "yavaş yüklemeyi düzelt", "sayfa hızını iyileştir" veya "performans denetimi" istendiğinde kullanılır.

agent-skills/skills/performance-optimization

Uygulama performansını frontend, backend, sorgular ve veritabanları genelinde optimize eder. Performans gereksinimleri olduğunda, performans düşüşlerinden şüphelenildiğinde, Core Web Vitals veya yükleme sürelerinin iyileştirilmesi gerektiğinde, N+1 sorgu desenlerinin düzeltilmesi gerektiğinde veya profil oluşturma darboğazları ortaya çıkardığında kullanın.

agent-skills/skills/planning-and-task-breakdown

İşi sıralı görevlere böler. Bir spesifikasyonunuz veya net gereksinimleriniz olduğunda ve işi uygulanabilir görevlere ayırmanız gerektiğinde kullanın. Bir görev başlamak için çok büyük göründüğünde, kapsamı tahmin etmeniz gerektiğinde veya paralel çalışma mümkün olduğunda kullanın.

agent-skills/skills/security-and-hardening

Kodu güvenlik açıklarına karşı sağlamlaştırır. Kullanıcı girdisi, kimlik doğrulama, veri depolama veya harici entegrasyonlarla çalışırken kullanın. Güvenilmeyen verileri kabul eden, kullanıcı oturumlarını yöneten veya üçüncü taraf hizmetlerle etkileşime giren herhangi bir özellik oluştururken kullanın.

web-quality-skills/skills/seo

Arama motoru görünürlüğü ve sıralaması için optimize et. "SEO'yu iyileştir", "arama için optimize et", "meta etiketleri düzelt", "yapılandırılmış veri ekle", "site haritası optimizasyonu" veya "arama motoru optimizasyonu" istendiğinde kullan.

agent-skills/skills/shipping-and-launch

Üretim lansmanlarını hazırlar. Üretime dağıtım yapmaya hazırlanırken kullanın. Lansman öncesi kontrol listesine ihtiyacınız olduğunda, izleme kurarken, aşamalı bir dağıtım planlarken veya bir geri alma stratejisine ihtiyacınız olduğunda kullanın.

agent-skills/skills/source-driven-development

Her uygulama kararını resmi dokümantasyona dayandırır. Yetkili, kaynakça atıflı ve güncelliğini yitirmiş desenlerden arınmış kod istediğinizde kullanın. Doğruluğun önemli olduğu herhangi bir framework veya kütüphane ile geliştirme yaparken kullanın.

agent-skills/skills/spec-driven-development

Kodlamadan önce spesifikasyonlar oluşturur. Yeni bir proje, özellik veya önemli bir değişikliğe başlarken ve henüz hiçbir spesifikasyon mevcut değilken kullanın. Gereksinimler net olmadığında, belirsiz olduğunda veya yalnızca belirsiz bir fikir olarak var olduğunda kullanın.

agent-skills/skills/test-driven-development

Geliştirmeyi testlerle yönlendirir. Herhangi bir mantık uygularken, herhangi bir hatayı düzeltirken veya herhangi bir davranışı değiştirirken kullanın. Kodun çalıştığını kanıtlamanız gerektiğinde, bir hata raporu geldiğinde veya mevcut işlevselliği değiştirmek üzereyken kullanın.

agent-skills/skills/using-agent-skills

Ajan becerilerini keşfeder ve çağırır. Bir oturum başlatırken veya mevcut göreve hangi becerinin uygulanacağını keşfetmeniz gerektiğinde kullanın. Bu, diğer tüm becerilerin nasıl keşfedileceğini ve çağrılacağını yöneten meta-beceridir.

web-quality-skills/skills/web-quality-audit

Performans, erişilebilirlik, SEO ve en iyi uygulamaları kapsayan kapsamlı web kalite denetimi. "Sitemi denetle", "web kalitesini gözden geçir", "lighthouse denetimi çalıştır", "sayfa kalitesini kontrol et" veya "web sitemi optimize et" dendiğinde kullanılır.