grill-with-docs
von mattpocockgrill-with-docs ist eine Skill für Planung und Dokumentation, die deinen Plan gegen das bestehende Domänenmodell des Repos auf Belastbarkeit prüft, die Terminologie schärft und CONTEXT.md sowie ADRs aktualisiert, sobald sich Entscheidungen verdichten. Verwende sie für Technical Writing, produktorientiertes Engineering und jeden Workflow, in dem repo-gestützte Sprache wichtiger ist als ein reines Prompt-Brainstorming.
Diese Skill erreicht 67/100 und ist damit für das Verzeichnis noch auflistbar, aber eher eine eingeschränkt empfehlenswerte, vorsichtig zu bewertende Installation als eine ausgefeilte Vorzeige-Skill. Das Repository liefert genug Hinweise auf einen echten Workflow zum Belastungstest von Plänen gegen vorhandene Dokumentation und zum direkten Aktualisieren von CONTEXT/ADR-Artefakten, aber es fehlen begleitende Dateien und Installationshinweise, die den Einführungsaufwand weiter senken würden.
- Klarer Auslöser: Die Beschreibung sagt, dass sie eingesetzt werden soll, wenn ein Plan gegen die Sprache des Projekts und dokumentierte Entscheidungen geprüft werden soll.
- Der operative Ablauf ist eindeutig: Es wird eine Frage nach der anderen gestellt, Antworten werden empfohlen, und bei Fragen, die sich im Codebase klären lassen, wird zur Exploration des Codebases gewechselt.
- Das Repo enthält konkrete Dokumentationsformate für CONTEXT.md und ADRs, was die Wirkung für Terminologie und Entscheidungsdokumentation erhöht.
- Kein Installationsbefehl und keine unterstützenden Skripte/Referenzen/Ressourcen, daher müssen Nutzer Einrichtung und Nutzung allein aus SKILL.md ableiten.
- Die Skill ist mit einem experimentellen/Test-Signal gekennzeichnet, daher ist eher ein meinungsstarker oder sich noch entwickelnder Workflow als ein vollständig gehärtetes Paket zu erwarten.
Überblick über das grill-with-docs-Skill
grill-with-docs ist ein Planungs- und Dokumentations-Skill für Teams, die ein Design gegen die Sprache und die Entscheidungen in ihrem Repo auf Belastbarkeit prüfen wollen. Er eignet sich besonders für Technical Writing, produktorientierte Engineering-Arbeit und KI-gestützte Architekturarbeit, bei der Begriffe mit CONTEXT.md und ADRs konsistent bleiben müssen, statt in ein vages „nur Prompt“-Vokabular abzudriften.
Die Hauptaufgabe ist klar: den Nutzer eine Frage nach der anderen interviewen, Antworten empfehlen und das Codebase oder die Doku heranziehen, wenn sich eine Frage aus der Quelle klären lässt. Dadurch ist das grill-with-docs-Skill deutlich nützlicher als ein generischer Brainstorming-Prompt, wenn das eigentliche Risiko in Begriffsinkonsistenzen, nicht dokumentierten Annahmen oder veralteten Entscheidungsständen liegt.
Was grill-with-docs unterscheidet
Es ist auf Domänenverständnis ausgelegt, nicht nur auf Gesprächsführung. Der Skill stößt dazu an, vorhandene Kontextdateien zu prüfen, ADRs zu durchsuchen und die Doku zu aktualisieren, sobald Entscheidungen klarer werden. Genau deshalb funktioniert er gut für grill-with-docs for Technical Writing und andere dokumentationsintensive Workflows.
Typische Einsatzfälle
Nutze grill-with-docs, wenn du:
- einen Plan gegen ein bestehendes Domänenmodell validieren willst,
- präzise Projektbegriffe festlegen musst,
- Entscheidungen direkt beim Treffen dokumentieren willst,
- oder einen Entwurf vor dem Start der Implementierung an die bestehende Doku angleichen musst.
Wann es nicht passt
Wenn du nur eine schnelle Zusammenfassung, ein poliertes Spec oder freies Ideensammeln ohne Repo-Bezug willst, fühlt sich der Skill langsamer an als ein einfacher Prompt. Sein Mehrwert entsteht aus disziplinierter Befragung und dokumentenbewusster Prüfung.
So verwendest du das grill-with-docs-Skill
grill-with-docs installieren
Installiere das grill-with-docs-Skill mit dem Standard-Skill-Manager des Repos in deinem Skills-Verzeichnis und öffne dann die Skill-Dateien im Kontext des Zielprojekts. Das grundlegende Installationsmuster ist:
npx skills add mattpocock/skills --skill grill-with-docs
Betrachte das als Startpunkt für grill-with-docs install und prüfe anschließend, ob der Skill in der Agent-Umgebung, die du tatsächlich nutzt, verfügbar ist.
Mit dem richtigen Input starten
Der Skill funktioniert am besten, wenn deine erste Nachricht enthält:
- das Ziel, das du planst,
- den Namen des Systems oder Features,
- alle bekannten Begriffe, die wichtig sind,
- und die Entscheidungsgrenze, die du klären willst.
Ein schwacher Prompt lautet: „Hilf mir, dieses Feature zu entwerfen.“
Ein stärkerer Prompt lautet: „Nutze grill-with-docs, um diesen Feature-Plan gegen die aktuelle Billing-Domäne zu prüfen. Ich brauche den richtigen Begriff für subscription period, die Datenstruktur und alle ADR-würdigen Entscheidungen, bevor ich die Doku schreibe.“
Diese Dateien zuerst lesen
Für grill-with-docs usage beginne mit:
SKILL.mdfür das Interviewverhalten und den Workflow,CONTEXT.mdoderCONTEXT-MAP.mdfür das aktive Domänenmodell,docs/adr/für frühere Entscheidungen,ADR-FORMAT.mdundCONTEXT-FORMAT.md, wenn du Dateien anlegen oder aktualisieren musst.
Diese Dateien zeigen dir, was sich aus dem Repository ableiten lässt und was ausdrücklich festgehalten werden sollte.
Workflow, der die Ergebnisse verbessert
Nutze das Skill in einer Schleife:
- gib einen konkreten Plan oder einen groben Entwurf vor,
- lass den Skill jeweils nur eine Frage nach der anderen stellen,
- antworte mit so spezifischen, repo-gestützten Details wie möglich,
- erlaube die Exploration des Codebases, wenn sich eine Frage aus Dateien beantworten lässt,
- halte Terminologie und harte Entscheidungen in Kontext- oder ADR-Notizen fest.
Der wichtigste praktische Tipp: Trenne „wir brauchen einen Namen“ von „wir brauchen eine Entscheidung“. So bleibt das Grilling fokussiert und verhindert unnötige ADRs.
FAQ zum grill-with-docs-Skill
Ist grill-with-docs nur für Dokumentationsteams?
Nein. Es ist immer dann nützlich, wenn ein Plan zu einem bestehenden Domänenvokabular passen muss, besonders in Product Engineering, Plattformarbeit oder grill-with-docs for Technical Writing-Workflows, in denen Wortwahl und Struktur die spätere Verständlichkeit beeinflussen.
Worin unterscheidet es sich von einem normalen Prompt?
Ein normaler Prompt kann Ideen erzeugen, aber grill-with-docs ist dafür gebaut, Annahmen zu hinterfragen, das Repository zu prüfen und Begriffe an bestehendem Kontext auszurichten. Dadurch sinkt das Risiko von Namenskollisionen und von Doku, die gegen das Codebase arbeitet.
Brauche ich ein ausgereiftes Doku-Setup, um es zu nutzen?
Nein, aber es funktioniert am besten, wenn CONTEXT.md und ADRs bereits existieren. Wenn nicht, kann der Skill trotzdem helfen, sie Schritt für Schritt mit den entstehenden Entscheidungen aufzubauen.
Wann sollte ich es nicht verwenden?
Vermeide es, wenn die Aufgabe rein explorativ ist, das Repository keinen sinnvollen Domänenkontext hat oder du eine schnelle Einmalantwort statt eines strukturierten Interviews brauchst.
So verbesserst du das grill-with-docs-Skill
Bessere Entscheidungsgrundlagen liefern
Der größte Qualitätssprung entsteht, wenn du dem Skill einen engen, entscheidungsorientierten Prompt gibst. Nenne den Feature-Namen, den Teil des Systems, den er berührt, und die konkrete Unklarheit, die du gelöst haben willst. Beispiel: „Sollen wir das im Accounting-Kontext invoice, billing record oder charge nennen, und wo sollte diese Entscheidung festgehalten werden?“
Frühzeitig Repo-Belege mitgeben
Wenn du bereits relevante Dateien kennst, nenne sie gleich am Anfang. Wenn du das Skill auf CONTEXT.md, eine bestimmte ADR oder einen Ordner wie src/billing/ verweist, stellt es weniger generische und dafür deutlich nützlichere Fragen. Das ist besonders wichtig für grill-with-docs usage, weil der Skill am stärksten ist, wenn er deinen Plan mit bestehenden Begriffen und Strukturen abgleichen kann.
Häufige Fehlerbilder im Blick behalten
Das häufigste Fehlerbild ist eine zu grobe Domänenbeschreibung, sodass das Interview abstrakt bleibt. Ein anderes ist, nach der Implementierung zu fragen, bevor das Sprachmodell die richtigen Begriffe hat. Wenn die erste Ausgabe zu breit wirkt, formuliere die Entscheidung enger neu und bitte den Skill, vom zuletzt geklärten Zweig aus weiterzumachen.
Vom ersten Durchlauf aus iterieren
Forme die Antworten nach der ersten Runde in eines von drei Ergebnissen um: einen bereinigten Glossareintrag, ein kurzes ADR oder ein überarbeitetes Implementierungsbriefing. Starte grill-with-docs dann erneut für die noch offenen Fragen. Genau dieser zweite Durchlauf bringt oft den größten Nutzen, weil Terminologie und Grenzen dann bereits klarer sind.