Skills

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?

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

Kurz gesagt: Skills liefern Wissen und Workflow-Anleitungen, Subagenten führen eigenständige Aufgaben aus, und MCP verbindet externe Werkzeuge und Datenquellen.

Skills verwenden

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

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

Verdent wird mit einer Reihe integrierter Skills für gängige Workflows geliefert:

Eigene Skills erstellen

Sie können eigene Skills erstellen, um das Fachwissen Ihres Teams oder projektspezifische Workflows zu kapseln.

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

SKILL.md ist die zentrale Skill-Datei und enthält YAML-Frontmatter sowie einen Markdown-Textkörper:

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

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

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:

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

Verdent unterstützt drei Ebenen für den Geltungsbereich von Skills:

Prioritätsregeln:

Wenn Skills mit demselben Namen in mehreren Geltungsbereichen existieren:

• Projekt hat Vorrang vor Global

Skill Store

Verdent bietet einen Skill Store zum Durchsuchen und Installieren von Community- und offiziellen Skills.

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

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

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

@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

@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

Erweiterte Verwendung

Skripte in Skills einbetten

Fügen Sie Ihrem Skill ein Verzeichnis scripts/ hinzu und verweisen Sie in SKILL.md auf die Skripte:

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

Speichern Sie API-Dokumente, Spezifikationen oder Beispielcode in einem Verzeichnis references/ und verlinken Sie diese in SKILL.md:

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

Siehe auch