Dein erster Skill – der Plan für den Morgen

Wiederkehrende Anweisungen an eine KI, in einer Datei gespeichert, heissen Skills. Der Mechanismus ist universell, und mehrere KI-Anbieter nutzen ihn, nicht nur Anthropic – das Dateiformat beschreibt der offene Standard Agent Skills.

Ein Skill ist gewöhnlicher Text im Markdown-Format, ähnlich wie CLAUDE.md. Der KI-Assistent lädt ihn erst dann, wenn er gebraucht wird, und führt die Anweisungen genau so aus, als hättest du sie im Gespräch eingetippt. Heute schreibst du deinen ersten Skill: einen, der deinen Plan für den Morgen zusammenstellt.

Für die Übung brauchst du die freigeschalteten Konnektoren für Post und Kalender, das passiert im Browser, und eine Datei profil.md in dem Ordner, in dem du arbeitest – sie entsteht aus einem Interview, das Claude Code mit dir führt.

Drei Wege, einen Skill zu schreiben

Ein Skill kann auf drei Wegen entstehen, und jeder führt zur selben Datei.

Der erste Weg ist der beschreibende: Du sagst Claude Code, wie der Skill arbeiten soll, und bittest darum, das zu speichern. Die Datei hast du in wenigen Minuten, aber beim späteren Testen kann sich einiges als korrekturbedürftig erweisen.

Der zweite Weg ist der praktische: In einem neuen Gespräch führst du mit Claude Code den ganzen Ablauf wie eine gewöhnliche Aufgabe durch und bittest am Schluss darum, das gerade Gemachte als Skill zu speichern. Jeder Schritt in der Datei wurde tatsächlich ausgeführt, darum gibt es weniger Überraschungen.

Der dritte Weg verbindet die beiden: Zuerst beschreibst du, wie der Skill arbeiten soll, dann führst du die Aufgabe zusammen mit der KI durch, und der Skill entsteht am Schluss. Diese Methode dauert am längsten, liefert aber den besten Ausgangspunkt – eben einen Ausgangspunkt, denn die meisten Skills brauchen direkt nach dem Erstellen ohnehin noch Feinschliff, und das gehört ganz normal zur Arbeit.

In dieser Lektion schreiben wir den Skill auf dem beschreibenden Weg, weil er nur ein paar einfache Schritte enthält. Bei umfangreicheren Skills lohnen sich die beiden anderen Wege mehr.

Schreib auf, was in den Morgenplan gehört

Bevor die Datei entsteht, lege fest, was du am Morgen sehen willst. Das ist die entscheidende Frage – wenn du es nicht weisst, errät es die KI auch nicht.

Bei uns besteht der Plan aus drei Punkten: E-Mails, die auf eine Antwort warten, die heutigen Termine im Kalender und das, was von gestern noch zu erledigen ist. Deine Liste kann anders aussehen – wer Aufträge mit Fristen bearbeitet, hat oben das, was heute fällig ist, und die Post rutscht auf Platz drei.

Schreib jeden Punkt so, dass er sagt, wie das Ergebnis aussehen soll, und nicht nur, wo nachzusehen ist. «Schau die Post durch» überlässt die ganze Entscheidung dem KI-Assistenten, und der trifft sie am Montag anders als am Donnerstag. «Liste die Nachrichten der letzten 24 Stunden auf, die auf meine Antwort warten, eine Zeile pro Nachricht» ergibt jedes Mal ein ähnliches Resultat.

Speichere nichts in eine Datei. Die Liste wandert komplett in die Anfrage, die du gleich an Claude Code schickst – je genauer du sie jetzt aufschreibst, desto weniger Korrekturen später.

Nenne drei Quellen: Postfach, Kalender und dein Profil

Ein Skill hat keinen eigenen Zugriff auf Daten: Er läuft in einem gewöhnlichen Gespräch und greift auf dieselben Konnektoren und Dateien zu, auf die Claude Code zugreift, wenn du direkt fragst. Darum müssen die Konnektoren für Post und Kalender freigeschaltet sein, bevor der Skill läuft.

