# Skills (/tr/docs/verdent-manager/core-features/skills)
> Özel iş akışları ve alan uzmanlığı için yeniden kullanılabilir bilgi paketleriyle Verdent'in yeteneklerini genişletin
Verdent **Skills**, aracının uzmanlığını genişleten yeniden kullanılabilir bilgi paketleridir. Her Skill, alana özgü istemler, betikler, referanslar ve en iyi uygulamaları içerir. Bir Skill'i adıyla çağırmanız yeterlidir; aracı ilgili bağlamı yükler ve önceden tanımlanmış iş akışını izler.
***
## Skills nedir? [#skills-nedir]
### Temel kavram [#temel-kavram]
Bir **Skill**, bir klasörde saklanan yapılandırılmış bir bilgi paketidir. Her Skill, adını, açıklamasını ve ayrıntılı istemini tanımlayan bir `SKILL.md` dosyası içerir. Konuşmada bir Skill çağırdığınızda, Verdent bu dosyayı okur ve içeriğini aracının bağlamına enjekte eder.
### Skills'in alt aracılar ve MCP'den farkı [#skillsin-alt-aracılar-ve-mcpden-farkı]
| Boyut | Skills | Alt aracılar | MCP |
| ----------------- | ------------------------------------------ | ---------------------------------------------------- | --------------------------------------------------- |
| **Tetikleme** | `@skill` ile veya bahsederek manuel çağrı | Ana aracı tarafından otomatik oluşturulur | Otomatik çağrılır veya açıkça çağrılır |
| **Yürütme** | Ana konuşma bağlamını genişletir | İzole bağlamla bağımsız bir alt görev olarak çalışır | JSON-RPC 2.0 ile harici araçları çağırır |
| **Amaç** | Alan rehberliği (ör. "test nasıl yazılır") | Bağımsız işlemler (ör. "kod incelemesi yap") | Harici veri/araç erişimi (ör. veritabanı sorguları) |
| **Yaşam döngüsü** | Tek seferlik bağlam enjeksiyonu | Alt görevi tamamlar ve sonuçları döndürür | Oturum boyunca kalıcı sunucu süreci |
| **Uygulama** | Markdown dosyaları + isteğe bağlı betikler | Yerleşik aracı mantığı | Çalıştırılabilir sunucu süreçleri |
Kısacası: **Skills bilgi ve iş akışı rehberliği sağlar**, **alt aracılar bağımsız görevleri yürütür** ve **MCP harici araçları ve veri kaynaklarını bağlar**.
***
## Skills nasıl kullanılır [#skills-nasıl-kullanılır]
### Bir Skill çağırma [#bir-skill-çağırma]
Bir Skill'i iki şekilde çağırabilirsiniz:
**1. Konuşmada Skill adından bahsedin**
```
Use the skill-creator skill to help me create a new Skill
```
**2. @ bahsetme sözdizimini kullanın**
```
@skill-creator help me create a Skill for API documentation generation
```
Bir Skill tetiklendiğinde:
1. Aracı, Skill'in `SKILL.md` dosyasını okumak için `skill` aracını çağırır
2. Dosya içeriği mevcut konuşma bağlamına enjekte edilir
3. Aracı, Skill'in rehberliğine göre çalışmaya devam eder
### Mevcut Skills'e göz atma [#mevcut-skillse-göz-atma]
Skills paneline Ayarlar üzerinden erişin:
1. **Settings** menüsünü açın
2. **Skills** sekmesini seçin
3. Yüklü Skills'e ve Skill Store'daki mevcut Skills'e göz atın
Ayrıca giriş kutusuna `@` yazarak otomatik tamamlamayı tetikleyebilir ve mevcut bir Skill'i hızlıca seçebilirsiniz.
***
## Yerleşik Skills [#yerleşik-skills]
Verdent, yaygın iş akışlarını kapsayan bir dizi yerleşik Skill ile gelir:
| Skill | Açıklama |
| ------------------- | ------------------------------------------------------------------------------------------------------ |
| **docx** | Word belgelerini (`.docx`) biçime sadık görsel kontrollerle okuyun, oluşturun veya düzenleyin |
| **find-skills** | Skills keşfedin ve yükleyin — "X'i nasıl yaparım?" diye sorarken veya yeni yetenekler ararken kullanın |
| **frontend-design** | Yüksek tasarım kalitesine sahip, ayırt edici, üretim düzeyinde ön uç arayüzleri oluşturun |
| **pdf** | PDF dosyalarını görsel oluşturma ve içerik çıkarmayla okuyun, oluşturun veya inceleyin |
| **pptx** | PowerPoint sunumlarını (`.pptx`) okuyun, oluşturun veya düzenleyin |
| **skill-creator** | Özel Skills oluşturmak ve geliştirmek için rehberli bir iş akışı |
| **xlsx** | Excel tablolarını okuyun, analiz edin, görselleştirin ve akıllıca düzenleyin |
Daha fazla Skill **Skill Store**'da mevcuttur. Ek Skills'e göz atmak ve yüklemek için **Settings → Skills → Store** menüsünü açın.
***
## Özel Skills oluşturma [#özel-skills-oluşturma]
Ekibinizin alan uzmanlığını veya projeye özgü iş akışlarını kapsüllemek için özel Skills oluşturabilirsiniz.
### Skill dizin yapısı [#skill-dizin-yapısı]
Standart bir Skill klasörü şöyle görünür:
```
my-custom-skill/
├── SKILL.md # Required: Skill definition file
├── agents/
│ └── verdent.yaml # Optional: UI configuration (icons, display name)
├── scripts/ # Optional: helper scripts
└── references/ # Optional: reference docs or examples
```
### SKILL.md biçimi [#skillmd-biçimi]
`SKILL.md`, YAML frontmatter ve bir Markdown gövdesi içeren temel Skill dosyasıdır:
```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
version: "1.0.0"
author: "Your Name"
license: "MIT"
---
# Detailed Instructions
This is the detailed prompt content the Agent reads.
## Workflow
1. Step one
2. Step two
3. ...
## Best Practices
- Practice suggestion 1
- Practice suggestion 2
```
**Frontmatter alan gereksinimleri:**
* `name` (gerekli): Klasör adıyla eşleşmelidir. Yalnızca küçük harfler, sayılar ve tireler (`a-z0-9-`) kullanılabilir. Uzunluk: 1–64 karakter. Ardışık tire ya da başta/sonda tire olamaz.
* `description` (gerekli): Kısa bir açıklama, en fazla 1024 karakter.
* `metadata` (isteğe bağlı): Sürüm, yazar, lisans ve diğer meta bilgiler.
### Özel Skills yükleme [#özel-skills-yükleme]
**Yöntem 1: Ayarlar üzerinden içe aktarma**
1. **Settings → Skills** menüsünü açın
2. **Import Skill** seçeneğine tıklayın
3. Skill klasörünü (veya bir `.zip` / `.skill` arşivini) seçin
4. Verdent `SKILL.md` dosyasını doğrular ve `~/.verdent/skills/` konumuna yükler
**Yöntem 2: Manuel kopyalama**
```bash
cp -r my-custom-skill ~/.verdent/skills/
```
Skill, Verdent'i yeniden başlattıktan veya Skills listesini yeniledikten sonra kullanılabilir hale gelir.
**Yöntem 3: Proje düzeyinde Skill**
Skill'i proje dizininizin içine yerleştirin:
```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```
Proje düzeyindeki Skills yalnızca o projede görünür ve aynı ada sahip genel Skills'e göre önceliklidir.
***
## Skill kapsamları [#skill-kapsamları]
Verdent üç düzeyde Skill kapsamını destekler:
| Düzey | Konum | Görünürlük |
| --------- | ---------------------------- | ----------------------------------------- |
| **Genel** | `~/.verdent/skills/` | Tüm projeler ve çalışma alanları |
| **Proje** | `/.verdent/skills/` | Yalnızca mevcut projenin çalışma alanları |
**Öncelik kuralları:**
Aynı ada sahip Skills birden fazla kapsamda bulunduğunda:
* Proje, Genel'i geçersiz kılar
***
## Skill Store [#skill-store]
Verdent, topluluk ve resmi Skills'e göz atmak ve yüklemek için bir **Skill Store** sunar.
### Skill Store'a göz atma [#skill-storea-göz-atma]
1. **Settings → Skills** menüsünü açın
2. **Store** sekmesine geçin
3. Mevcut Skills'e göz atın veya arama kutusunu kullanın
### Store'dan yükleme [#storedan-yükleme]
1. Store'da istediğiniz Skill'i bulun
2. **Install** seçeneğine tıklayın
3. Skill otomatik olarak indirilir ve `~/.verdent/skills/` konumuna yüklenir
**Güvenlik doğrulaması:**
Store'dan yüklenen Skills, dosya bütünlüğünü ve güvenliğini sağlamak için SHA256 sağlama toplamı doğrulamasından geçer.
***
## Pratik örnekler [#pratik-örnekler]
### Örnek 1: `skill-creator` ile yeni bir Skill oluşturma [#örnek-1-skill-creator-ile-yeni-bir-skill-oluşturma]
```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```
Aracı şunları yapacaktır:
1. `skill-creator` Skill içeriğini okur
2. Skill adını, açıklamasını ve temel istemini doldurmanız için size rehberlik eder
3. Standart bir `SKILL.md` oluşturur
4. Yükleme yolu ve doğrulama adımları önerir
### Örnek 2: `spreadsheet` ile veri analizi [#örnek-2-spreadsheet-ile-veri-analizi]
```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```
Aracı şunları yapacaktır:
1. `spreadsheet` Skill'i yükler
2. Excel dosyasını okumak için `pandas` ve `openpyxl` kullanır
3. Verileri analiz eder ve görselleştirmeler oluşturur
4. Sonuçları kaydeder veya konuşmada görüntüler
### Örnek 3: `gh-fix-ci` ile CI düzeltme [#örnek-3-gh-fix-ci-ile-ci-düzeltme]
```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```
Aracı şunları yapacaktır:
1. PR #123 için CI günlüklerini almak üzere `gh` CLI'sini kullanır
2. Hatayı analiz eder (ör. test durumu hataları, bağımlılık sorunları)
3. Bir düzeltme önerir
4. Onayınızla kodu değiştirir ve düzeltmeyi gönderir
***
## SSS [#sss]
Bir Skill çağrıldığında, aracı `SKILL.md` dosyasını okur; bu da token kullanımına dahil edilir ve dolayısıyla kredi tüketir. Ancak Skill'in kendisi ek API çağrıları yapmaz.
Evet. Skill'i `~/.verdent/skills/` konumuna (genel kapsam) yükleyin; tüm projelerde kullanılabilir olur.
**Settings → Skills** menüsünde Skill'e sağ tıklayın ve **Delete** seçeneğini seçin. `undeletable` olarak işaretlenmiş yerleşik Skills silinemez ve bir sonraki başlatmada yeniden yüklenir.
Evet. Verdent, `~/.cursor/skills`, `~/.claude/skills` ve `~/.codex/skills` içindeki Skills'i otomatik olarak algılar ve bunları içe aktarmanızı ister. **Settings → Skills** menüsünde **Import from External Sources** seçeneğine tıklayın.
* **Project Rule**: Her konuşmaya otomatik olarak enjekte edilen her zaman etkin talimatlar
* **Skill**: Yalnızca çağrıldığında enjekte edilen isteğe bağlı bilgi paketleri
Evrensel kodlama standartları için Rules kullanın; belirli alan iş akışları için Skills kullanın.
Skill Store'dan yüklenen Skills, arka planda güncellemeler için otomatik olarak kontrol edilir. Manuel olarak yüklenen Skills'i güncellemek için yeniden içe aktarmanız (eski sürümün üzerine yazmanız) gerekir.
***
## Gelişmiş kullanım [#gelişmiş-kullanım]
### Skills'e betik gömme [#skillse-betik-gömme]
Skill'inize bir `scripts/` dizini ekleyin ve betiklere `SKILL.md` içinde başvurun:
```markdown
## Data Processing Script
Run the following command to process data:
\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```
Aracı bu talimatı okur ve betiği gerektiğinde yürütür.
### Belgelere başvurma [#belgelere-başvurma]
API belgelerini, spesifikasyonları veya örnek kodları bir `references/` dizininde saklayın ve bunları `SKILL.md` içinde bağlayın:
```markdown
## Reference Documentation
See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```
Aracı, Skill'in talimatlarına göre bu referans dosyalarını okuyabilir.
***
## En iyi uygulamalar [#en-iyi-uygulamalar]
**Skills'i odaklı tutun.** Her Skill tek bir alanı veya iş akışını hedeflemelidir. "Her şeyi yapan" Skills oluşturmaktan kaçının; bunun yerine onları daha küçük, uzmanlaşmış Skills'e bölün.
**Net adlandırma kullanın.** Skill adları kısa ve açıklayıcı olmalıdır; ör. `my-skill-1` yerine `api-doc-generator`.
**Örnekler ve referanslar sağlayın.** Aracının beklenen çıktıyı daha iyi anlamasına yardımcı olmak için `SKILL.md` içine somut örnekler ve referans bağlantıları ekleyin.
**Sürüm numaralarını koruyun.** Güncellemeleri ve uyumluluğu izlemek için `metadata.version` alanını kullanın.
**Paylaşmadan önce test edin.** Skill'inizi ekibe sunmadan veya Skill Store'da yayınlamadan önce bir test projesinde doğrulayın.
***
## Ayrıca bkz. [#ayrıca-bkz]
Alt aracıların nasıl çalıştığı ve nasıl yönetileceği
MCP ile harici araçları ve hizmetleri bağlayın
Her zaman etkin Project ve User Rules'u yapılandırın
Yerleşik Reviewer ile kod değişikliklerini inceleyin