Ajan becerileri

SKILL.md ile tekrar kullanilabilir davranis tanimlayin

Ajan becerileri, opencode’un deponuzdan veya ev dizininizden tekrar kullanilabilir talimatlari kesfetmesini saglar. Beceriler, yerel skill araci uzerinden ihtiyac aninda yuklenir; ajanlar mevcut becerileri gorur ve gerektiginde tam icerigi yukler.

Dosyalari yerlestirin

Her beceri adi icin bir klasor olusturun ve icine bir SKILL.md koyun. opencode su konumlari tarar:

Proje konfigurasyonu: .opencode/skills/<name>/SKILL.md
Genel konfigurasyon: ~/.config/opencode/skills/<name>/SKILL.md
Proje Claude uyumlu: .claude/skills/<name>/SKILL.md
Genel Claude uyumlu: ~/.claude/skills/<name>/SKILL.md
Proje agent uyumlu: .agents/skills/<name>/SKILL.md
Genel agent uyumlu: ~/.agents/skills/<name>/SKILL.md

Kesfi anlayin

Proje yerel yollarinda opencode, mevcut calisma dizininizden baslayip git worktree kokune kadar yukari cikar. Bu sirada skills/*/SKILL.md altindaki eslesen .opencode/ dosyalarini ve .claude/skills/*/SKILL.md ya da .agents/skills/*/SKILL.md dosyalarini yukler.

Genel tanimlar da ~/.config/opencode/skills/*/SKILL.md, ~/.claude/skills/*/SKILL.md ve ~/.agents/skills/*/SKILL.md yollarindan yuklenir.

Frontmatter yazin

Her SKILL.md, YAML frontmatter ile baslamalidir. Sadece su alanlar taninir:

name (zorunlu)
description (zorunlu)
license (istege bagli)
compatibility (istege bagli)
metadata (istege bagli, string-to-string map)

Bilinmeyen frontmatter alanlari yok sayilir.

Adlari dogrulayin

name su kurallari saglamalidir:

1-64 karakter olmali
Kucuk harf alfanumerik ve tekli tire ayirici kullanmali
- ile baslamamali veya bitmemeli
Ardisik -- icermemeli
SKILL.md dosyasini barindiran klasor adi ile ayni olmali

Esdeger regex:

^[a-z0-9]+(-[a-z0-9]+)*$

Uzunluk kurallarina uyun

description 1-1024 karakter arasinda olmali. Ajanin dogru secim yapmasi icin yeterince acik yazin.

Ornek kullanin

.opencode/skills/git-release/SKILL.md dosyasini soyle olusturun:

---
name: git-release
description: Create consistent releases and changelogs
license: MIT
compatibility: opencode
metadata:
  audience: maintainers
  workflow: github
---

## What I do

- Draft release notes from merged PRs
- Propose a version bump
- Provide a copy-pasteable `gh release create` command

## When to use me

Use this when you are preparing a tagged release.
Ask clarifying questions if the target versioning scheme is unclear.

Arac aciklamasini taniyin

opencode, skill araci aciklamasinda mevcut becerileri listeler. Her kayitta beceri adi ve aciklamasi yer alir:

<available_skills>
  <skill>
    <name>git-release</name>
    <description>Create consistent releases and changelogs</description>
  </skill>
</available_skills>

Ajan, araci cagirarak beceri yukler:

skill({ name: "git-release" })

Izinleri yapilandirin

opencode.json icinde pattern tabanli izinlerle ajanlarin hangi becerilere erisecegini kontrol edin:

{
  "permission": {
    "skill": {
      "*": "allow",
      "pr-review": "allow",
      "internal-*": "deny",
      "experimental-*": "ask"
    }
  }
}

Permission	Behavior
`allow`	Beceri hemen yuklenir
`deny`	Beceri ajandan gizlenir, erisim reddedilir
`ask`	Yukleme oncesi kullanicidan onay istenir

Pattern’lar wildcard destekler: internal-*, internal-docs, internal-tools vb. adlarla eslesir.

Ajan bazinda gecersiz kilin

Belirli ajanlara genel varsayimlardan farkli izinler verebilirsiniz.

Ozel ajanlar icin (agent frontmatter icinde):

---
permission:
  skill:
    "documents-*": "allow"
---

Yerlesik ajanlar icin (opencode.json icinde):

{
  "agent": {
    "plan": {
      "permission": {
        "skill": {
          "internal-*": "allow"
        }
      }
    }
  }
}

Skill aracini kapatin

Beceri kullanmamasi gereken ajanlar icin skill aracini tamamen kapatabilirsiniz:

Ozel ajanlar icin:

---
tools:
  skill: false
---

Yerlesik ajanlar icin:

{
  "agent": {
    "plan": {
      "tools": {
        "skill": false
      }
    }
  }
}

Devre disi oldugunda <available_skills> bolumu tamamen kaldirilir.

Yukleme sorunlarini giderin

Bir beceri listede gorunmuyorsa:

SKILL.md adinin tamamen buyuk harfle yazildigini dogrulayin
Frontmatter icinde name ve description oldugunu kontrol edin
Tum konumlarda beceri adlarinin benzersiz oldugundan emin olun
Izinleri kontrol edin - deny olan beceriler ajanlardan gizlenir