# Skills (/de/docs/verdent-manager/core-features/skills)
> Erweitern Sie die Fähigkeiten von Verdent mit wiederverwendbaren Wissenspaketen für spezialisierte Workflows und Fachwissen
Verdent **Skills** sind wiederverwendbare Wissenspakete, die die Expertise des Agents erweitern. Jeder Skill enthält domänenspezifische Prompts, Skripte, Referenzen und Best Practices. Rufen Sie einen Skill einfach namentlich auf, und der Agent lädt den entsprechenden Kontext und folgt dem vordefinierten Workflow.
***
## Was sind Skills? [#was-sind-skills]
### Grundkonzept [#grundkonzept]
Ein **Skill** ist ein strukturiertes Wissenspaket, das in einem Ordner gespeichert ist. Jeder Skill enthält eine Datei `SKILL.md`, die seinen Namen, seine Beschreibung und den detaillierten Prompt definiert. Wenn Sie einen Skill in einem Gespräch aufrufen, liest Verdent diese Datei und fügt ihren Inhalt in den Kontext des Agents ein.
### Wie sich Skills von Subagenten und MCP unterscheiden [#wie-sich-skills-von-subagenten-und-mcp-unterscheiden]
| Dimension | Skills | Subagenten | MCP |
| ------------------- | ---------------------------------------------------- | --------------------------------------------------------- | ------------------------------------------------------------- |
| **Auslöser** | Manueller Aufruf über `@skill` oder Erwähnung | Automatisch vom Haupt-Agent gestartet | Automatisch aufgerufen oder explizit angefordert |
| **Ausführung** | Erweitert den Hauptkontext des Gesprächs | Läuft als unabhängige Teilaufgabe mit isoliertem Kontext | Ruft externe Werkzeuge über JSON-RPC 2.0 auf |
| **Zweck** | Fachliche Anleitung (z. B. „wie man Tests schreibt“) | Eigenständige Vorgänge (z. B. „Code-Review durchführen“) | Zugriff auf externe Daten/Werkzeuge (z. B. Datenbankabfragen) |
| **Lebenszyklus** | Einmalige Kontexteinfügung | Schließt die Teilaufgabe ab und liefert Ergebnisse zurück | Persistenter Serverprozess während der Sitzung |
| **Implementierung** | Markdown-Dateien + optionale Skripte | Eingebaute Agent-Logik | Ausführbare Serverprozesse |
Kurz gesagt: **Skills liefern Wissen und Workflow-Anleitungen**, **Subagenten führen eigenständige Aufgaben aus**, und **MCP verbindet externe Werkzeuge und Datenquellen**.
***
## Skills verwenden [#skills-verwenden]
### Einen Skill aufrufen [#einen-skill-aufrufen]
Sie können einen Skill auf zwei Arten aufrufen:
**1. Den Skill-Namen im Gespräch erwähnen**
```
Use the skill-creator skill to help me create a new Skill
```
**2. Die @-Erwähnungssyntax verwenden**
```
@skill-creator help me create a Skill for API documentation generation
```
Wenn ein Skill ausgelöst wird:
1. Der Agent ruft das Werkzeug `skill` auf, um die Datei `SKILL.md` des Skills zu lesen
2. Der Dateiinhalt wird in den aktuellen Gesprächskontext eingefügt
3. Der Agent arbeitet gemäß der Anleitung des Skills weiter
### Verfügbare Skills durchsuchen [#verfügbare-skills-durchsuchen]
Greifen Sie über die Einstellungen auf das Skills-Panel zu:
1. Öffnen Sie das Menü **Einstellungen**
2. Wählen Sie den Tab **Skills**
3. Durchsuchen Sie installierte Skills und verfügbare Skills im Skill Store
Sie können auch `@` in das Eingabefeld eingeben, um die automatische Vervollständigung auszulösen und schnell einen verfügbaren Skill auszuwählen.
***
## Integrierte Skills [#integrierte-skills]
Verdent wird mit einer Reihe integrierter Skills für gängige Workflows geliefert:
| Skill | Beschreibung |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **docx** | Word-Dokumente (`.docx`) lesen, erstellen oder bearbeiten mit formatgetreuen visuellen Prüfungen |
| **find-skills** | Skills entdecken und installieren – nutzen Sie diesen, wenn Sie fragen „Wie mache ich X?“ oder nach neuen Fähigkeiten suchen |
| **frontend-design** | Erstellen Sie unverwechselbare, produktionsreife Frontend-Oberflächen mit hoher gestalterischer Qualität |
| **pdf** | PDF-Dateien lesen, erstellen oder überprüfen mit visueller Darstellung und Inhaltsextraktion |
| **pptx** | PowerPoint-Präsentationen (`.pptx`) lesen, erstellen oder bearbeiten |
| **skill-creator** | Ein geführter Workflow zum Erstellen und Weiterentwickeln eigener Skills |
| **xlsx** | Excel-Tabellen lesen, analysieren, visualisieren und intelligent bearbeiten |
Weitere Skills sind im **Skill Store** verfügbar. Öffnen Sie **Einstellungen → Skills → Store**, um zusätzliche Skills zu durchsuchen und zu installieren.
***
## Eigene Skills erstellen [#eigene-skills-erstellen]
Sie können eigene Skills erstellen, um das Fachwissen Ihres Teams oder projektspezifische Workflows zu kapseln.
### Struktur des Skill-Verzeichnisses [#struktur-des-skill-verzeichnisses]
Ein Standard-Skill-Ordner sieht wie folgt aus:
```
my-custom-skill/
├── SKILL.md # Required: Skill definition file
├── agents/
│ └── verdent.yaml # Optional: UI configuration (icons, display name)
├── scripts/ # Optional: helper scripts
└── references/ # Optional: reference docs or examples
```
### SKILL.md-Format [#skillmd-format]
`SKILL.md` ist die zentrale Skill-Datei und enthält YAML-Frontmatter sowie einen Markdown-Textkörper:
```markdown
---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
version: "1.0.0"
author: "Your Name"
license: "MIT"
---
# Detailed Instructions
This is the detailed prompt content the Agent reads.
## Workflow
1. Step one
2. Step two
3. ...
## Best Practices
- Practice suggestion 1
- Practice suggestion 2
```
**Anforderungen an die Frontmatter-Felder:**
* `name` (erforderlich): Muss mit dem Ordnernamen übereinstimmen. Erlaubt sind nur Kleinbuchstaben, Zahlen und Bindestriche (`a-z0-9-`). Länge: 1–64 Zeichen. Keine aufeinanderfolgenden Bindestriche oder Bindestriche am Anfang/Ende.
* `description` (erforderlich): Eine kurze Beschreibung, maximal 1024 Zeichen.
* `metadata` (optional): Version, Autor, Lizenz und weitere Metainformationen.
### Eigene Skills installieren [#eigene-skills-installieren]
**Methode 1: Import über Einstellungen**
1. Öffnen Sie **Einstellungen → Skills**
2. Klicken Sie auf **Skill importieren**
3. Wählen Sie den Skill-Ordner (oder ein Archiv im Format `.zip` / `.skill`)
4. Verdent validiert `SKILL.md` und installiert es unter `~/.verdent/skills/`
**Methode 2: Manuelles Kopieren**
```bash
cp -r my-custom-skill ~/.verdent/skills/
```
Der Skill wird nach einem Neustart von Verdent oder einer Aktualisierung der Skills-Liste verfügbar.
**Methode 3: Skill auf Projektebene**
Legen Sie den Skill innerhalb Ihres Projektverzeichnisses ab:
```bash
cp -r my-custom-skill /path/to/your/project/.verdent/skills/
```
Skills auf Projektebene sind nur innerhalb dieses Projekts sichtbar und haben Vorrang vor gleichnamigen globalen Skills.
***
## Skill-Geltungsbereiche [#skill-geltungsbereiche]
Verdent unterstützt drei Ebenen für den Geltungsbereich von Skills:
| Ebene | Speicherort | Sichtbarkeit |
| ----------- | ---------------------------- | ---------------------------------------------- |
| **Global** | `~/.verdent/skills/` | Alle Projekte und Arbeitsbereiche |
| **Projekt** | `/.verdent/skills/` | Nur die Arbeitsbereiche des aktuellen Projekts |
**Prioritätsregeln:**
Wenn Skills mit demselben Namen in mehreren Geltungsbereichen existieren:
* Projekt hat Vorrang vor Global
***
## Skill Store [#skill-store]
Verdent bietet einen **Skill Store** zum Durchsuchen und Installieren von Community- und offiziellen Skills.
### Den Skill Store durchsuchen [#den-skill-store-durchsuchen]
1. Öffnen Sie **Einstellungen → Skills**
2. Wechseln Sie zum Tab **Store**
3. Durchsuchen Sie verfügbare Skills oder nutzen Sie das Suchfeld
### Installation aus dem Store [#installation-aus-dem-store]
1. Finden Sie den gewünschten Skill im Store
2. Klicken Sie auf **Installieren**
3. Der Skill wird automatisch heruntergeladen und unter `~/.verdent/skills/` installiert
**Sicherheitsprüfung:**
Aus dem Store installierte Skills durchlaufen eine SHA256-Prüfsummenverifizierung, um die Dateiintegrität und Sicherheit zu gewährleisten.
***
## Praxisbeispiele [#praxisbeispiele]
### Beispiel 1: Einen neuen Skill erstellen mit `skill-creator` [#beispiel-1-einen-neuen-skill-erstellen-mit-skill-creator]
```
@skill-creator help me create a Skill for guiding the team on writing Go unit tests
```
Der Agent wird:
1. Den Inhalt des Skills `skill-creator` lesen
2. Sie durch das Ausfüllen von Skill-Name, Beschreibung und Kern-Prompt führen
3. Eine Standard-Datei `SKILL.md` generieren
4. Installationspfad und Verifizierungsschritte vorschlagen
### Beispiel 2: Daten analysieren mit `spreadsheet` [#beispiel-2-daten-analysieren-mit-spreadsheet]
```
@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart
```
Der Agent wird:
1. Den Skill `spreadsheet` laden
2. `pandas` und `openpyxl` verwenden, um die Excel-Datei zu lesen
3. Die Daten analysieren und Visualisierungen erstellen
4. Ergebnisse speichern oder im Gespräch anzeigen
### Beispiel 3: CI beheben mit `gh-fix-ci` [#beispiel-3-ci-beheben-mit-gh-fix-ci]
```
@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug
```
Der Agent wird:
1. Die `gh`-CLI verwenden, um die CI-Logs für PR #123 abzurufen
2. Den Fehler analysieren (z. B. Testfehler, Abhängigkeitsprobleme)
3. Einen Lösungsvorschlag unterbreiten
4. Mit Ihrer Zustimmung den Code ändern und die Korrektur pushen
***
## Häufig gestellte Fragen [#häufig-gestellte-fragen]
Wenn ein Skill aufgerufen wird, liest der Agent die Datei `SKILL.md`, die zur Token-Nutzung zählt und daher Credits verbraucht. Der Skill selbst führt jedoch keine zusätzlichen API-Aufrufe aus.
Ja. Installieren Sie den Skill unter `~/.verdent/skills/` (globaler Geltungsbereich), und er ist in allen Projekten verfügbar.
Klicken Sie unter **Einstellungen → Skills** mit der rechten Maustaste auf den Skill und wählen Sie **Löschen**. Integrierte Skills, die als `undeletable` markiert sind, können nicht gelöscht werden und werden beim nächsten Start erneut installiert.
Ja. Verdent erkennt automatisch Skills in `~/.cursor/skills`, `~/.claude/skills` und `~/.codex/skills` und fordert Sie zum Import auf. Klicken Sie auf **Aus externen Quellen importieren** unter **Einstellungen → Skills**.
* **Projektregel**: Immer aktive Anweisungen, die automatisch in jedes Gespräch eingefügt werden
* **Skill**: Bedarfsgesteuerte Wissenspakete, die nur beim Aufruf eingefügt werden
Verwenden Sie Regeln für universelle Coding-Standards; verwenden Sie Skills für spezifische Fach-Workflows.
Skills, die aus dem Skill Store installiert wurden, werden automatisch im Hintergrund auf Updates überprüft. Manuell installierte Skills müssen zur Aktualisierung erneut importiert werden (wobei die alte Version überschrieben wird).
***
## Erweiterte Verwendung [#erweiterte-verwendung]
### Skripte in Skills einbetten [#skripte-in-skills-einbetten]
Fügen Sie Ihrem Skill ein Verzeichnis `scripts/` hinzu und verweisen Sie in `SKILL.md` auf die Skripte:
```markdown
## Data Processing Script
Run the following command to process data:
\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`
```
Der Agent liest diese Anweisung und führt das Skript bei Bedarf aus.
### Auf Dokumentation verweisen [#auf-dokumentation-verweisen]
Speichern Sie API-Dokumente, Spezifikationen oder Beispielcode in einem Verzeichnis `references/` und verlinken Sie diese in `SKILL.md`:
```markdown
## Reference Documentation
See [references/api-spec.md](references/api-spec.md) for the detailed API specification.
```
Der Agent kann diese Referenzdateien gemäß den Anweisungen des Skills lesen.
***
## Best Practices [#best-practices]
**Halten Sie Skills fokussiert.** Jeder Skill sollte auf eine einzelne Domäne oder einen Workflow ausgerichtet sein. Vermeiden Sie „Alleskönner“-Skills – teilen Sie diese stattdessen in kleinere, spezialisierte Skills auf.
**Verwenden Sie eine klare Benennung.** Skill-Namen sollten prägnant und beschreibend sein, z. B. `api-doc-generator` statt `my-skill-1`.
**Stellen Sie Beispiele und Referenzen bereit.** Fügen Sie konkrete Beispiele und Referenzlinks in `SKILL.md` ein, damit der Agent das erwartete Ergebnis besser versteht.
**Führen Sie Versionsnummern.** Verwenden Sie das Feld `metadata.version`, um Updates und Kompatibilität nachzuverfolgen.
**Testen Sie vor dem Teilen.** Validieren Sie Ihren Skill in einem Testprojekt, bevor Sie ihn im Team ausrollen oder im Skill Store veröffentlichen.
***
## Siehe auch [#siehe-auch]
Wie Subagenten funktionieren und wie man sie verwaltet
Verbinden Sie externe Werkzeuge und Dienste über MCP
Konfigurieren Sie immer aktive Projekt- und Benutzerregeln
Überprüfen Sie Codeänderungen mit dem integrierten Reviewer