Gib jedem Teil des Plans eine Quelle. E-Mails, die auf eine Antwort warten – aus dem Gmail-Konnektor. Die heutigen Termine und die freien Fenster dazwischen – aus dem Konnektor für Google Kalender. Die dritte Quelle ist die Datei profil.md aus einem Ordner, auf den die KI Zugriff hat, und sie macht den grössten Unterschied: Ohne sie bekommst du eine Liste aller ungelesenen Nachrichten, Newsletter und Zahlungsbestätigungen inklusive; mit ihr weiss Claude Code, womit du dich beschäftigst und wer deine Kundschaft ist, und unterscheidet darum eine Offertanfrage von der Werbung eines Grosshändlers.

Nenne die Quellen in den Schritten mit ihren eigenen Namen. «Schau, was ich heute zu tun habe» lässt Claude Code raten, wo es suchen soll, und bei zwei verbundenen Kalendern rät es einmal richtig und einmal falsch. «Prüf die heutigen Termine in Google Kalender» zeigt auf eine konkrete Quelle.

Lege den Namen des Skills und die Art des Aufrufs fest

Du musst dem Skill keinen Namen geben – Claude Code denkt sich selbst einen aus. Willst du ihn selbst vergeben, dann denk daran, dass der Name der Befehl ist, den du nach dem Schrägstrich eintippst, genauso wie zum Beispiel /config, über den wir in einem eigenen Tipp geschrieben haben. Darum besteht er nur aus Kleinbuchstaben, ohne Sonderzeichen, mit Bindestrichen statt Leerzeichen. Der Name morgenplan ergibt den Befehl /morgenplan.

Der Befehl, der den Skill aufruft, ist Pflicht. Zusätzlich kannst du eine Formulierung in natürlicher Sprache festlegen, mit der du den Skill «auf Menschenart» startest, mitten im normalen Gespräch. In unserem Fall könnte das sein: «wenn ich sage ‹erstell mir den Plan für heute› oder etwas Ähnliches». Die Worte etwas Ähnliches sind hier sehr wichtig – ohne sie «hört» die KI nur auf genau die Formulierungen, die du nennst.

Bitte Claude Code, den Skill zu speichern

Den Skill schreibst du nicht in einem Editor – die Datei speichert Claude Code auf deine Bitte hin. Bitte um einen globalen Skill, also einen, der in jedem Ordner auf deinem Computer verfügbar ist (es gibt auch lokale Skills, dazu kommen wir gleich). Gib in der Anfrage den Namen an, die Formulierung für den Start «auf Menschenart» und die Schritte aus deiner Liste.

Unten steht ein Beispiel-Prompt zum Erzeugen des Skills – tausche die Schritte bei Bedarf gegen deine eigenen:

Speichere einen globalen Skill mit dem Namen morgenplan. Führe ihn auch dann aus, wenn ich sage «erstell mir den Plan für heute» oder etwas Ähnliches. Der Skill soll meinen Plan für den Morgen in drei Schritten zusammenstellen:
1. Nimm aus der Datei profil.md in diesem Ordner, womit ich mich beschäftige und wer meine Kundschaft ist, und lass danach Newsletter und Werbung weg.
2. Liste aus dem Gmail-Konnektor die Nachrichten der letzten 24 Stunden auf, die auf meine Antwort warten – eine Zeile pro Nachricht: Absender, Betreff, worum es geht.
3. Liste aus Google Kalender die heutigen Termine mit Uhrzeiten auf und die freien Fenster dazwischen.
Bevor du die Datei speicherst, zeig mir den Inhalt des Skills und warte auf mein «ok».

Nach dem Absenden zeigt dir Claude Code den Inhalt des Skills zum Absegnen. Lies ihn einmal. Fehlt in den Schritten etwas, sag es jetzt, bevor die Datei entsteht; stimmt alles, schreib «ok». Claude Code speichert den Skill in seinem Skills-Ordner, und der Befehl /morgenplan steht ab dem nächsten Gespräch bereit.

Wie ein Skill aufgebaut ist

Der Inhalt, den Claude Code dir zum Absegnen gezeigt hat, besteht aus zwei Teilen. Oben steht der Frontmatter: ein paar Zeilen zwischen zwei Strichreihen ---. Im Frontmatter stehen zusätzliche Angaben, die die Datei beschreiben. Das ist ein verbreitetes Muster – du findest es in vielen .md-Dateien, mit denen Claude Code arbeitet. Der Frontmatter eines Skills hat zwei Felder:

