handoff
von mattpocockhandoff verwandelt die aktuelle Konversation in ein kompaktes Übergabedokument für den nächsten Agenten. Nutze den handoff-Skill, um Status, Entscheidungen, Blocker und Links zu Quellartefakten festzuhalten, statt PRDs, Pläne, ADRs, Issues oder Diffs zu duplizieren.
Dieser Skill erreicht 68/100 und ist damit grundsätzlich listenfähig, sollte aber am besten mit Hinweisen auf seine Grenzen präsentiert werden. Für Directory-Nutzer ist er zuverlässig auslösbar, weil der Zweck klar ist: die aktuelle Konversation in ein Handoff-Dokument verdichten, in einer Temp-Datei speichern und auf einen optionalen Fokus für die nächste Sitzung zuschneiden. Allerdings liefert das Repository nur eine einzelne SKILL.md ohne unterstützende Referenzen oder Beispiele, sodass Nutzer über die Kernaufgabe hinaus mit etwas Workflow-Unschärfe rechnen sollten.
- Expliziter Auslöser und klares Ergebnisziel: ein Handoff-Dokument für den nächsten Agenten erstellen, inklusive eindeutiger Anweisung zum Schreiben in eine Datei.
- Gute operative Vorgaben: über mktemp in einen Temp-Pfad speichern und keine Inhalte duplizieren, die bereits an anderer Stelle festgehalten wurden.
- Enthält Hinweise, das Handoff an vom Nutzer vorgegebene Ziele für die nächste Sitzung anzupassen und nächste Skills vorzuschlagen, was den Nutzen für Agenten erhöht.
- Wenig unterstützender Kontext: keine Skripte, Referenzen, Ressourcen oder Beispiele, die Best Practices oder Sonderfälle erläutern.
- Kein Installationsbefehl und keine weiteren Docs, daher müssen Nutzer vermutlich selbst ableiten, wie sich dieser Skill in ihren Workflow integriert.
Überblick über das handoff-Skill
Was das handoff-Skill macht
handoff macht aus dem aktuellen Gespräch ein kompaktes Übergabedokument für den nächsten Agenten. Es ist für Momente gedacht, in denen Kontinuität schnell hergestellt werden muss: Es fasst zusammen, was wichtig ist, was entschieden wurde und was die nächste Sitzung als Nächstes tun sollte.
Wer es nutzen sollte
Nutze das handoff-Skill, wenn du Arbeit zwischen Sitzungen übergibst, eine Aufgabe an einen anderen Agenten weiterreichst oder ein AI-taugliches Briefing für die Fortsetzung vorbereitest. Besonders nützlich ist es für Repo-Arbeit, mehrstufige Produktaufgaben und alle Workflows, bei denen Kontextverlust Nacharbeit verursachen würde.
Warum es sich unterscheidet
Der eigentliche Wert von handoff liegt nicht in einer generischen Zusammenfassung. Das Skill verlangt ein handlungsorientiertes Dokument, das vorhandene Artefakte nicht dupliziert und den nächsten Agenten per Pfad oder URL direkt zur richtigen Quelle führt. Dadurch ist es deutlich nützlicher als ein schlichtes „fass diesen Chat zusammen“-Prompt.
Wie man das handoff-Skill verwendet
handoff installieren und mit der Skill-Datei starten
Für ein typisches handoff install fügst du das Skill aus dem Repo hinzu und öffnest zuerst SKILL.md:
npx skills add mattpocock/skills --skill handoff
Lies dann SKILL.md, um die genaue Ausgabeform und das Verhalten zu verstehen, bevor du es auf deinen eigenen Workflow anwendest.
Dem Skill ein echtes Ziel für die nächste Sitzung geben
Das Muster für handoff usage funktioniert am besten, wenn du klar benennst, wofür die nächste Sitzung gedacht ist. Der Argument-Hinweis im Repository erwartet eine Fokusformulierung wie:
- „Continue debugging the TypeScript build failure in the payments package.“
- „Pick up the landing page copy review and finalize the CTA variants.“
- „Resume implementation of the auth flow after the API schema changes.“
Eine vage Anfrage wie „mach ein handoff“ führt zu einem schwächeren Dokument. Ein klarer Zielpunkt für die nächste Sitzung hilft dem Skill zu entscheiden, was in das handoff gehört und was weggelassen werden kann.
Vor dem Schreiben die richtigen Dateien lesen
Das Skill ist bewusst leichtgewichtig, daher ist die Hauptquelle SKILL.md. Prüfe außerdem alle nahegelegenen Projektartefakte, auf die das Skill verweist, statt sie in das handoff zu kopieren:
README.mdAGENTS.mdmetadata.json- Ordner wie
rules/,resources/,references/oderscripts/, falls sie existieren
Wenn die Arbeit bereits in einem PRD, Plan, ADR, Issue, Diff oder Commit festgehalten ist, sollte das handoff stattdessen darauf verlinken, statt es zu wiederholen. So bleibt das Dokument kurz und der nächste Agent arbeitet schneller.
Für den nächsten Agenten schreiben, nicht für dich selbst
Ein starkes handoff-Dokument enthält typischerweise:
- das aktuelle Ziel und den Status
- bereits getroffene Entscheidungen
- offene Fragen oder Blocker
- exakte Dateipfade, URLs oder Artefakte, die als Nächstes geprüft werden sollen
- empfohlene Skills für die Folgesitzung
Das ist das wichtigste Nutzungsprinzip: Den nächsten Schritt eindeutig machen, ohne die komplette Projektgeschichte noch einmal zu erklären.
handoff-Skill-FAQ
Ist handoff nur für lange Gespräche gedacht?
Nein. handoff ist immer dann nützlich, wenn der nächste Agent mit weniger Vorlauf starten soll, auch nach einem kurzen, aber komplexen Austausch. Am wertvollsten ist es, wenn Entscheidungen, Abhängigkeiten oder Quellartefakte erhalten bleiben müssen.
Worin unterscheidet es sich von einem gewöhnlichen Prompt?
Ein gewöhnlicher Prompt fordert oft nur eine Zusammenfassung an und belässt es dabei. Das handoff-Skill ist stärker vorgegeben: Es soll ein Übergabedokument erzeugen, Duplikate vermeiden und auf die kanonischen Artefakte verweisen, die die nächste Sitzung nutzen soll.
Ist handoff für Einsteiger geeignet?
Ja, wenn du die nächste Aufgabe klar benennen kannst. Einsteiger erzielen die besten Ergebnisse, wenn sie eine einfache Fokusformulierung liefern und das Skill die Übergabe in ein nützliches Briefing strukturieren lassen.
Wann sollte ich handoff nicht verwenden?
Verwende handoff nicht, wenn die nächste Sitzung keine Kontinuität braucht oder wenn der notwendige Kontext bereits vollständig in einem vorhandenen Artefakt festgehalten ist, das der nächste Agent direkt liest.
So verbesserst du das handoff-Skill
Das Ziel der nächsten Sitzung präzise machen
Die Qualität der handoff-Ausgabe hängt davon ab, wie scharf du die nächste Sitzung definierst. Bessere Eingaben nennen die genaue Phase, das Subsystem oder den Entscheidungspunkt und nicht nur das allgemeine Projekt.
Auf Quellen der Wahrheit verweisen
Wenn die aktuelle Arbeit in einem Doc, Issue oder Diff lebt, füge diese Verweise ein, damit das handoff kompakt bleiben kann. Das ist wichtig, weil das Skill darauf ausgelegt ist, Material nicht zu duplizieren, das bereits anderswo gespeichert ist.
Einschränkungen und offene Fragen aufnehmen
Die nützlichsten handoff-Dokumente halten fest, was noch ungelöst ist: Implementierungsblocker, Trade-offs, Reviewer-Bedenken oder Annahmen, die noch bestätigt werden müssen. Solche Details helfen dem nächsten Agenten, frühere Sackgassen nicht noch einmal zu betreten.
Bei Bedarf Folge-Skills vorschlagen
Das Skill fragt ausdrücklich nach Skill-Empfehlungen für die nächste Sitzung. Nimm sie auf, wenn die nächste Aufgabe von einem anderen Workflow profitieren würde. Ein handoff kann den nächsten Agenten je nach Restarbeit zum Beispiel in Richtung Planung, Umsetzung oder Review-orientierter Skills lenken.