Başlangıç Rehberi: Skill nedir, Claude Code ve Codex'e nasıl kurulur?

Kısa cevap: Claude Code'a skill kurmak için terminal gerekmez. Claude masaüstü uygulamasında Code sekmesini (ya da ChatGPT masaüstü uygulamasında Codex'i) aç, bu yazıdaki kurulum promptunu yapıştır ve skill'in GitHub linkini ekle. Skill global olarak kurulur: Claude Code'da ~/.claude/skills, Codex'te ~/.agents/skills klasörüne. Yeni bir oturum açıp Claude Code'da /skill-adı, Codex'te $skill-adı yazarak çağırırsın.

Bir skill'in ne işe yaradığını okudun, hoşuna gitti, hatta "bunu yarın sabah ilk iş kurarım" diye bir kenara not ettin; sonra kurulum kısmına geldin ve karşına /plugin marketplace add, npx skills add ve siyah bir ekran çıktı.

Sekmeyi kapattın.

Bu rehber tam o an için. Tek satır komut yazmayacaksın. Claude'a ya da Codex'e hazır bir prompt yapıştıracaksın, gerisini o yapacak. Ben de böyle kuruyorum, çünkü daha hızlı.

Sonunda üç şeyi bileceksin: skill'i bir kere kurup her yerde kullanmak, onu adıyla çağırmak ve işleri birbirine karıştırmamak.

Claude skill nedir?

Skill (Agent Skill), Claude'a ya da Codex'e belirli bir işi nasıl yapacağını anlatan, içinde SKILL.md dosyası bulunan bir klasör. Anthropic'in başlattığı açık bir standart; aynı skill hem Claude Code'da hem Codex'te çalışıyor.

Basitçe: yapay zekâya verdiğin bir tarif kartı. Malzemeler zaten mutfakta: model yazmayı, hesaplamayı, araştırmayı biliyor. Tarif kartı ona "bu yemeği şu sırayla, şu ölçüyle yap" diyor. Kartın içinde bir talimat dosyası (SKILL.md) ve bazen birkaç yardımcı dosya var. Hepsi tek bir klasör.

Kartı iki yere koyabilirsin. Mutfağın ortak tarif defterine koyarsan her yemekte elinin altında olur, buna global kurulum diyoruz. Tek bir tencerenin üstüne yapıştırırsan sadece o yemekte işe yarar. Yeni başlıyorsan global kur. Kafa yorma.

Üç yerden birinde kullanacaksın:

• Claude masaüstü uygulaması, Code sekmesi. Bu rehberin asıl konusu. Skill'ler bilgisayarında duruyor.
• ChatGPT masaüstü uygulamasında Codex. Aynı tarif kartlarını okuyor, sadece defteri başka bir klasörde.
• Tarayıcıda claude.ai. Bilgisayarındaki klasörü göremiyor. Skill'i hesabına yüklemen gerekiyor, en sonda ayrıca anlattım.

Klasör adlarını ezberlemene gerek yok. Aşağıdaki prompt hangi uygulamada çalıştığını kendisi anlıyor ve skill'i doğru deftere yazıyor. Sen sadece yapıştırıyorsun.

Adım 1: Uygulamayı aç, bir çalışma klasörü göster

İlk iş, Claude'a çalışacağı çekmeceyi göstermek. Claude yalnızca gösterdiğin klasörün içini görür, ürettiği dosyaları da oraya bırakır. Bütün masaüstünü göstermek, tamirciye evin anahtarını verip "sadece mutfağa bak" demek gibi.

Belgeler'in içinde "Claude İşleri" diye bir klasör aç ve her iş için içine ayrı bir alt klasör koy: satış raporu için bir tane, LinkedIn metni için bir tane, müşteri sunumu için bir tane; o işin Excel'i, PDF'i ve notları hep kendi alt klasöründe dursun. Dağınıklık burada başlıyor. Burada da bitiyor.

Claude'da üstten Code sekmesine geç, soldan New session'a bas, prompt kutusunun altındaki Project folder alanından klasörünü seç.

Codex'te ChatGPT masaüstü uygulamasını aç, Add new project ya da Open folder (Mac'te ⌘O) ile aynı klasörü seç.

Skill kurarken hangi klasörü seçtiğin fark etmez, kurulum yine global olur. Klasör asıl işi yaparken önemli.

