Hermes Agent’da Özel Skills Yazma: Adım Adım AI Ajan Yeteneği Oluşturma

Hermes Agent, yapay zeka asistanınızı ihtiyaçlarınıza göre şekillendirmenize izin veren güçlü bir yetenek sistemine sahip: Skills (yetenekler). Önceki yazımızda Skills’in ne olduğundan bahsetmiştik. Şimdi sıra geldi Hermes Agent skills yazma konusuna: kendi özel yeteneğinizi oluşturma, yapılandırma ve kullanma adımlarına.

Hazırsanız, kendi AI ajan becerilerinizi sıfırdan nasıl yazacağınızı adım adım görelim.

Hermes Agent Skills Nedir?

Skills, Hermes Agent’ın belirli bir görev için nasıl davranacağını tanımlayan özel talimat dosyalarıdır. Bir skill dosyası, ajanınıza hangi araçları kullanacağını, hangi adımları izleyeceğini ve hangi çıktı formatını üreteceğini söyler. Bir bakıma ajanınızın uzmanlık alanı diyebiliriz.

Örneğin bir “wordpress-site-delivery” skill’i WordPress tema paketi hazırlamak için, bir “seo-publisher” skill’i blog yazısı yayınlamak için kullanılabilir. Her skill, ajanınıza o konuda derinlemesine bilgi ve talimat verir.

Skill Dosyası Yapısı ve Formatı

Bir Hermes Agent skill dosyası SKILL.md adıyla kaydedilir. Belirli bir skills/ klasörü altında, her skill kendi alt klasöründe yer alır. Temel yapı şöyledir:

~/.hermes/skills/
  my-custom-skill/
    SKILL.md        # Ana talimat dosyası
    assets/         # (isteğe bağlı) Yardımcı dosyalar

SKILL.md dosyası Markdown formatında yazılır ve iki ana bölümden oluşur: metadata başlığı ve talimatlar.

Metadata Başlığı

Dosyanın en üstünde --- ile ayrılmış YAML metadata bloğu bulunur. Bu blok skill’in adını, açıklamasını, versiyonunu ve etiketlerini tanımlar:

---
name: my-custom-skill
description: "Özel bir beceri için açıklama"
version: 1.0.0
author: Sizin Adınız
license: MIT
metadata:
  hermes:
    tags: [ai, otomasyon, ozel-skill]
    related_skills: []
---

Metadata, Hermes Agent’ın skill’i tanıması ve doğru bağlamda kullanması için kritiktir. tags alanı, skill’in hangi konularda uzman olduğunu belirtir ve ajanın otomatik skill seçiminde rol oynar.

Talimat Bölümü

Metadata’dan sonra gelen bölüm, skill’in asıl talimatlarını içerir. Burada ajanınıza adım adım ne yapması gerektiğini anlatırsınız. Doğal dilde yazılır — bir işe yeni başlayan birine anlatır gibi açık ve nettir.

Adım Adım Skill Oluşturma

Şimdi sıfırdan bir skill oluşturalım. Örnek olarak WordPress SEO Denetleme Skill’i yazalım.

1. Skill Klasörünü Oluşturun

mkdir -p ~/.hermes/skills/wp-seo-audit

2. SKILL.md Dosyasını Yazın

~/.hermes/skills/wp-seo-audit/SKILL.md dosyasını oluşturun:

---
name: wp-seo-audit
description: "WordPress sitesi için temel SEO denetimi yapar: başlık, meta açıklama, hız, mobil uyumluluk ve iç link yapısını kontrol eder."
version: 1.0.0
author: Ahmet
license: MIT
metadata:
  hermes:
    tags: [wordpress, seo, denetim, analiz]
    related_skills: []
---

# WordPress SEO Denetim Skill'i

Bu skill, bir WordPress sitesinin temel SEO sağlığını kontrol eder.

## Kullanım
Kullanıcı bir site URL'si verdiğinde:
1. Site URL'sini al ve doğrula.
2. WordPress REST API'den son 10 yazıyı çek (yardımcı araçları kullan).
3. Her yazı için şunları kontrol et:
   - Başlık 50-60 karakter arasında mı?
   - Meta açıklama 140-160 karakter arasında mı?
   - Focus keyword belirlenmiş mi?
   - En az bir H2 etiketi var mı?
4. Sonuçları bir tablo halinde özetle.
5. İyileştirme önerilerini maddeler halinde sırala.

## Çıktı Formatı
- Güzel biçimlendirilmiş bir SEO raporu
- Her madde için ✅ (iyi) veya ⚠️ (geliştirilebilir) simgesi
- Varsa düzeltme önerileri

## Önemli Kurallar
- Yanlış pozitif raporlama yapma
- Internal link yapısını da kontrol et
- Sadece halka açık verileri kullan

3. Skill’i Profile Ekleyin

Skill’i kullanmak için Hermes Agent profilinize eklemeniz gerekir. Profil ayarları ~/.hermes/config.yaml dosyasında bulunur:

# ~/.hermes/config.yaml
skills:
  - hermes-agent       # Hermes'in kendi skill'i
  - wp-seo-audit       # Sizin yazdığınız skill

Eğer Hermes Agent profilleri kullanıyorsanız (Hermes Agent Profilleri rehberimizde detaylı anlattık), skill’i ilgili profilin skills/ klasörüne ekleyin:

~/.hermes/profiles/my-profile/
  skills/
    wp-seo-audit/
      SKILL.md

4. Skill’i Test Edin

Hermes Agent CLI üzerinden skill’in yüklendiğini kontrol edin. Hermes Agent CLI Komutları rehberinde tüm komutları bulabilirsiniz.

hermes skill list

Skill listenizde wp-seo-audit görünüyorsa, başarıyla eklenmiş demektir. Artık Hermes Agent’a bir WordPress SEO denetimi yapmasını istediğinizde bu skill otomatik olarak devreye girecek.

Gelişmiş Skill Teknikleri

Basit bir skill’in ötesine geçmek isterseniz, şu ileri seviye teknikleri kullanabilirsiniz:

Araç Kullanımını Zorunlu Kılma

Skill içinde belirli araçların (tool) kullanılmasını zorunlu kılabilirsiniz. Örneğin dosya okuma, terminal komutu veya arama aracı:

## Zorunlu Araçlar
Bu skill aşağıdaki araçları KULLANMALIDIR:
- `read_file`: Mevcut dosyaları okumak için
- `search_files`: İçerik aramak için
- `terminal`: Komut çalıştırmak için

Çıktı Formatını Belirleme

Skill’in hangi formatta çıktı vereceğini netleştirin. JSON, tablo, rapor veya Markdown olabilir:

## Çıktı Formatı
Yanıtını şu JSON yapısında döndür:
{
  "status": "success|error",
  "findings": [...],
  "recommendations": [...]
}

Çoklu Skill ve Sıralama

Birden fazla skill’i birbiri ardına zincirleyebilirsiniz. Örneğin önce SEO denetimi yapan, sonra bulduğu sorunları otomatik düzelten bir zincir kurabilirsiniz.

Hermes Agent Skills Yazarken Dikkat Edilmesi Gerekenler

• Açık ve net olun: Ajanın ne yapması gerektiğini net cümlelerle anlatın. “Güzel bir rapor hazırla” yerine “H2 başlıkları, meta açıklama uzunluğu ve keyword kullanımını kontrol eden bir rapor hazırla” deyin.
• Adım adım yazın: Karmaşık görevleri küçük adımlara bölün. Her adım net bir eylem içersin.
• Kural belirtin: Yapılması ve yapılmaması gerekenleri “## Önemli Kurallar” bölümünde listeleyin.
• Varsayılan davranışı ezmeyin: Skill sadece kendi uzmanlık alanında devreye girmeli, diğer konularda ajanın normal davranışını engellememeli.
• Versiyon takibi yapın: version alanını güncelleyerek skill değişikliklerini takip edin.

Örnek Kullanım Senaryoları

İşte Hermes Agent skills yazma ile hayata geçirebileceğiniz bazı senaryolar:

• WordPress hata çözümü skill’i: 500 Internal Server Error, beyaz ekran, eklenti çakışması gibi yaygın WordPress hatalarını adım adım teşhis eden bir skill.
• SEO içerik üretici skill’i: Belirli bir konuda, belirlenen kurallara uygun SEO uyumlu blog yazısı hazırlayan skill.
• WooCommerce ürün içe aktarma skill’i: CSV/Excel dosyasındaki ürünleri otomatik olarak WordPress’e ekleyen skill.
• Performans denetim skill’i: Core Web Vitals, sayfa hızı ve sunucu yanıt sürelerini kontrol eden skill.
• Yedekleme ve geri yükleme skill’i: WordPress veritabanı ve dosya yedekleme işlemlerini otomatikleştiren skill.

Özellikle WordPress ile çalışıyorsanız, kendi ihtiyaçlarınıza göre özelleştirilmiş skill’ler yazarak AI ajan otomasyonunu bir üst seviyeye taşıyabilirsiniz.

Sık Yapılan Hatalar

• Çok genel talimatlar: “İçerik üret” gibi muğlak ifadeler yerine, hangi tür içerik, hangi formatta, hangi kurallarla üretileceğini belirtin.
• Metadata eksikliği: name, description veya tags alanları olmadan Hermes Agent skill’i tanımayabilir.
• Yanlış klasör yapısı: Skill dosyası doğrudan skills/ altında değil, bir alt klasör içinde SKILL.md olarak yer almalı.
• Test etmeden kullanma: Yeni bir skill’i hemen canlı ortamda kullanmadan önce test edin.

Sonuç

Hermes Agent skills yazma, AI ajanınızı kişisel ihtiyaçlarınıza göre şekillendirmenin en güçlü yoludur. Doğru yazılmış bir skill ile tekrarlayan işleri otomatikleştirebilir, standartları koruyabilir ve ajanınızın kalitesini artırabilirsiniz.

Sıradaki adım: Kendi ihtiyacınızı belirleyin, yukarıdaki şablonu kullanarak bir SKILL.md dosyası oluşturun ve profilinize ekleyin. Herhangi bir sorunuz olursa iletişim sayfamızdan bize ulaşabilirsiniz.

Eğer Hermes Agent ile ilgili daha fazla rehber arıyorsanız, model ve sağlayıcı ayarları veya Hermes Agent Skills Nedir yazılarımıza da göz atabilirsiniz.