Skill und Subagent – Arbeitsteilung

Stell dir eine Küche mit einem einzigen Koch vor. Die Haupt-KI ist dieser Koch, und der Skill ist sein Kochbuch: Er sagt ihm, wie das ganze Gericht zubereitet wird. Das Problem ist, dass der Koch allein ist. Er schält die Karotten, rührt die Suppe um, damit nichts anbrennt, und versucht nebenbei, das Hauptgericht im Auge zu behalten. Darum braucht er für das ganze Gericht länger, und seine Aufmerksamkeit ist zerstreut, weil er alles gleichzeitig bewältigen muss.

Ein Subagent ist die Küchenhilfe unseres Kochs: eine eigene KI, der der Koch eine ganz bestimmte Aufgabe überträgt. Die Küchenhilfe kann parallel zum Koch arbeiten, und weil man zum Karottenschälen keine Kochausbildung braucht, kann ein Subagent ein kleineres KI-Modell verwenden als der Koch selbst.

Verlassen wir unsere gedachte Küche und schauen wir uns ein echtes Beispiel an. In der Lektion über den ersten Skill haben wir einen Skill gebaut, der den Plan für den Morgen zusammenstellt. Dort musste eine einzige Haupt-KI alles selbst erledigen: Post und Kalender prüfen und am Ende daraus einen Plan machen. Sie tat das der Reihe nach, eine Aufgabe nach der anderen, und alles mit demselben Modell, auf dem das ganze Gespräch lief. Ein solcher Skill eignet sich bestens, um einen Teil der Arbeit an Subagenten abzugeben: einen schickst du zur Post, einen zweiten zum Kalender. Die Haupt-KI bleibt dann bei der wichtigsten Aufgabe – den Tagesplan aus den Daten zusammenzustellen, die sie von den Subagenten bekommt.

Wozu einen Skill überhaupt auf Subagenten aufteilen

Post und Kalender kann Haiku durchsehen, das schnelle und günstige Modell von Claude. Jede Quelle bekommt einen eigenen Subagenten mit Haiku. Der erste sieht das Postfach durch und listet die Mails der letzten 24 Stunden auf, jede in einer Zeile. Der zweite sieht den Kalender durch und listet die heutigen Termine auf. Die Haupt-KI arbeitet weiter mit einem grösseren Modell, zum Beispiel mit Opus oder Sonnet: Sie entscheidet, was wichtig ist, und stellt aus diesen beiden Listen den Tagesplan zusammen.

Ein Subagent liest die Mails oder den Kalender in seinem eigenen Kontext. Ins Hauptgespräch gibt er nur das Ergebnis zurück: eine Zeile pro Mail statt des vollständigen Texts von vierzig Nachrichten. So belegen das ganze Postfach und der ganze Kalender keinen Platz im Hauptgespräch.

Wir schlagen hier den einfachsten Weg vor: Subagenten aus einem Skill herauszulösen, der schon funktioniert. Es ist nicht der einzige. Du kannst auch gleich nur Subagenten anlegen, ohne Skill, oder den Skill von Anfang an zusammen mit Subagenten entwerfen. Subagenten aus einem fertigen Skill herauszulösen, ist am einfachsten, weil du schon siehst, wie seine einzelnen Teile arbeiten.

Miss den Skill und frag dann, was du herausnehmen kannst

Der Skill morgenplan funktioniert bereits. Öffne ein neues Gespräch, starte darin den Skill und tipp gleich, nachdem er fertig ist, /context ein. Claude Code zeigt ein farbiges Raster: was den Kontext belegt und wie viel Platz noch frei ist. Mach einen Screenshot – am Ende der Übung vergleichst du ihn mit dem Stand nach der Änderung.

Die ganze weitere Arbeit an den Subagenten und am Skill machst du im selben Gespräch. Fang mit einer Durchsicht des Skills an:

Lies meinen Skill morgenplan. Liste die Teile auf, die ein eigener Subagent erledigen könnte, und separat die, die im Skill bleiben müssen. Schreib zu jedem Teil, wie viel Material gelesen werden muss, um ihn zu erledigen, und wie viel davon im Tagesplan landet.

Der letzte Satz des Prompts zeigt, welcher Teil sich zum Herauslösen eignet: einer, der viel liest und wenig an den Plan weitergibt. Vierzig Mails durchzusehen, um jede in einer Zeile zusammenzufassen, ist so ein Teil. Den Plan aus fertigen Listen zusammenzustellen ist es nicht, denn das ist die wichtigste Arbeit, und sie bleibt bei der Haupt-KI.

Auf der Liste «im Skill lassen» sollte der Schritt mit der Datei profil.md stehen. Aus dem Profil weiss die Haupt-KI, womit du dich beschäftigst, und entscheidet anhand davon, welche Mails wichtig sind.

Trag das Modell ausdrücklich ein, sonst nimmt der Subagent deins

Ein Subagent ist eine gewöhnliche Textdatei mit einer Anweisung, genau wie ein Skill. Die Datei schreibst du nicht von Hand – bitte Claude Code, zuerst einen Subagenten für die Post anzulegen:

Leg einen Subagenten postfach-durchsicht an, der in allen meinen Projekten verfügbar ist, auf Grundlage des Schritts zur Post aus dem Skill morgenplan. Der Subagent soll alle Mails der letzten 24 Stunden auflisten, eine Zeile pro Nachricht: Absender, Betreff und kurz, worum es geht. Er soll nicht bewerten, welche Mails wichtig sind – diese Entscheidung trifft der Skill. Gib ihm das Modell haiku, ohne Versionsnummer. Schränk seine Werkzeuge nicht ein, denn er braucht Zugriff auf den Gmail-Konnektor. Ändere den Skill morgenplan noch nicht.

Das Wichtigste daran ist der Satz über das Modell. In unseren Schulungen lassen ihn Teilnehmende oft weg, weil sie annehmen, dass Claude Code dem Subagenten von selbst ein kleineres Modell zuteilt. Darauf solltest du nicht zählen: Ohne diesen Satz arbeitet der Subagent meist mit demselben Modell wie das Hauptgespräch, und die Ersparnis ist weg.

Öffne die Datei des Subagenten einmal und schau, was entstanden ist. Oben steht ein Kopf, ähnlich wie beim Skill:

---
name: postfach-durchsicht
description: Listet die Mails der letzten 24 Stunden auf, eine Zeile pro Nachricht.
model: haiku
---

Das Feld description sagt Claude Code, wann es diesem Subagenten Arbeit übergeben soll. Die Zeile model: haiku setzt den Satz über das Modell aus deinem Auftrag um. Nur haiku, ohne Versionsnummer, wechselt mit der Zeit zu neueren Haiku-Modellen. Ein Modell mit Versionsnummer bleibt auf dieser Version, bis du es änderst.

Siehst du im Kopf auch eine Zeile, die mit tools: beginnt, bekommt der Subagent nur die Werkzeuge, die dort aufgeführt sind. Fehlt der Gmail-Konnektor auf dieser Liste, kann er das Postfach nicht öffnen. Bitte Claude Code dann, diese Zeile zu löschen.

Wähl das Modell von unten her: Fang mit haiku an. Gehen die Zusammenfassungen regelmässig am Inhalt der Mails vorbei, bitte Claude Code, auf sonnet zu wechseln.

Schau nach, was der Subagent tun und zurückgeben soll

Unter dem Kopf der Subagenten-Datei steht die Anweisung für den Subagenten. Lies sie und prüf, ob sie zwei Dinge sagt.

Erstens: wie die Liste aussehen soll, die der Subagent zurückgibt. Sie sollte für jede Mail eine Zeile haben – Absender, Betreff und kurz, worum es in der Mail geht. Das ist wichtig, weil nur diese Liste ins Hauptgespräch zurückkommt. Beschreibt die Anweisung diese Liste nicht, gibt der Subagent womöglich einen einzigen allgemeinen Satz zurück, etwa «im Postfach sind drei Anfragen und ein paar Rechnungen». Aus so einem Satz stellt die Haupt-KI keinen Plan zusammen.

Zweitens: dass der Subagent die wichtigen Mails nicht auswählt. Der Subagent listet alle Mails auf, die wichtigen wählt die Haupt-KI aus. Nur die Haupt-KI kennt dein Profil und sieht auch den Kalender. Der Subagent sieht nur das Postfach.

Fehlt in der Anweisung etwas, bitte Claude Code, es zu ergänzen.

Den Subagenten für den Kalender legst du mit einem ähnlichen Auftrag an:

Leg einen Subagenten kalender-durchsicht an, der in allen meinen Projekten verfügbar ist, auf Grundlage des Schritts zum Kalender aus dem Skill morgenplan. Der Subagent soll die heutigen Termine auflisten, eine Zeile pro Termin: Uhrzeit, Titel und kurz, worum es in der Beschreibung des Termins geht. Er soll nicht bewerten, welche Termine wichtig sind – diese Entscheidung trifft der Skill. Gib ihm das Modell haiku, ohne Versionsnummer. Schränk seine Werkzeuge nicht ein, denn er braucht Zugriff auf Google Kalender. Ändere den Skill morgenplan noch nicht.

Ersetze einen Teil des Skills durch einen Auftrag

Jetzt kommen die Schritte zu Post und Kalender aus dem Skill morgenplan heraus, und an ihre Stelle treten Aufträge an die Subagenten. Die Änderung übergibst du Claude Code:

Ersetze im Skill morgenplan den Schritt, der die Post durchsieht, durch die Anweisung, dass der Subagent postfach-durchsicht die Mails der letzten 24 Stunden auflistet. Ergänze, dass der Skill auf seine Liste wartet, bevor er mit dem Plan beginnt. Die Auswahl der Mails, die auf meine Antwort warten, bleibt im Skill. Ergänze ausserdem, dass der Skill die ganze Mail lesen soll, wenn die Zusammenfassung des Subagenten für eine Entscheidung nicht reicht.

Den Schritt zum Kalender ersetzt du durch einen ähnlichen Auftrag:

Ersetze im Skill morgenplan den Schritt zum Kalender durch die Anweisung, dass der Subagent kalender-durchsicht die heutigen Termine auflistet. Ergänze, dass der Skill auf seine Liste wartet, bevor er mit dem Plan beginnt. Ergänze ausserdem, dass der Skill die ganze Beschreibung des Termins in Google Kalender lesen soll, wenn die Zusammenfassung des Subagenten für eine Entscheidung nicht reicht.

Die ganze Mail oder die ganze Terminbeschreibung liest die Haupt-KI nur, wenn die kurze Zeile vom Subagenten nicht reicht. Der erste Schritt, in dem die Haupt-KI die Datei profil.md liest, bleibt unverändert im Skill.

Starte den Skill neu und prüf, ob die Subagenten gearbeitet haben

Ist der Skill geändert, öffne ein neues Gespräch, starte darin den Skill und tipp gleich, nachdem er fertig ist, /context ein. Vergleich dieses Raster mit dem Screenshot von vor der Änderung. Es sollte mehr freier Platz übrig sein.

Ein neues Gespräch ist hier zwingend. Im Gespräch, in dem die Subagenten entstanden sind, würde das Raster auch diese ganze Arbeit zeigen, und der Vergleich mit dem Screenshot würde nichts aussagen.

Sehen beide Raster gleich aus, prüf, ob der Skill die Arbeit wirklich an die Subagenten abgegeben hat. Frag Claude Code im selben Gespräch: «Haben Subagenten Post und Kalender durchgesehen, oder hast du das selbst gemacht?» Antwortet Claude Code, dass es das selbst gemacht hat, bitte es, die Aufträge im Skill morgenplan zu korrigieren.

Ist der Tagesplan schwächer ausgefallen als vor der Änderung, prüf, was der Subagent zurückgegeben hat. Nach dem Start des Skills siehst du den fertigen Plan, nicht die Liste vom Subagenten – frag also direkt danach:

Was genau ist vom Subagenten postfach-durchsicht zurückgekommen? Füg seinen Schlussbericht ohne eigene Zusammenfassung ein.

Ist der Bericht leer oder zu allgemein, bitte Claude Code, die Anweisung in der Datei des Subagenten zu korrigieren, nicht im Skill. Diese Anweisung sagt dem Subagenten, was er zurückgeben soll.

Warum der Skill auf das Ergebnis des Subagenten wartet

In einem gewöhnlichen Gespräch startet Claude Code Subagenten im Hintergrund: Sie arbeiten nebenher, und die Haupt-KI bekommt das Ergebnis, wenn sie fertig sind. Darum steht im Auftrag in morgenplan «warte auf die Listen, bevor du mit dem Plan beginnst». Ohne diesen Satz könnte die Haupt-KI mit dem Plan anfangen, bevor die Listen der Subagenten zurück sind.

Wird das Ergebnis eines Subagenten in den weiteren Schritten nicht gebraucht, zum Beispiel beim Speichern des fertigen Plans in eine Datei, kannst du den Satz übers Warten weglassen. Der Skill macht dann weiter, und der Subagent beendet seine Arbeit im Hintergrund.

Was du aus dieser Lektion mitnimmst

• Das kleinere Modell musst du dem Subagenten eintragen. Ohne diese Angabe arbeitet der Subagent meist mit demselben Modell wie das Hauptgespräch, und die Ersparnis ist weg.
• Der Subagent liest viel und gibt eine kurze Liste zurück, die Entscheidung trifft die Haupt-KI. Vierzig Mails durchsehen und jede in einer Zeile zusammenfassen ist Arbeit für einen Subagenten; auswählen, was wichtig ist, und den Plan zusammenstellen bleibt im Skill.
• Am einfachsten löst du Subagenten aus einem fertigen Skill heraus. Es ist nicht der einzige Weg: Du kannst auch gleich nur Subagenten anlegen oder den Skill von Anfang an zusammen mit ihnen entwerfen.
• Ins Hauptgespräch kommt nur der Schlussbericht zurück. Darum hängt es von der Beschreibung des Ergebnisses in der Subagenten-Datei ab, ob der Skill etwas hat, womit er arbeiten kann.
• /context zeigt, ob die Änderung etwas gebracht hat. Zwei Messungen, jede in einem eigenen, neuen Gespräch: vor der Änderung und danach.

Aufgaben

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

• Der Skill morgenplan ist bereit für die Übung
• Liste der Kandidaten zum Herauslösen, aufgeteilt in «für einen Subagenten» und «im Skill lassen»
• Subagenten für Post und Kalender angelegt, mit dem Modell haiku und mit Zugriff auf die Konnektoren
• In den Subagenten-Dateien die Beschreibung der zurückgegebenen Liste geprüft und den Satz, dass der Subagent nicht bewertet, was wichtig ist
• Die Schritte zu Post und Kalender aus dem Skill entfernt und durch Aufträge ersetzt
• Kontextverbrauch vor und nach der Änderung verglichen
• Ergebnis des Subagenten im Hauptgespräch geprüft
• Geprüft, dass der Skill auf die Listen der Subagenten wartet, bevor er den Plan zusammenstellt