Adım 2: Skill'i tek prompt'la kur

Aşağıdaki promptu kopyala. Kurmak istediğin skill'in GitHub linkini "SKILLS TO INSTALL" satırının altına yapıştır ve gönder. Linkin yoksa boş bırak, sana soracak. Hazır bir liste istersen Haftanın AI Skill'leri yazılarının en üstünde, o haftanın skill'lerini dolu getiren bir kopyası duruyor.

Prompt İngilizce, çünkü modeller talimatı İngilizcede daha az yanlış anlıyor. Sana Türkçe cevap vermesini promptun içine yazdım.

You are my setup assistant. I am not a developer, so please do everything for me.

LANGUAGE
- Always reply to me in Turkish, in short and simple sentences.
- Avoid jargon. If you must use a technical word, explain it in one plain sentence.

GOAL
Install the skill(s) below GLOBALLY, so they are available in every folder and in every new session.

SKILLS TO INSTALL
- (paste the GitHub link of the skill here, one per line)
If this list has no real link, ask me for the GitHub link first.

STEP 1 - Find out where you are running
- Claude Code (Claude desktop app, Code tab): the global skills folder is ~/.claude/skills/
- Codex (ChatGPT desktop app): the global skills folder is ~/.agents/skills/
- If you are in a cloud or browser session that cannot see my computer (for example claude.ai or Codex cloud), tell me this in Turkish and do not install anything. Only offer STEP 6.
- If you are not sure where you are running, ask me.

STEP 2 - Look before you touch
For each link, open the repository and find the folder that contains the SKILL.md file. If a repository contains many skills and I did not name one, list them with one Turkish sentence each and ask which ones I want. Read the README and note anything the skill needs: another program, an API key, a paid account.

STEP 3 - Ask for my approval
In 2-4 Turkish sentences, tell me what you will download, where you will put it, and anything extra it needs. Wait until I say "evet".

STEP 4 - Install
- Copy each skill folder into the global skills folder: one folder per skill, with SKILL.md directly inside it (for example ~/.claude/skills/humanizer/SKILL.md).
- Create the global skills folder if it does not exist.
- If a skill with the same name already exists, ask me before replacing it.
- Do not run install scripts from the repository, do not install other programs and do not change any settings, unless you explain why in Turkish and I say "evet".
- Do not touch any files outside the skills folder, except the ZIP files in STEP 6.

STEP 5 - Check
Open each installed SKILL.md and confirm that it starts with a name and a description. If something is wrong, fix it or tell me.

STEP 6 - Optional ZIP for claude.ai
Ask me: "claude.ai'de de kullanmak için ZIP dosyası hazırlayayım mı?" If I say yes, put one ZIP per skill on my Desktop (each ZIP contains the skill folder) and tell me to upload it on claude.ai: Customize > Skills > + > Create skill > Upload a skill.

STEP 7 - Short summary in Turkish
- Which skills you installed, and where.
- For each skill: one sentence on what it does, and one example message I can send to use it
  (Claude Code: /skill-name ... | Codex: $skill-name ...).
- Remind me to open a NEW session before using them, and to keep one task per session.

Ne olacak? Önce ne indireceğini ve nereye koyacağını iki üç cümleyle anlatacak, ek bir program ya da hesap gerekiyorsa bunu da söyleyecek ve sen "evet" diyene kadar hiçbir dosyaya dokunmadan bekleyecek. Arada izin isterse ne yapmak istediğini oku, anladıysan onayla. Sonunda her skill'in ne işe yaradığını ve nasıl çağrılacağını Türkçe yazacak.

Kurulum bitince yeni bir oturum aç. Yeni skill'ler yeni oturumda tam yüklenir.

Adım 3: Skill nasıl çağrılır?

İki yolu var.

Birincisi hiçbir şey yapmamak. İşini anlat, uygun bir skill varsa model kendisi açar. "Bu e-postayı daha doğal yaz" dersen humanizer devreye girer.

İkincisi adıyla çağırmak, daha garanti. Claude'da kutuya / yaz ve açılan listeden skill'i seç; ya da + düğmesinden Slash commands'a gir. Codex'te skill adının başına $ koy.

