Skills

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?

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ı

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

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

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

Verdent, yaygın iş akışlarını kapsayan bir dizi yerleşik Skill ile gelir:

Ö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ı

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

SKILL.md, YAML frontmatter ve bir Markdown gövdesi içeren temel Skill dosyasıdır:

---
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

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

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:

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ı

Verdent üç düzeyde Skill kapsamını destekler:

Öncelik kuralları:

Aynı ada sahip Skills birden fazla kapsamda bulunduğunda:

• Proje, Genel'i geçersiz kılar

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

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

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

Ö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

@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

@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

Gelişmiş kullanım

Skills'e betik gömme

Skill'inize bir scripts/ dizini ekleyin ve betiklere SKILL.md içinde başvurun:

## 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

API belgelerini, spesifikasyonları veya örnek kodları bir references/ dizininde saklayın ve bunları SKILL.md içinde bağlayın:

## 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

Ayrıca bkz.