• name – der Name des Skills, derselbe, der auch der Schrägstrich-Befehl ist;
• description – die Beschreibung: wozu der Skill dient und wann er zu verwenden ist. Hierhin gehört deine Formulierung «erstell mir den Plan für heute oder etwas Ähnliches». Claude Code vergleicht das, was du im Gespräch schreibst, mit der Beschreibung und startet den Skill bei einem Treffer von selbst, ohne Schrägstrich. Die Beschreibungen aller Skills liest Claude Code zu Beginn jedes Gesprächs – so weiss es, welche Skills es hat und wann es zu welchem greifen soll.

Unter dem Frontmatter kommt der Rest: deine Schritte, in gewöhnlichem Text, in der Reihenfolge der Ausführung. Claude Code liest sie erst dann, wenn es entschieden hat, dass es den Skill braucht.

Unser Skill sieht ungefähr so aus:

---
name: morgenplan
description: Stellt den Plan für den Morgen aus Profil, Post und Kalender zusammen. Verwenden, wenn die Nutzerin oder der Nutzer «erstell mir den Plan für heute» oder etwas Ähnliches schreibt.
---

1. Nimm aus der Datei profil.md im aktuellen Ordner, womit sich die Person beschäftigt und wer ihre Kundschaft ist; lass danach Newsletter und Werbung weg.
2. Liste aus dem Gmail-Konnektor die Nachrichten der letzten 24 Stunden auf, die auf eine Antwort warten – eine Zeile pro Nachricht: Absender, Betreff, worum es geht.
3. Liste aus Google Kalender die heutigen Termine mit Uhrzeiten auf und die freien Fenster dazwischen.

Starte den Skill in einem neuen Gespräch

Schliess das laufende Gespräch und öffne ein neues. In dem Gespräch, in dem der Skill entstanden ist, füllt das, was unterwegs im Chat gesagt wurde, die Lücken der Datei – morgen früh fehlt dieser Zusammenhang, darum zeigt erst ein sauberes Gespräch, was im Skill wirklich funktioniert.

Tipp /morgenplan ein oder schreib «erstell mir den Plan für heute» und prüf, ob der Plan, den du bekommst, der ist, den du willst – die richtigen Quellen und die richtige Form des Ergebnisses bei jedem der drei Schritte.

Erscheint der Befehl nach dem Schrägstrich nicht, und der Skills-Ordner ist heute zum ersten Mal entstanden, dann schliess Claude Code ganz und starte claude noch einmal – einen neuen Skills-Ordner bemerkt Claude Code erst nach einem Neustart. Immer noch nichts? Tipp /skills ein: Du bekommst die Liste der Skills, die Claude Code im Moment sieht. Fehlt deiner dort, frag im Gespräch: «prüf, wo du den Skill morgenplan gespeichert hast und ob das der globale Skills-Ordner ist».

Korrigiere die Schritte, die anders herausgekommen sind

Der erste Lauf klappt selten ganz so, wie er sollte, und das gehört beim Schreiben eines Skills einfach dazu – bei uns sieht es genauso aus. Meist war ein Schritt zu allgemein: Der Name der Quelle oder die Beschreibung des Ergebnisses fehlte, und der Skill hat alles aufgelistet, was er gefunden hat.

Jede Korrektur nimmt Claude Code vor – statt die Datei von Hand zu bearbeiten, bitte es um die Änderung. Die KI schreibt Anweisungen in der Form, die sie am besten liest, oft mit anspruchsvollerer Markdown-Formatierung, und eine Änderung von Hand bringt diese Form leicht durcheinander.

Eine Beispielkorrektur, um die du bitten kannst:

Ändere im Skill morgenplan den Schritt zur Post: Lass Newsletter und automatische Bestätigungen weg, behalte nur Nachrichten, auf die jemand eine Antwort erwartet.

Nach jeder Änderung öffnest du ein neues Gespräch und startest den Skill noch einmal. Zwei, drei solche Runden sind der übliche Feinschliff eines Skills. Danach muss die Datei meist nicht mehr angefasst werden – es sei denn, du willst sie erweitern.

Ein lokaler Skill – nur für einen Ordner

Ein globaler Skill wirkt in jedem Ordner auf deinem Computer. Ein lokaler Skill existiert nur in dem Ordner, in dem du ihn speicherst, und wirkt nur dann, wenn du claude in diesem Ordner startest.

