Skills
Skills sind versionierte, wiederverwendbare Anweisungssätze, die aus einem guten Ergebnis eine dauerhafte Fähigkeit machen.
Skills sind versionierte, wiederverwendbare Anweisungssätze, die aus einem guten Ergebnis eine dauerhafte Fähigkeit machen. Jedem Agenten kann ein Skill zugewiesen werden.
Skill-Registry
Die Seite Skills listet alle Skills im aktuellen Workspace auf.
Jede Zeile zeigt:
- Name — Klicken, um die Skill-Details zu öffnen
- Kategorie — z. B. Codegenerierung, Analyse, Dokumentation
- Status — Entwurf / Veröffentlicht / Archiviert
- Version — Aktuell aktive Version
Skill erstellen
Klicke auf Neuer Skill → wähle einen Modus:
| Modus | Beschreibung |
|---|---|
| Manuell erstellen | Name, Kategorie, Beschreibung und Anweisungen ausfüllen |
| Von GitHub importieren | Eine GitHub-URL einfügen (z. B. https://github.com/anthropics/skills/tree/main/skills/pdf) — SKILL.md wird automatisch abgerufen |
| .ao importieren | (Workspace-Administratoren) Ein .ao-Skill-Paket wählen, das aus diesem oder einem anderen Workspace exportiert wurde. Jeder Skill kommt als Entwurf an — prüfe und veröffentliche ihn selbst. Ein bereits vorhandener Name wird zu Name (2); bestehende Skills werden nie verändert |
Skills exportieren
Workspace-Administratoren können Skills als .ao-Datei herunterladen: Alle exportieren (Seite Skills) speichert jeden Skill im Workspace, die Schaltfläche Exportieren in der Kopfzeile eines Skills speichert nur diesen einen. Die Datei enthält alle Versionen, die Skripte und die hochgeladenen Dateien, sodass sie in einen anderen Workspace oder eine andere AO-Instanz importiert werden kann.
Skill-Details
Klicke auf einen Skill, um die Detailansicht mit Tabs zu öffnen:
Tab Anweisungen
Die Anweisungen der aktuell veröffentlichten Version. Bei veröffentlichten Skills schreibgeschützt, bei Entwürfen bearbeitbar.
Tab Schemas
JSON-Schemas für Ein- und Ausgabe des Skills (zur Validierung).
Tab Skripte
Ausführbare Tool-Skripte (z. B. hello_skill.py). Jedes Skript hat:
- Name
- Sprache (Python, Shell usw.)
- Inhaltseditor
Tab Dateien
Zusätzliche Dateien, die mit dem Skill gebündelt sind (Vorlagen, Konfigurationen usw.).
Tab Agent-Ansicht
Schreibgeschützte Vorschau, wie der Skill zur Laufzeit für Agenten bereitgestellt wird:
- Layout auf dem Datenträger unter
.opencode/skills/<slug>/ - Skripte unter
scripts/<name> - Dateien im Stammverzeichnis
- Laden bei Bedarf — der Agent lädt den vollständigen Skill-Inhalt nur bei Bedarf über das
skill-Tool - Strikte Isolation pro Agent — nur Agenten, denen der Skill zugewiesen ist, können darauf zugreifen
Tab Versionen
Jede Änderung erzeugt eine Entwurfsversion — eine veröffentlichte Version wird nie stillschweigend überschrieben.
- Veröffentlichen — Aktuellen Entwurf live schalten (legt die exakte Version fest)
- Veröffentlichung zurückziehen — Zurück auf Entwurf setzen
- Archivieren — In der Registry ausblenden
- Live-Kennzeichnung — Zeigt
(live)bei der Version, die Agenten tatsächlich erhalten
Native Skill-Bereitstellung
Skills werden zur Laufzeit als native opencode-Skills bereitgestellt — nicht in Prompts eingefügt.
So funktioniert es
- Einem Agenten wird ein Skill zugewiesen
- Beim Start einer Ausführung legt der Daemon den Skill unter
<workdir>/.opencode/skills/<slug>/an - Die projektbezogene Erkennung von opencode macht nur die Skills dieser Ausführung sichtbar
- Der Agent lädt den Skill bei Bedarf über das
skill-Tool (schrittweise Offenlegung)
Vorteile
- Strikte Isolation — Die Skills von Agent A sind für Agent B unsichtbar
- Versionsfixierung — Die veröffentlichte Version bleibt bis zur erneuten Veröffentlichung fest
- Token-Effizienz — Nur Name und Beschreibung stehen im Kontext; der vollständige Inhalt wird bei Bedarf geladen
- Skriptausführung — Skill-Skripte laufen als native opencode-Tools
Skill-Zuweisung
- Agent-Details → Tab Skills → Skill hinzufügen
- Aus der Workspace-Registry suchen/auswählen
- Aktiviert pro Zuweisung umschalten (zuweisen, aber deaktivieren ist möglich)
Veröffentlichungs-Workflow
Draft (editing) → Publish → Live (agents receive) → Edit → New Draft → Publish → New Live- Es gibt immer nur eine Live-Version
- Das Veröffentlichen legt die exakte Version fest (Agenten erhalten konsistentes Verhalten)
- Änderungen am Entwurf wirken sich erst nach der Veröffentlichung auf die Live-Version aus
Letzte Änderungen
- Native Skill-Bereitstellung — Skills werden pro Ausführung als opencode-Skills angelegt, strikte Isolation pro Agent, Laden bei Bedarf
- Tab Agent-Ansicht — Schreibgeschützte Vorschau des Layouts zur Laufzeit
- GitHub-Import — Import mit einem Klick aus GitHub-Repositories mit SKILL.md
- Versionsfixierung — Veröffentlichen legt die exakte Version fest; Änderungen am Entwurf wirken sich nicht auf die Live-Version aus