Fähigkeiten (Skills) einbinden

Eine Fähigkeit (englisch Skill) ist eine wiederverwendbare Arbeitsanleitung in einer einzigen Datei mit dem Namen SKILL.md. Darin steht, wie eine bestimmte Aufgabe zu erledigen ist: der Schreibstil für Texte, das Vorgehen bei einer Analyse, die Regeln für ein Review. Du installierst diese Anleitung einmal in metisBrain, danach kann jede verbundene KI sie laden und strikt danach arbeiten.

• Eine Fähigkeit ist reiner Text, kein Programm. Sie steuert das Verhalten der KI, sie führt nichts aus.
• Sie liegt in deinem metisBrain, nicht im jeweiligen KI-Client. Deshalb steht dieselbe Fähigkeit in Claude, ChatGPT, Cursor und Claude Code zur Verfügung.
• Fähigkeiten kommen ausschließlich aus GitHub. Der Weg dorthin führt immer über das Dashboard.

Die Installation läuft im Dashboard im Bereich Fähigkeiten. Dort gibt es das Feld Aus GitHub installieren. Du fügst die Adresse des Repositorys ein und klickst auf Installieren. metisBrain akzeptiert dabei mehrere Schreibweisen:

https://github.com/owner/repo
github.com/owner/repo
owner/repo
https://github.com/owner/repo.git
[email protected]:owner/repo.git

metisBrain sucht anschließend die SKILL.md: zuerst im Wurzelverzeichnis des Repositorys, und wenn sie dort nicht liegt, im gesamten Verzeichnisbaum. Gibt es mehrere Treffer, gewinnt der flachste, also der mit dem kürzesten Pfad. Findet metisBrain keine SKILL.md, schlägt die Installation fehl und es wird nichts angelegt.

• Geladen wird ausschließlich die Datei SKILL.md. Weitere Dateien, Skripte oder Unterordner aus dem Repository werden nicht übernommen.
• Dasselbe Repository ein zweites Mal zu installieren erzeugt kein Duplikat: der vorhandene Eintrag wird überschrieben.
• Im Abschnitt Empfohlen liegt ein kuratierter Katalog. Diese Fähigkeiten installierst du mit einem Klick, ohne eine Adresse einzutippen. Bereits installierte Einträge sind dort als installiert markiert.

Eine SKILL.md ist eine Markdown-Datei mit einem YAML-Vorspann zwischen zwei Zeilen aus drei Bindestrichen. Der Vorspann beschreibt die Fähigkeit, der Text darunter ist die eigentliche Anleitung, die die KI später befolgt.

---
name: Humanizer
description: Entfernt KI-typische Schreibmuster und macht Texte natuerlicher.
version: 1.2.0
---

# Humanizer

Gehe beim Ueberarbeiten eines Textes so vor:

1. Ersetze Fuellwoerter durch konkrete Aussagen.
2. Kuerze Schachtelsaetze auf hoechstens einen Nebensatz.
3. Behalte Fakten, Zahlen und Zitate unveraendert.

• name: der Anzeigename. Fehlt er, nutzt metisBrain den Namen des Repositorys.
• description: die kurze Beschreibung. Sie wird auf 400 Zeichen gekürzt und dient der KI als Entscheidungsgrundlage, ob die Fähigkeit zur Aufgabe passt.
• version: optional. Steht keine Version im Vorspann, versucht metisBrain, eine Versionsnummer aus dem Text zu lesen.

Sobald deine KI über den MCP-Connector mit metisBrain verbunden ist, stehen ihr fünf Werkzeuge für Fähigkeiten zur Verfügung. Du musst sie nicht auswendig kennen: es reicht, die Fähigkeit im Chat beim Namen zu nennen.

Nutze die Fähigkeit humanizer für diesen Text.
/humanizer Schreibe diesen Absatz natuerlicher.
Welche Fähigkeiten habe ich installiert?

• list_skills (ohne Parameter): zeigt alle installierten Fähigkeiten mit Beschreibung und Version.
• use_skill mit name: lädt eine Fähigkeit. Als Name funktionieren das Kürzel (der Slug), der Anzeigename oder owner/repo.
• use_skills mit names (Liste) oder set (Name eines Bündels): lädt mehrere Fähigkeiten gemeinsam.
• suggest_skills mit task: schlägt aus den installierten Fähigkeiten die passendsten vor, höchstens fünf.
• learn_skill mit name und learning: speichert eine Erfahrung zu einer Fähigkeit.

Standardmäßig ist die automatische Fähigkeiten-Auswahl eingeschaltet. Beim Verbinden erhält die KI die Anweisung, bei jeder inhaltlichen Aufgabe still zu prüfen, ob eine installierte Fähigkeit hilft. Passt eine klar, lädt sie diese selbst und nennt dir danach kurz, welche sie genutzt hat. Passt nichts eindeutig, arbeitet sie normal weiter.

• Den Schalter findest du im Dashboard im Bereich Fähigkeiten in der Karte Automatische Fähigkeiten-Auswahl.
• Ausgeschaltet greift die KI nur dann zu einer Fähigkeit, wenn du sie ausdrücklich nennst.
• Die Änderung wirkt beim nächsten Verbindungsaufbau des Clients.

Du musst nicht in einen Chat wechseln, um eine Fähigkeit auszuprobieren. Jede installierte Fähigkeit hat den Button Anwenden. Du fügst einen Text ein, klickst auf Ausführen und bekommst das Ergebnis direkt im Dialog. Ein Häkchen speichert das Ergebnis auf Wunsch als Notiz in deinem Wissensraum.

Ändert sich die SKILL.md im Repository, erkennt metisBrain das an der geänderten Datei selbst, nicht an der Versionsnummer im Vorspann. Die betroffene Fähigkeit bekommt in der Liste die Markierung Update, und ein Klick auf Aktualisieren holt die neue Fassung.

• Der automatische Update-Check läuft je Fähigkeit höchstens alle 20 Minuten, damit GitHub nicht unnötig abgefragt wird.
• Der Button Nach Updates suchen oben rechts prüft jederzeit sofort und ohne diese Wartezeit.
• Über Ansehen liest du den vollen Text der installierten SKILL.md, so wie ihn die KI bekommt.
• Entfernen löscht die Fähigkeit aus deinem Konto. Das Repository auf GitHub bleibt unberührt.