Beceriler

Beceriler nedir

supastack, Agent Skills ile gelir: iş eşleştiğinde kodlama ajanınızın yüklediği kısa, göreve odaklı talimatlar. Ajan, her prompt'ta kit'in kurallarını tahmin etmek yerine özellikler, ödemeler, veritabanı değişiklikleri ve testler için aynı adımları izler. Beceriler açık Agent Skills biçimini izler; bu yüzden Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI ve diğer uyumlu ajanlarda çalışır.

Becerilerin yeri

Beceriler .agents/skills/ altında durur — her beceri için içinde SKILL.md olan bir klasör. Claude Code için .claude/skills/ altında aynı kopyalar bulunur.

Hangi ajanlar okur

Codex, Cursor, GitHub Copilot, Gemini CLI ve OpenCode .agents/skills/ okur. Claude Code .claude/skills/ okur. İsteğiniz açıklamayla eşleştiğinde ajanınız beceriyi otomatik seçer — ya da adını verirsiniz: “use the database-schema-change skill”.

Hangi depolarla gelir

all-platforms deposu tüm becerileri içerir. web, mobile ve desktop depoları kendilerine uygulanan becerileri içerir; uçtan uca test ve CI becerileri yalnızca all-platforms deposuyla birlikte gönderilir.

Kurulum ve ortam

Kit'i çalıştırmak, dağıtmak ve yapılandırmak için beceriler.

• Yerel ortam kurulumu (local-environment-setup) — yerel ortamı kurarken veya onarırken: ilk clone, eksik ya da bozuk .env, Postgres, migrasyonlar veya portlar.
• Dağıtım ve ortam değişkenleri (deploy-and-env-vars) — dağıtırken, barındırma hedefi seçerken veya bir ortam değişkeni eklerken/değiştirirken.
• Bağımlılık ekleme (adding-a-dependency) — bir npm bağımlılığı eklerken, yükseltirken, taşırken veya kaldırırken; ya da CI lisans/denetim kontrolünde kalınca.
• Upstream'den yükseltme (upgrading-from-upstream) — üzerine ürün kurduğunuz supastack'in daha yeni bir sürümünü alırken.

Özellik geliştirme

Her platforma ürün yüzeyi ekleyen beceriler.

• Web özelliği ekleme (add-a-web-feature) — kendi verisi, server action'ları, navigasyonu ve testleri olan bir ürün sayfası veya bölümü için.
• API ucu ekleme (add-an-api-endpoint) — herkese açık bir /api/v1 ucu, OpenAPI dokümanı veya API anahtarı scope'ları eklerken/değiştirirken.
• UI bileşeni ekleme (add-a-ui-component) — kit'in stil kurallarına uyan bir bölüm, blok, form kontrolü veya yeniden kullanılabilir bileşen için.
• Tema veya stili değiştirme (change-the-theme-or-style) — ürünün görünümünü değiştirirken: tasarım stili, renk paketi, yoğunluk, radius, font veya düzen.
• Pazarlama sayfası veya blog yazısı ekleme (add-a-marketing-page-or-blog-post) — herkese açık sayfa, fiyatlandırma sayfası, yasal sayfa, blog yazısı veya dokümantasyon rehberi eklerken/düzenlerken.
• Mobil ekran ekleme (add-a-mobile-screen) — Expo mobil uygulamasında ekran eklerken veya değiştirirken.
• Masaüstü yeteneği ekleme (add-a-desktop-capability) — Tauri masaüstü uygulamasını değiştirirken: pencere, tepsi, genel kısayol veya otomatik güncellemeler.
• Bildirim ekleme (add-a-notification) — uygulama içi bildirim, push bildirimi veya digest öğesi için.

Auth ve ödemeler

Giriş, faturalandırma ve plan becerileri.

• Auth yöntemi ekleme (add-an-auth-method) — girişi değiştirirken: sosyal sağlayıcılar, magic link'ler, e-posta kodları, passkey'ler veya iki faktör.
• Ödeme sağlayıcısı ekleme (add-a-payment-provider) — bir faturalandırma sağlayıcısını etkinleştirirken veya checkout, müşteri portalı ve webhook'lu yeni bir adaptör yazarken.
• Plan ve fiyat değiştirme (change-plans-and-pricing) — plan eklerken, yeniden adlandırırken veya fiyatını değiştirirken: fiyatlar, denemeler, koltuklar, yetkiler, kullanım limitleri veya krediler.

Veri ve entegrasyonlar

Şema, AI, job'lar, e-posta, depolama ve çeviriler için beceriler.

• Veritabanı şema değişikliği (database-schema-change) — tablo, sütun, indeks veya ilişki eklerken/değiştirirken ve migrasyon üretirken.
• AI özelliği ekleme (add-an-ai-feature) — model çağrısı, sohbet veya ajan aracı, dayanıklı AI görevi, bütçeler veya bring-your-own-key için.
• Arka plan işi ekleme (add-a-background-job) — istekten sonra, zamanlayıcıyla veya workspace başına çalışan işler için.
• E-posta ekleme veya düzenleme (add-or-edit-an-email) — işlemsel e-posta eklerken/değiştirirken veya teslim eden sağlayıcıyı değiştirirken.
• Dosya depolama kullanma (use-file-storage) — avatar, logo veya ek gibi yükleme ve saklanan dosyalar için.
• Çeviri ekleme (add-translations) — kullanıcıya görünen metin eklerken/değiştirirken, çevirirken veya locale eklerken.

Kalite ve yayın

Testler, doğrulama, review'lar ve CI için beceriler.

• Birim testi yazma (writing-unit-tests) — Vitest birim veya entegrasyon testleri yazarken/düzeltirken.
• E2E testi yazma (writing-e2e-tests) — Playwright uçtan uca testleri yerel ya da CI'da eklerken/düzeltirken.
• Değişiklikleri doğrulama (verify-changes) — handoff, commit veya pull request öncesinde doğru kontrolleri seçip çalıştırmak için.
• Başarısız CI çalıştırmasında hata ayıklama (debugging-a-failing-ci-run) — bir GitHub Actions çalıştırması başarısız olduğunda nedeni bulup düzeltmek için.
• PR inceleme (reviewing-a-pr) — pull request veya diff'i doğruluk, workspace izolasyonu ve kurallar açısından incelerken.

Kendi becerinizi ekleyin

Frontmatter'ındaki name ile aynı ada sahip bir klasör ekleyin; ne zaman kullanılacağını söyleyen bir name ve description yazın. Her ajan bulabilsin diye .claude/skills/ altına da kopyalayın.