---
description: "Skills sind versionierte, wiederverwendbare Anweisungssätze, die aus einem guten Ergebnis eine dauerhafte Fähigkeit machen."
---

# Skills

Skills sind versionierte, wiederverwendbare Anweisungssätze, die aus einem guten Ergebnis eine dauerhafte Fähigkeit machen. Jedem Agenten kann ein Skill zugewiesen werden.

![Skills Registry](/documentation/blume-assets/content/docs/img/screenshots/06-skills.png)

## Skill-Registry

Die Seite **Skills** listet alle Skills im aktuellen Workspace auf.

![Skill List](/documentation/blume-assets/content/docs/img/screenshots/06-skills.png)

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:

![Skill Detail Instructions](/documentation/blume-assets/content/docs/img/screenshots/07-skill-detail.png)

### 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

![Agent View](/documentation/blume-assets/content/docs/img/screenshots/07-skill-detail.png)

### 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

1. Einem Agenten wird ein Skill zugewiesen
2. Beim Start einer Ausführung legt der Daemon den Skill unter `<workdir>/.opencode/skills/<slug>/` an
3. Die projektbezogene Erkennung von opencode macht nur die Skills dieser Ausführung sichtbar
4. 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

1. **Agent-Details** → Tab Skills → **Skill hinzufügen**
2. Aus der Workspace-Registry suchen/auswählen
3. **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