SKILL.md Şablonu: Kopyala, Oluştur ve İndir

Minimal SKILL.md şablonu

Bu kopyala-yapıştır iskeletle başla. Yer tutucuları değiştir, geçerli bir skill'in olur:

---
name: my-skill
description: Bu skill'in ne yaptığı ve agent'ın ne zaman kullanması gerektiği.
---

# My Skill

Agent'ın izleyeceği adım adım talimatlar:

1. ...
2. ...
3. ...

SKILL.md frontmatter alanları

Zorunlu (herhangi bir agent'ta çalışmak için)

• name — Küçük harf, kebab-case ve skill'in klasör adıyla aynı olmalı. En fazla 64 karakter.
• description — Bir-iki cümle: skill'in ne yaptığı ve ne zaman tetikleneceği. Agent'lar skill'i yükleyip yüklemeyeceğine buna bakar, o yüzden spesifik yaz.

ProfessorGPT'de yayınlamak için ayrıca version ekle — 1.0.0 gibi bir semantik sürüm.

İsteğe bağlı

• category — ProfessorGPT kategorilerinden biri (coding, devops, security, writing, productivity, …).
• tags — 3–6 adet kebab-case etiketten oluşan YAML listesi, örn. [code-review, security].
• author — adın veya kullanıcı adın.
• license — MIT veya Apache-2.0 gibi bir SPDX tanımlayıcısı.
• allowed-tools — skill'in kullanabileceği araçların YAML listesi, örn. [Read, Edit, Bash].
• metadata — ekstra her şey için serbest biçimli bir eşleme.

Frontmatter'ın altındaki gövde talimatları taşır. İsteğe bağlı paketli dosyalar (script, referans) aynı klasörde durabilir.

Daha dolu, yayınlanabilir bir SKILL.md

Aynı iskelet, opsiyonel alanlar doldurulmuş — yayınlamaya hazır:

---
name: code-reviewer
description: Bir diff'i hata, güvenlik ve stil açısından inceler. Kullanıcı kod veya pull request incelemesi istediğinde kullan.
version: 1.0.0
category: coding
tags: [code-review, security]
author: kullanici-adin
license: MIT
allowed-tools: [Read, Grep]
---

# Code Reviewer

1. Diff'i oku ve değişikliğin amacını not et.
2. Önce doğruluk hatalarını, sonra güvenliği, sonra stili işaretle.
3. Her bulguya bir önem derecesi ve file:line referansı ver.
4. Engelleyici olan her şey için somut bir çözüm öner.

SKILL.md'ini oluştur ve indir

Geçerli bir SKILL.md'i canlı oluşturmak için aşağıdaki alanları doldur, sonra kopyala ya da dosyayı indir:

Domain'e özel şablonlar

Genel iskeletler her yerde; asıl ihtiyaç duyulan bu dikey başlangıçlardır.

Güvenlik incelemesi

---
name: security-review
description: Bir kod değişikliğini injection, yetkilendirme, sır ve güvensiz varsayılanlar açısından denetler. Bir diff veya PR'ı güvenlik açısından incelerken kullan.
---

# Security Review

1. Girdileri injection açısından kontrol et (SQL, shell, path, template).
2. Her yeni endpoint ve mutation'da yetkilendirmeyi doğrula.
3. Sabit kodlanmış sırları ve güvensiz varsayılan ayarları işaretle.
4. Her bulguyu önem derecesi ve file:line referansıyla raporla.

Müşteri destek yanıtı

---
name: support-reply
description: Bir talepten marka diline uygun destek yanıtı hazırlar. Bir müşteri mesajını yanıtlarken kullan.
---

# Support Reply

1. Müşterinin sorununu tek cümleyle yeniden ifade et.
2. Çözümü veya sonraki adımı sade bir dille ver.
3. Tonu sıcak, kısa ve jargonsuz tut.
4. Net bir eylem çağrısıyla bitir.

E-ticaret ürün açıklaması

---
name: product-description-writer
description: Bir özellik listesinden SEO uyumlu e-ticaret ürün açıklamaları yazar. Bir ürün listelemesini hazırlarken veya yeniden yazarken kullan.
---

# Product Description Writer

1. Ürünün özelliklerini, malzemelerini ve temel faydalarını oku.
2. Tek satırlık bir kanca, ardından 2–3 fayda cümlesi, sonra madde işaretli bir özellik listesi yaz.
3. Hedef kelimeyi ilk cümlede doğal kullan; anahtar kelime doldurması yapma.
4. Tonu marka diline uygun tut ve kısa bir eylem çağrısıyla bitir.

SaaS onboarding

---
name: saas-onboarding-guide
description: Yeni bir SaaS kullanıcısı için adım adım bir onboarding mesajı hazırlar. Bir kaydı karşılarken veya ilk kurulumu anlatırken kullan.
---

# SaaS Onboarding Guide

1. Kullanıcının planını ve birincil kullanım amacını belirle.
2. En yüksek değerli ilk üç eylemi sırayla ver.
3. Her adımı ilgili ayara veya dokümana bağla.
4. "Aha" anını getiren ipucuyla ve yardım teklifiyle bitir.

Çok-model uyumluluğu

Yukarıdaki şablon modelden bağımsızdır. Aynı dosya Claude (~/.claude/skills), Codex (~/.agents/skills) ve Gemini CLI'ye (~/.gemini/config/skills) kurulur — araç başına tam kurulum yolu için Claude ve Codex rehberlerine bak.

Yaygın frontmatter hataları

• name'in klasörle eşleşmemesi ya da boşluk/büyük harf kullanımı.
• Muğlak bir description ("kodla yardım eder") — agent ne zaman tetikleyeceğini anlayamaz. Ne ve ne zaman'ı belirt.
• Gövdenin ~500 satırı geçmesi — uzun referansları ayrı dosyalara taşı.

Sihirbaz mı tercih edersin?

Skill Builder aynı alanları doğrulamayla adım adım gezdirir ya da gerçek skill'lere göz atıp birini uyarla.