Agentfærdigheder
Agentferdigheter lar OpenCode oppdage gjenbrugbare instruksjoner fra repo- eller hjemmekatalogen din.
Ferdigheter lastes inn på forespørsel via det opprinnelige skill-verktøyet – agenter ser tilgængelige ferdigheter og kan laste inn hele innholdet når det er nødvendig.
Opret én mappe per ferdighetsnavn og tilføj inn en SKILL.md i den.
OpenCode søker etter disse stedene:
- Prosjektkonfigurasjon:
.opencode/skills/<name>/SKILL.md - Global konfigurasjon:
~/.config/opencode/skills/<name>/SKILL.md - Prosjekt Claude-kompatibel:
.claude/skills/<name>/SKILL.md - Global Claude-kompatibel:
~/.claude/skills/<name>/SKILL.md - Prosjektagent-kompatibel:
.agents/skills/<name>/SKILL.md - Global agent-kompatibel:
~/.agents/skills/<name>/SKILL.md
For prosjektlokale stier går OpenCode opp fra din nåværende arbejdskatalog til den når git-arbeidstreet.
Den laster alle matchende skills/*/SKILL.md i .opencode/ og alle matchende .claude/skills/*/SKILL.md eller .agents/skills/*/SKILL.md underveis.
Globale definisjoner lastes også inn fra ~/.config/opencode/skills/*/SKILL.md, ~/.claude/skills/*/SKILL.md og ~/.agents/skills/*/SKILL.md.
Hver SKILL.md må starte med YAML frontmatter.
Bare disse feltene gjenkjennes:
name(påkrevd)description(påkrevd)license(valgfritt)compatibility(valgfritt)metadata(valgfritt, streng-til-streng kart)
Ukjente frontmatter-felter ignoreres.
name må:
- Bestå av 1–64 tegn
- Vær alfanumerisk med små bokstaver med skilletegn med enkelt bindestrek
- Ikke begynne eller slutte med
- - Ikke inneholde påfølgende
-- - Match katalognavnet som inneholder
SKILL.md
Ekvivalent regulært uttrykk:
^[a-z0-9]+(-[a-z0-9]+)*$description må bestå av 1-1024 tegn.
Hold det spesifikt nok til at agenten kan velge riktig.
Lag .opencode/skills/git-release/SKILL.md slik:
---
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 viser tilgængelige ferdigheter i skill verktøybeskrivelsen.
Hver oppføring inneholder ferdighetsnavnet og beskrivelsen:
<available_skills>
<skill>
<name>git-release</name>
<description>Create consistent releases and changelogs</description>
</skill>
</available_skills>Agenten laster inn en ferdighet ved at kalle verktøyet:
skill({ name: "git-release" })Kontroller hvilke ferdigheter agenter har tilgang til ved at bruge mønsterbaserte tillatelser i opencode.json:
{
"permission": {
"skill": {
"*": "allow",
"pr-review": "allow",
"internal-*": "deny",
"experimental-*": "ask"
}
}
}| Tillatelse | Atferd |
|---|---|
allow | Ferdigheter lastes umiddelbart |
deny | Ferdighet skjult for agent, tilgang avvist |
ask | Bruger bedt om godkjenning før lasting |
Mønstre støtter jokertegn: internal-* samsvarer med internal-docs, internal-tools osv.
Gi spesifikke agenter andre tillatelser enn de globale standardinnstillingene.
For egendefinerte agenter (i agent frontmatter):
---
permission:
skill:
"documents-*": "allow"
---For innebygde agenter (i opencode.json):
{
"agent": {
"plan": {
"permission": {
"skill": {
"internal-*": "allow"
}
}
}
}
}Deaktiver ferdigheter fullstendig for agenter som ikke bør bruge dem:
For egendefinerte agenter:
---
tools:
skill: false
---For innebygde agenter:
{
"agent": {
"plan": {
"tools": {
"skill": false
}
}
}
}Når den er deaktivert, blir <available_skills>-delen utelatt helt.
Hvis en ferdighet ikke vises:
- Kontroller at
SKILL.mder stavet med store bokstaver - Tjek at frontmatter inkluderer
nameogdescription - Sørg for at ferdighetsnavnene er unike på alle steder
- Tjek tillatelser – ferdigheter med
denyer skjult for agenter