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. Das Tool skill_list liefert dabei nur aktive Skills; deaktivierte Skills erscheinen nur mit der Option includeDisabled, siehe Skill deaktivieren.

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.
disabled	Optional. Mit `disabled: true` gilt der Skill als deaktiviert, siehe Skill deaktivieren.

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.
Trägt ein Skill keine Version, fehlt das Feld skillVersion in der Ausgabe von skill_list.

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.

Skill deaktivieren

Mit einem einzigen Eintrag im Frontmatter können Sie einen Skill ausschalten, ohne ihn zu löschen:

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

Steht im Kopf (Frontmatter) einer SKILL.md disabled: true, gilt der Skill als deaktiviert. Dazu setzt der Verarbeitungsschritt für die SKILL.md das Metadatum agorum_ai_agents_library_basic_skill_disabled (Typ boolean). Als deaktiviert gilt der Skill nur bei dem Wert true (Groß-/Kleinschreibung spielt keine Rolle); jeder andere Wert und ein fehlender Eintrag heißen aktiv. Vorhandene Skills ohne dieses Metadatum gelten als aktiv.

Was die Deaktivierung bewirkt:

Das Tool skill_list liefert nur aktive Skills. Deaktivierte Skills erscheinen mit der Option includeDisabled und sind in der Liste mit skillDisabled gekennzeichnet.
Die Suche nach dem Skillnamen übergeht deaktivierte Skills, etwa für den Dienst der Skill-Assets. Eine deaktivierte Kopie macht einen Namen daher nicht mehr mehrdeutig; Assets eines deaktivierten Skills werden nicht mehr ausgeliefert.
Die Tools skill_tree, skill_get_content und skill_download arbeiten weiterhin auf einer übergebenen ID und funktionieren auch bei deaktivierten Skills.

Tipp: So können Sie eine alte Kopie eines Skills stilllegen, ohne sie zu löschen.

Skills im Suchfilter finden

Im agorum core information center steht für alle, die ALBERT | AI nutzen dürfen, der Suchfilter Skills zur Verfügung. Er durchsucht die SKILL.md-Dateien des Systems und bietet Filter nach Status, Name, Beschreibung und Version sowie nach Erstell- und Änderungsdatum.

Deaktivierte Skills sind im Standard ausgeblendet. Im Filter Status können Sie die Auswahl aufheben, um alle Skills zu sehen, oder umkehren, um nur deaktivierte Skills zu sehen.
Die Kartenliste zeigt statt der Datei den Skill: den Skillnamen als Titel, die Version und die Beschreibung. Deaktivierte Skills tragen die Kennzeichnung Deaktiviert.
Skills ohne Version fasst der Versionsfilter unter dem Eintrag none zusammen.

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