Lokale Skills sind praktisch, wenn du mehrere Arten von Arbeit in getrennten Ordnern führst und jede eine eigene Version desselben Ablaufs braucht – der Morgenplan für die Firma und der Morgenplan für ein Feierabendprojekt können dann eigene Schritte haben. Du bittest genauso darum, nur schreibst du statt «global» eben «lokal, nur für diesen Ordner».

Wie gross ein Skill sein sollte

Ein häufiger Fehler am Anfang ist das Bauen grosser Dateien, die wie ein Schweizer Taschenmesser funktionieren – eine für fast alles. Ein anderer Ansatz bewährt sich besser.

Skills sollten wie Lego-Steine funktionieren: Jeder erledigt eine einzige, konkrete Aufgabe. Wenn einer nicht richtig arbeitet, laufen die übrigen weiter.

Dazu kommt der Tokenverbrauch. Besteht ein grosser Skill aus vielen bedingten Anweisungen wie «in Situation A mach X, in Situation B mach Y», dann ist die Hälfte der Tokens fürs Lesen des Skills verschwendet. Nach der Aufteilung in getrennte Skills A und B lädt der KI-Assistent nur den, den er im Moment braucht.

Wenn du nicht weisst, ob dein Skill zu gross geworden ist, frag Claude Code: «lohnt es sich, diesen Skill in mehrere kleinere aufzuteilen?».

Und wenn dich die Vorstellung vom Taschenmesser-Skill weiter reizt, kannst du einen sogenannten Orchestrator bauen – einen Skill, dessen Aufgabe es ist, andere Skills aufzurufen.

Zurück zu unserem Morgenplan. Nehmen wir an, in einem halben Jahr wächst sein Inhalt stark an, und es tauchen bedingte Anweisungen auf wie «Mails nur an geraden Tagen prüfen, den Kalender an ungeraden». Dann kannst du zwei kleinere Skills daraus herausziehen: mails-pruefen und kalender-pruefen. In morgenplan lässt du nur die Anweisung stehen, diese beiden neuen Skills an den passenden Tagen zu verwenden. Du rufst weiterhin denselben Skill auf wie zuvor, aber innen läuft alles runder.

Was du aus dieser Lektion mitnimmst

Ein Skill ist ein gespeicherter Ablauf, den Claude Code in einem gewöhnlichen Gespräch ausführt. Er greift auf dieselben Konnektoren und Dateien zu wie bei einer direkten Frage – ohne Konnektoren und Profil bleibt der Plan darum leer.

Die Datei schreibt Claude Code, du sagst, was hineingehört. Jeder Schritt nennt seine Quelle und sagt, wie das Ergebnis aussehen soll – «liste die Nachrichten der letzten 24 Stunden auf, die auf eine Antwort warten, eine Zeile pro Nachricht», nicht «schau in die Post».

Ein Skill hat einen Kopf und Schritte. Im Kopf (dem Frontmatter) stehen der Name, also der Befehl /morgenplan, und eine Beschreibung mit der Formulierung, bei der Claude Code den Skill von selbst startet; unter dem Kopf stehen deine Schritte.

Einen Skill prüfst du in einem neuen Gespräch und korrigierst ihn mit je einem Satz. Im Gespräch, in dem er entstanden ist, füllt der Chat die Lücken; zwei, drei Korrekturrunden sind normal.

Ein Skill erledigt eine Sache. Einen grossen Skill voller bedingter Anweisungen teilst du in kleinere auf, und wenn du sie gemeinsam aufrufen willst, machst du einen Orchestrator daraus – einen Skill, der die übrigen startet.

Aufgaben

Hak ab, was erledigt ist. Der Stand bleibt im Browser gespeichert, du kannst also morgen zu dieser Liste zurückkommen.

• Die Liste der drei Dinge im Morgenplan steht, jedes mit Quelle und Form des Ergebnisses
• Name des Skills gewählt und Formulierung für den Start «auf Menschenart» festgelegt
• Der globale Skill morgenplan ist von Claude Code nach deinem «ok» gespeichert
• /morgenplan in einem neuen Gespräch gestartet und Punkt für Punkt gelesen
• Ein Schritt, der anders herauskam, mit einem Satz im Gespräch korrigiert
• Der Skill auch mit der Formulierung «erstell mir den Plan für heute» gestartet, ohne Schrägstrich