Du hast der KI bereits passende Notizen gegeben. Jetzt soll sie daraus einen kurzen Brief formulieren. Wieder schreibst du dieselben Hinweise in den Prompt: nichts erfinden, offene Angaben kennzeichnen, eine klare Bitte formulieren und den Text vor dem Versenden zeigen. Solche wiederkehrenden Arbeitsanweisungen kannst du als Datei aufbewahren.
Die Serie als Video
Das Video zur Serie zeigt in gut sechs Minuten, wie alle fünf Teile zusammenpassen. Die Angaben im Umzugsbeispiel sind erfunden.
In dieser Serie sind Notizen die Grundlage für Fakten und Entscheidungen. Ein Skill erfüllt eine andere Aufgabe: Er beschreibt einen Arbeitsablauf. Du lernst hier, wie du eine kleine Anleitung schreibst, sie auffindbar machst und prüfst, ob sie bei der richtigen Aufgabe verwendet wird. Für den ersten Versuch wählst du die Anleitung von Hand aus. Ein Assistent mit Skill-Unterstützung kann dir diese Auswahl später abnehmen.
Die Anleitung und Beispiele zu diesem Teil findest du im Serienordner auf GitHub. Das gesamte Repository als ZIP enthält auch das Material der anderen Teile. Für die Befehle öffnest du innerhalb des entpackten Repositorys den Serienordner serien/obsidian-und-ki. Dort liegt die zugehörige README.md.
Aufgabe, Notiz und Skill auseinanderhalten
Beim Umzug könnte die konkrete Aufgabe lauten: „Entwirf eine Anfrage für einen Transporter.“ Die Notizen liefern, was bereits bekannt ist: Ein Transporter ist vorgesehen, ein Termin und verbindliche Angebote fehlen. Der Skill beschreibt, wie eine solche Anfrage geschrieben wird.
Ein Skill darf fehlende Fakten nicht ersetzen. Er kann festlegen, dass die KI nach einem Datum fragt oder einen Platzhalter verwendet. Er kann ihr nicht erlauben, einen Termin als bestätigt darzustellen, nur damit der Brief fertig aussieht.
Auch ein Skill ist kein neues Wissen im Modell. Die Anleitung wirkt nur, wenn sie tatsächlich in die Bearbeitung geladen und berücksichtigt wird. Eine irgendwo gespeicherte Datei findet ein Chat im Browser nicht von selbst.
Wie eine einfache Anleitung aufgebaut ist
Im Beispielpaket zur Serie liegen unter 04-skills/beispiel-skills zwei Anleitungen: brief-schreiben und tabelle-pruefen.
Jeder Skill hat einen eigenen Ordner mit einer Datei namens SKILL.md. Der Kopf benennt die Anleitung und beschreibt ihren Einsatz. Darunter stehen die Arbeitsschritte und Grenzen. Eine gekürzte Fassung sieht so aus:
---
name: brief-schreiben
description: Schreibt kurze, freundliche Briefe und Mails ohne Floskeln. Nutzen bei Briefen an Vermieter, Behörden, Firmen.
---
# Brief schreiben
1. Kläre Empfänger, Anlass und gewünschte Handlung.
2. Übernimm Termine, Beträge und Zusagen nur aus den Belegen.
3. Kennzeichne fehlende Angaben oder frage gezielt nach.
4. Entwirf einen kurzen Brief mit einer klaren Bitte.
5. Zeige den Entwurf; versende nichts selbst.Die Dateistruktur ist für das mitgelieferte Katalogskript festgelegt. Ein Chat kann dieselbe Anleitung auch als kopierten Text verwenden. Ob ein bestimmter Assistent Skills automatisch erkennt, hängt von dessen unterstützten Ablageorten und Funktionen ab. Ein beliebiger Ordner namens skills genügt dafür nicht bei jedem Programm.
Eine gute Beschreibung hilft bei der Auswahl
„Hilft bei Texten“ wäre als Beschreibung zu allgemein. Sie könnte auf Briefe, Protokolle und Gedichte passen. „Schreibt kurze Briefe an Vermieter und Firmen“ nennt dagegen eine Aufgabe und einen erkennbaren Einsatzbereich.
Beschreibe in einer Zeile, wann der Skill passen soll. Die Anleitung darunter erklärt, wie gearbeitet wird. Wenn du mehrere sehr unterschiedliche Aufgaben in eine Datei packst, wird die Auswahl schwerer. Beginne mit zwei Anleitungen, die du tatsächlich brauchst, statt eine große Sammlung nur zu besitzen.
Der Prompt enthält den aktuellen Auftrag. Der Skill liefert wiederverwendbare Vorgaben dazu. Auch Prompts kannst du als Vorlage speichern. Der praktische Unterschied liegt hier in der festen Beschreibung und der gezielten Auswahl einer passenden Anleitung.
Den Katalog lokal erzeugen
Das Paket enthält 04-skills/skill_katalog.py. Es liest die Kopfzeilen der vorhandenen SKILL.md-Dateien und schreibt eine Übersicht namens KATALOG.md. Es ruft kein Modell auf und entscheidet nicht selbst, welcher Skill zu einer Aufgabe passt.
Öffne ein Terminal im Serienordner serien/obsidian-und-ki. Unter Linux:
python3 04-skills/skill_katalog.py 04-skills/beispiel-skillsUnter Windows in PowerShell:
py 04-skills\skill_katalog.py 04-skills\beispiel-skillsFür die Beispiele brauchst du Python ab Version 3.10. Der Katalog nennt die beiden vorhandenen Skills mit ihren Beschreibungen. Fehlende oder unvollständige Köpfe werden gemeldet. Das Skript verarbeitet einfache, einzeilige Kopfwerte; es ist kein vollständiger YAML-Parser. Prüfe die Ausgabe nach einer Änderung an den Skill-Dateien.
Die Auswahl mit einem Chat ausprobieren
Gib der KI zunächst den Katalog und diese Aufgabe:
Wähle aus dem beigefügten Katalog null bis zwei passende Skills.
Nenne die Namen und begründe die Auswahl kurz.
Wenn keiner passt, sage „kein passender Skill“.
Bearbeite die eigentliche Aufgabe noch nicht.
AUFGABE: Entwirf eine Anfrage nach einem Transporter-Angebot.
Termin und Fahrzeuggröße sind noch offen.Erwartet wird hier brief-schreiben. Gib der KI danach den Inhalt dieser Skill-Datei und die passenden Umzugsnotizen. Erst jetzt lässt du den Brief entwerfen. So kannst du sehen, ob die Anleitung wirklich vorlag und ob die KI fehlende Angaben offen gelassen hat.
Ein Skill-fähiger Assistent kann das Laden übernehmen. Auch dann solltest du nachvollziehen können, welche Anleitung verwendet wurde. Eine angezeigte Empfehlung allein bedeutet noch nicht, dass deren Inhalt bereits gelesen wurde.
Einen falschen Treffer verbessern
Bitte die KI mit demselben Katalog um ein Sitzungsprotokoll. Dafür liegt im Paket kein passender Skill. „Kein passender Skill“ ist deshalb ein vernünftiges Ergebnis. Wird trotzdem brief-schreiben gewählt, prüfe die Beschreibung und die Begründung.
Nimm nicht automatisch die nächstbeste Anleitung, wenn sie fachlich nicht passt. Du kannst die Aufgabe ohne Skill bearbeiten oder eine passende Anleitung ergänzen. Ein Brief-Skill sollte aus einem Protokoll keinen Brief machen.
Mit den beiden Beispielen kannst du eine kleine Testliste anlegen:
| Aufgabe | Erwartete Auswahl |
|---|---|
| Anfrage an eine Transporterfirma entwerfen | brief-schreiben |
| Summen in einer Tabelle kontrollieren | tabelle-pruefen |
| Sitzungsprotokoll erstellen | kein passender Skill |
| Transportbeschluss aus einer Notiz nachlesen | kein passender Skill |
Die Liste ist ein Test für diesen konkreten Katalog. Eine feste Trefferquote wäre keine allgemeine Qualitätsgarantie. Prüfe jeden falschen Treffer und auch, ob das Ergebnis nach dem Laden der Anleitung besser nachvollziehbar wird. Wenn viel vom Ergebnis abhängt, hilft dir ein klarer Hinweis auf den fehlenden Skill mehr als eine überzeugend vorgetragene falsche Anleitung.
Anleitungen begrenzen keine Betriebssystemrechte
Eine Regel wie „Versende nichts“ ist eine wichtige Arbeitsvorgabe, aber keine technische Sperre. Ob ein Assistent tatsächlich senden oder Dateien verändern kann, hängt von seinen Werkzeugen und deren Berechtigungen ab. Erteile nur die benötigten Zugriffe und prüfe wichtige Ergebnisse selbst.
Dasselbe gilt für fremde Skills. Lies sie, bevor du sie verwendest. Eine fremde Anleitung ist kein Grund, Zugangsdaten weiterzugeben, Programme aus unbekannter Quelle auszuführen oder Rechte auszuweiten. Vorgaben aus dem Auftrag und die tatsächlich eingerichteten Berechtigungen bleiben maßgeblich.
Skills und Wissensnotizen getrennt halten
Du kannst Skills in Obsidian bearbeiten, weil sie ebenfalls Textdateien sind. Bewahre sie dennoch in einem eigenen Unterordner auf, etwa skills/brief-schreiben/SKILL.md. Die Notizsuche aus Teil 2 soll nicht versehentlich jede Arbeitsanweisung als fachlichen Beleg einsammeln. Im Serienpaket liegen der Beispiel-Vault und die Skills deshalb in getrennten Verzeichnissen.
Für ein Gespräch reichen meist der konkrete Auftrag, wenige passende Faktennotizen und die tatsächlich benötigte Anleitung. Der Zusammenhang ist jetzt überschaubar: Die Notizen beantworten „Was ist bekannt?“, der Skill beantwortet „Wie soll diese Aufgabe bearbeitet werden?“
Dein erster Vergleich
Lass dieselbe Anfrage einmal nur mit den Faktennotizen und einmal zusätzlich mit dem Brief-Skill entwerfen. Vergleiche nicht allein den Ton. Prüfe, ob offene Angaben sichtbar bleiben, die Bitte verständlich ist und keine Zusage erfunden wurde. Eine schöne Formulierung mit falschem Termin wäre kein gutes Ergebnis.
Im letzten Teil richtest du bei Bedarf einen Assistenten im Terminal ein. Er kann die Dateien mit passenden Werkzeugen direkt lesen. Die Unterscheidung zwischen Fakten, Anleitungen und tatsächlichen Rechten bleibt dabei dieselbe.