Ajan becerileri
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.
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
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.
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.
name su kurallari saglamalidir:
- 1-64 karakter olmali
- Kucuk harf alfanumerik ve tekli tire ayirici kullanmali
-ile baslamamali veya bitmemeli- Ardisik
--icermemeli SKILL.mddosyasini barindiran klasor adi ile ayni olmali
Esdeger regex:
^[a-z0-9]+(-[a-z0-9]+)*$description 1-1024 karakter arasinda olmali.
Ajanin dogru secim yapmasi icin yeterince acik yazin.
.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.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" })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.
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"
}
}
}
}
}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.
Bir beceri listede gorunmuyorsa:
SKILL.mdadinin tamamen buyuk harfle yazildigini dogrulayin- Frontmatter icinde
namevedescriptionoldugunu kontrol edin - Tum konumlarda beceri adlarinin benzersiz oldugundan emin olun
- Izinleri kontrol edin -
denyolan beceriler ajanlardan gizlenir