Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > ALBERT | AI Suite

Skills im Chat verwenden

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Skills sind wiederverwendbare KI-Anleitungen, die beschreiben, wie die KI eine bestimmte Aufgabe lösen soll. Sie können Skills von GitHub herunterladen, in agorum core verwalten und im Chat anwenden. Die KI liest die Anweisungen aus dem Skill und führt die beschriebene Aufgabe aus.

Voraussetzungen

Ihr Administrator hat die Toolgruppe Skills in Ihrem KI-Preset aktiviert.
Sie sind Mitglied der Benutzergruppe GRP_agorum.ai.agents.library.basic_ai_tools.
Es gibt eine Konvention, in welchen Ordner Skills heruntergeladen werden sollen, und dieser Ordner ist eingerichtet.

Skills auf GitHub entdecken

Bevor Sie einen Skill herunterladen, können Sie ein GitHub-Repository nach verfügbaren Skills durchsuchen. Geben Sie dazu im Chat eine Anweisung wie die folgende ein:

Zeige mir alle verfügbaren Skills im Repository
https://github.com/anthropics/anthropic-cookbook/tree/main/skills

Ergebnis: Die KI verwendet das Tool skill_github_tree und zeigt Ihnen eine Übersicht aller Skill-Ordner im Repository. Jeder Skill-Ordner wird mit seinem Namen und einer URL angezeigt.

Tipp: Sie müssen die GitHub-URL nicht kennen. Wenn in Ihrem Preset zusätzlich die Tools Web-Suche (web_search_searchapi) und Web-Crawl (web_crawl) aktiviert sind, kann die KI selbstständig im Internet nach passenden Skills suchen. Geben Sie einfach ein Thema an:

Suche mir die besten Claude Skills für das Thema Datenanalyse.

Die KI durchsucht das Internet, findet passende Skill-Repositories und zeigt Ihnen eine Übersicht mit Beschreibungen. Anschließend können Sie den gewünschten Skill direkt installieren lassen:

Installiere den Skill „financial-analysis“ in den Ordner /agorum/roi/Files/skills.

Skill herunterladen

Um einen Skill von GitHub in agorum core herunterzuladen, geben Sie im Chat eine Anweisung wie die folgende ein:

Lade den Skill https://github.com/anthropics/anthropic-cookbook/tree/main/skills/custom_skills/analyzing-financial-statements
in den Ordner /agorum/roi/Files/skills herunter.

Ergebnis: Die KI verwendet das Tool skill_download und lädt den Skill-Ordner mit allen enthaltenen Dateien in den angegebenen Zielordner herunter. Sie erhalten eine Bestätigung mit der Anzahl der heruntergeladenen Dateien.

Tipp: Wenn Sie nicht wissen, welche URL Sie verwenden sollen, bitten Sie die KI zuerst, das Repository nach Skills zu durchsuchen (siehe oben). Die KI zeigt Ihnen dann die passenden URLs an.

Hinweis: Wenn im Zielordner bereits ein Skill mit demselben Namen existiert, müssen Sie die KI explizit bitten, den bestehenden Skill zu überschreiben. Andernfalls erhalten Sie eine Fehlermeldung.

Installierte Skills auflisten

Um alle in agorum core verfügbaren Skills anzuzeigen, geben Sie im Chat eine Anweisung wie die folgende ein:

Welche Skills sind im System installiert?

Ergebnis: Die KI verwendet das Tool skill_list und zeigt Ihnen eine Liste aller installierten Skills mit Name, Beschreibung und Speicherort.

Skill-Inhalte lesen und anwenden

Um einen installierten Skill zu verwenden, bitten Sie die KI, den Skill zu lesen und auf Ihre Aufgabe anzuwenden:

Lies den Skill "PDF-Zusammenfassung" und fasse damit
das Dokument /agorum/roi/Files/berichte/quartalsbericht.pdf zusammen.

Ergebnis: Die KI liest die Anweisungen aus der SKILL.md-Datei des Skills und wendet sie auf Ihre Aufgabe an. Bei Bedarf liest die KI auch weitere Dateien innerhalb des Skills (z. B. Vorlagen oder Beispiele).

Eigene Skills erstellen

Sie können eigene Skills erstellen, um wiederkehrende Aufgaben oder unternehmensspezifische Abläufe als wiederverwendbare KI-Anleitung bereitzustellen. Ein Skill besteht aus einem Ordner mit einer SKILL.md-Datei und optional weiteren Dateien.

Aufbau eines Skills

Ein Skill-Ordner hat folgende Struktur:

mein-skill/
├── SKILL.md              # Pflicht: Einstiegsdokument mit Anweisungen
├── beispiel-vorlage.txt  # Optional: Vorlagen, Beispiele
├── config.json           # Optional: Konfigurationsdateien
└── beispiele/            # Optional: Unterordner mit weiteren Dateien
    └── ...

Die SKILL.md-Datei ist das Herzstück jedes Skills. Sie beginnt mit einem YAML-Frontmatter-Block, der Name und Beschreibung des Skills enthält, gefolgt von den eigentlichen Anweisungen für die KI:

---
name: Protokoll-Ersteller
description: Erstellt strukturierte Besprechungsprotokolle aus Notizen
---

# Protokoll-Ersteller

## Aufgabe
Du erstellst aus unstrukturierten Besprechungsnotizen ein
strukturiertes Protokoll.

## Vorgehen
1. Lies die bereitgestellten Notizen.
2. Identifiziere Teilnehmer, Datum und Themen.
3. Gliedere die Inhalte in:
   - Teilnehmer
   - Besprochene Themen
   - Beschlüsse
   - Offene Punkte mit Verantwortlichen und Fristen
4. Formuliere das Protokoll in sachlichem Stil.

## Ausgabeformat
Verwende die Vorlage aus der Datei vorlage.txt
im selben Skill-Ordner.

YAML-Frontmatter

Der Frontmatter-Block steht am Anfang der SKILL.md zwischen zwei ----Markierungen. Folgende Felder werden unterstützt:

Feld	Beschreibung
`version`	Empfohlen. Die Versionsnummer des Skills. Sie gehört als erstes Feld in den Frontmatter-Block, siehe Skills versionieren.
`name`	Pflicht. Der Anzeigename des Skills. Wird in der Skill-Liste angezeigt und ist über die Suche auffindbar.
`description`	Empfohlen. Eine kurze Beschreibung, was der Skill tut. Hilft der KI und anderen Benutzern, den Skill zu verstehen.

Hinweis: Die Felder description und version werden automatisch als Metadaten auf der SKILL.md-Datei gespeichert, sobald die Datei in agorum core pro erstellt oder geändert wird. Dadurch kann das Tool skill_list alle Skills effizient über die Suche finden und ihre Version mitliefern.

Tipps für gute Skills

Klare Anweisungen: Beschreiben Sie Schritt für Schritt, was die KI tun soll. Je präziser die Anweisungen, desto besser das Ergebnis.
Beispiele einfügen: Zeigen Sie der KI anhand konkreter Beispiele, wie das gewünschte Ergebnis aussehen soll.
Vorlagen nutzen: Legen Sie Vorlagen als separate Dateien im Skill-Ordner ab. Die KI kann diese über skill_get_content lesen und verwenden.
Aussagekräftiger Name: Wählen Sie einen Namen, der den Zweck des Skills sofort erkennen lässt.
Modular aufbauen: Erstellen Sie lieber mehrere spezialisierte Skills als einen großen, der alles abdeckt. Wie das in der Praxis aussieht, beschreibt der folgende Abschnitt.

Master-Skill-Strategie: Skills als Bausteine

Das wichtigste Gestaltungsprinzip für Skills lautet:

Ein Skill macht eine Sache gut und verweist für alles andere auf vorhandene Skills, statt deren Inhalte zu kopieren.

Daraus entsteht eine gestufte Kette. Jede Stufe ergänzt nur ihr Spezifisches und verweist für den Rest auf die nächstallgemeinere Stufe:

spezieller Skill      z. B. creating-pitch-decks
   |  ergänzt nur: Pitch-Dramaturgie, Investoren-Story
   v  verweist auf
allgemeiner Skill     z. B. creating-presentations
   |  ergänzt nur: Folienarten, Aufbau, Agenda
   v  verweist auf
Querschnitts-Skill    z. B. agorum-style-guide
      ergänzt: Farben, Fonts, Logo, visuelle Regeln

Der Querschnitts-Skill am Ende der Kette ist der Master-Skill: Er wird von mehreren spezialisierten Skills gemeinsam verwendet und ist die einzige Stelle, an der sein Thema gepflegt wird.

Warum sich das lohnt:

Wiederverwendung: Der Style-Guide-Skill wird von Präsentation, Angebot, Newsletter und Pitch gleichermaßen verwendet.
Wartbarkeit: Ändert sich der Style Guide, wird er an genau einer Stelle gepflegt; alle abhängigen Skills profitieren sofort.
Konsistenz: Es gibt nur eine Quelle der Wahrheit je Thema.
Effizienz: Die KI lädt nur die Skills, die sie für die aktuelle Aufgabe wirklich braucht.

Die Regeln dazu:

Verweisen Sie auf einen anderen Skill nur über dessen Namen und nie über UUID oder Vollpfad. Nur so bleibt ein Skill zwischen Systemen übertragbar.
Sagen Sie im verweisenden Skill ausdrücklich, was der andere Skill liefert und dass dessen Inhalt hier nicht wiederholt wird.
Führen Sie die verwendeten Skills in einem eigenen Abschnitt Abhängigkeiten der SKILL.md auf.
Prüfen Sie vor dem Bauen mit skill_list, was es schon gibt. Fehlt ein allgemeinerer Skill, legen Sie lieber ihn zuerst an, statt seine Inhalte zu duplizieren.

Tipp: Auch die mitgelieferten Skills sind so gebaut. albert-ai-chat regelt die Übernahme eines Chats und verweist je nach Aufgabe auf agorum-core-ai-use oder agorum-core-ai-coding.

Skills versionieren

Ein Skill kann eine Versionsnummer tragen. Sie gehört als erstes Feld in den Frontmatter-Block der SKILL.md:

---
version: "1.2.0"
name: mein-skill
description: …
---

Die Stellung ist keine Kosmetik: Ein externer KI-Programmierassistent erkennt beim ersten Leseaufruf, ob seine örtliche Kopie noch aktuell ist, ohne sich hinter der langen description vorarbeiten zu müssen.

Was agorum core pro damit tut:

Beim Speichern einer SKILL.md wird die Versionsnummer automatisch als Metadatum übernommen. Bereits vorhandene Dateien werden beim Bereitstellen nachgetragen.
Das Tool skill_list liefert die Versionsnummer als skillVersion mit. Ein externer Assistent gleicht seine Kopie damit in demselben Aufruf ab, mit dem er den Skill ohnehin sucht.
Ein örtlich neuerer Stand wird nie überschrieben.

Tipp: Erhöhen Sie die Versionsnummer bei jeder inhaltlichen Änderung. Ohne Versionsnummer gibt es keinen Abgleich: der Skill funktioniert zwar, aber eine veraltete Kopie bleibt unbemerkt alt. In einer Kette nach der Master-Skill-Strategie trägt jede Stufe ihre eigene Version; der verweisende Skill nennt die Version des anderen Skills bewusst nicht, sonst entstünde eine zweite Pflegestelle.

Skill in agorum core ablegen

Legen Sie den Skill-Ordner an einem beliebigen Ort in agorum core ab, z. B. unter /agorum/roi/Files/skills/. Sobald die SKILL.md-Datei gespeichert ist, wird der Skill automatisch erkannt und erscheint in der Skill-Liste.

Sie können den Skill-Ordner auch direkt im Chat erstellen lassen:

Erstelle einen neuen Skill "Protokoll-Ersteller" im Ordner
/agorum/roi/Files/skills mit einer SKILL.md, die beschreibt,
wie aus Besprechungsnotizen ein strukturiertes Protokoll
erstellt wird.

Typische Anwendungsbeispiele

Aufgabe	Beispiel-Prompt
Skills im Internet suchen	„Suche mir die besten Claude Skills für das Thema Projektmanagement.“ (Voraussetzung: Web-Suche und Web-Crawl sind im Preset aktiviert)
Repository durchsuchen	„Welche Skills gibt es unter https://github.com/user/repo?“
Skill herunterladen	„Lade den Skill pdf von https://github.com/user/repo/tree/main/skills/pdf nach /agorum/roi/Files/skills herunter.“
Installierte Skills anzeigen	„Liste alle installierten Skills auf.“
Skill anwenden	„Verwende den Skill ‘pptx’ und erstelle eine Präsentation zum Thema Projektplanung.“
Skill-Struktur anzeigen	„Zeige mir die Dateien im Skill ‘pdf’.“
Eigenen Skill erstellen	„Erstelle einen Skill ‘E-Mail-Antwort’ unter /agorum/roi/Files/skills, der beschreibt, wie professionelle E-Mail-Antworten formuliert werden.“
Skill aktualisieren	„Aktualisiere den Skill ‘pdf’ von GitHub und überschreibe die bestehende Version.“

Tipp: Sie können mehrere Schritte in einem einzigen Prompt kombinieren. Bitten Sie die KI beispielsweise, ein Repository zu durchsuchen, einen bestimmten Skill herunterzuladen und ihn direkt auf eine Aufgabe anzuwenden.

Mitgelieferte Skills

Zusätzlich zu den Grundfunktionen auf dieser Seite werden mit dem Plugin ALBERT | AI Agents mehrere einsatzbereite Skills ausgeliefert – etwa für interaktive .dynamic.html-Dokumente, für das Erstellen neuer Skills oder für externe Coding Agents wie Claude Code oder Codex.

Mitgelieferte Skills verwenden

Mitgelieferte Skills für externe Coding Agents