Claude Code:  /humanizer Bu e-postayı daha doğal ve daha kısa yaz: ...
Codex:        $humanizer Bu e-postayı daha doğal ve daha kısa yaz: ...

İlk denemelerde adıyla çağır. Neyin skill'den, neyin modelin kendisinden geldiğini böyle daha kolay görürsün.

Bir oturum, bir iş

Oturum, Claude'un o işe ait masası. Konuştuğun her şey masada kalıyor. Satış raporunu, müşteri e-postasını ve LinkedIn metnini aynı masada istersen kâğıtlar birbirine karışır, e-postaya satış tablosu sızar, metin gereksiz uzar ve Claude her cevapta masadaki bütün kâğıtları yeniden okumak zorunda kaldığı için yavaşlar.

Kural basit. Her yeni iş için New session, her iş için ayrı bir alt klasör. Ertesi gün aynı işe döneceksen eski oturumu soldaki listeden açarsın. Masan seni bekliyor.

claude.ai'ye skill nasıl yüklenir?

claude.ai ve içindeki Claude Code bulutta çalışıyor, bilgisayarındaki klasörü göremiyor. Skill'i hesabına yüklersen hem sohbette hem bulut oturumlarında açılıyor. Önce Settings › Capabilities altında "Code execution and file creation" açık mı, bir bak.

1. Yukarıdaki prompt kurulumun sonunda "ZIP dosyası hazırlayayım mı?" diye soruyor. Evet dersen her skill için masaüstüne bir ZIP bırakıyor.
2. claude.ai'de soldan Customize › Skills'e gir.
3. + düğmesine bas, Create skill, ardından Upload a skill. ZIP'i seç.

Komut çalıştırması gereken skill'ler, last30days gibi, tarayıcıda her zaman çalışmayabilir. Onlar için masaüstü uygulaması daha rahat.

Takılırsan

Skill listede görünmüyor. Yeni bir oturum aç. Hâlâ yoksa yaz: "Global skill klasörümde hangi skill'ler var, listele."

Bir şey yüklemek istiyor, emin değilim. Prompt, repodaki kurulum betiklerini onayın olmadan çalıştırmamasını söylüyor. Sorduğunda ne olduğunu Türkçe açıklamasını iste. Anlamadığın şeye evet deme.

İki skill aynı işi yapıyor gibi. Adıyla çağır (/ad ya da $ad), hangisinin çalıştığı belli olsun.

Sıkça sorulan sorular

Terminal bilmem gerekiyor mu?

Hayır. Kurulumu yapıştırdığın prompt yapıyor; sen yalnızca okuyup onaylıyorsun.

Bir kere kurunca her projede çalışır mı?

Global kurduysan evet. Claude masaüstü uygulamasında ve Codex'te, hangi klasörü seçersen seç, açtığın her yeni oturumda hazır bekler; bir daha kurman gerekmez.

Claude Code'da skill'ler hangi klasörde durur?

Global skill'ler ~/.claude/skills/<skill-adı>/SKILL.md yolunda, Codex'te ~/.agents/skills/ altında durur. Bir projeye özel skill ise o projenin .claude/skills klasörüne konur.

Skill ile plugin arasındaki fark ne?

Skill tek bir tarif kartı. Plugin ise birkaç skill'i ve başka araçları bir arada getiren paket. Claude masaüstü uygulamasında plugin'leri prompt kutusundaki + düğmesinden, Plugins menüsünden yönetirsin.

Skill'ler ücretli mi?

Bu blogda anlattıklarımın çoğu açık kaynak ve ücretsiz. Bazıları ek bir servis ya da API anahtarı isteyebiliyor; prompt kurmadan önce bunu söylüyor.

Kurduğum bir skill'i nasıl kaldırırım?

Yeni bir oturumda "humanizer skill'ini global klasörümden kaldır" yaz. Neyi sileceğini gösterip onay ister.

Bunu ekibime toplu öğretebilir miyim?

Evet. Kurumlara skill ve ajan kullanımını kendi iş örnekleriyle uygulamalı anlatıyorum: Kurumsal Yapay Zekâ Atölyesi. Ekip yalnızca skill kurmaya, kendi skill'ini yazmaya ve araçları bağlamaya odaklanacaksa ayrı bir program var: Skill, Connector ve MCP eğitimi.