CommunityCodierung & Entwicklunggithub.com

mattpocock/ask-matt

Fragt, welcher Skill oder Ablauf zu Ihrer Situation passt. Ein Router für die Skills in diesem Repository.

Was ist ask-matt?

Dieser Skill fungiert als zentraler Navigator für das Skillset von Matt Pocock. Anstatt sich alle einzelnen Skill-Namen merken zu müssen, beschreiben Sie einfach Ihre aktuelle Situation (z.B. „Ich habe eine Idee, weiß aber nicht, wo ich anfangen soll“ oder „Ein Bug ist aufgetaucht“), und „Ask Matt“ leitet Sie zum passenden Skill weiter. Die Dokumentation definiert einen klaren Hauptablauf („Idee → Auslieferung“), der vom Schärfen der Anforderungen („/grill-with-docs“) über die Erstellung von PRDs und Issues bis zur Implementierung („/implement“) reicht. Daneben gibt es Auffahrrampen für Bugs und Anfragen, eigenständige Skills für Recherche, Prototyping und Lernen sowie ein Vokabular-Unterbau für Domain-Modellierung und Codebase-Design. Der Router ist für jede Situation gedacht, in der Sie in diesem Repository arbeiten, und läuft als Skill für Claude Code, Cursor, Codex und ähnliche KI-Agenten-Plattformen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mattpocock/skills/tree/main/skills/engineering/ask-matt

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ask Matt

Sie erinnern sich nicht an jeden Skill – also fragen Sie.

Ein Ablauf ist ein Pfad durch die Skills. Die meisten Pfade verlaufen entlang eines Hauptablaufs, und zwei Auffahrrampen münden in ihn ein. Alles andere ist eigenständig oder eine Vokabularschicht, die darunter liegt.

Der Hauptablauf: Idee → Auslieferung

Die Route, die die meiste Arbeit nimmt. Sie haben eine Idee und möchten sie umgesetzt haben.

  1. /grill-with-docs – die Idee durch ein Interview schärfen. Starten Sie hier, wenn Sie eine Codebasis haben: es ist zustandsbehaftet und behält das Gelernte in CONTEXT.md und ADRs. (Keine Codebasis? Verwenden Sie /grill-me – siehe Eigenständig. Beide nutzen dasselbe /grilling-Primitiv; grill-with-docs ist dasjenige, das eine Papierspur hinterlässt.)

  2. Verzweigung – können Sie jede Frage im Gespräch klären? Wenn eine Frage eine ausführbare Antwort erfordert (Zustand, Geschäftslogik, eine UI, die Sie sehen müssen), machen Sie einen Umweg über einen Prototyp, überbrückt durch /handoff in beide Richtungen (siehe Sitzungswechsel):

    • /handoff raus, dann eine neue Sitzung für diese Datei öffnen,
    • /prototype um die Frage mit Wegwerfcode zu beantworten,
    • /handoff zurück, was Sie gelernt haben, und darauf im ursprünglichen Ideen-Thread verweisen.
  3. Verzweigung – Ist das ein Multi-Sitzungs-Build?

    • Ja → /to-prd** (den Thread in ein PRD verwandeln) → **/to-issues** (das PRD in unabhängig greifbare Issues aufteilen). Da die Issues unabhängig sind, **Kontext zwischen jedem klar trennen**: eine neue Sitzung pro Issue starten und **/implement` starten, indem Sie ihm das PRD und das einzelne Issue zum Bearbeiten übergeben.
    • Nein → /implement direkt hier, im selben Kontextfenster.

    In beiden Fällen baut /implement jedes Issue, indem es intern /tdd antreibt – jeweils einen Rot-Grün-Slice nach dem anderen – und schließt ab, indem es /code-review ausführt, eine zweiachsige Überprüfung (Standards + Spezifikation) des Diffs, bevor es committet. Greifen Sie zu /tdd allein, wenn Sie einfach ein konkretes Verhalten test-first ohne vollständige Spezifikation bauen möchten, und /code-review allein, wenn Sie einen Branch oder PR gegen einen fixen Punkt überprüfen möchten.

Kontexthygiene

Halten Sie Schritte 1–3 in einem ununterbrochenen Kontextfenster – komprimieren oder löschen Sie erst nach /to-issues – damit das Grilling, PRD und Issues alle auf demselben Denken aufbauen. Jedes /implement startet dann frisch und arbeitet vom Issue aus.

Die Grenze dafür ist die smart zone: das Fenster (~120k Tokens bei modernen Modellen), in dem das Modell noch klar denkt. Wenn eine Sitzung sich dieser Grenze vor /to-issues nähert, machen Sie nicht mit verschlechterter Qualität weiter – /handoff und in einem neuen Thread fortsetzen.

Auffahrrampen

Eine Startsituation, die Arbeit generiert und dann in den Hauptablauf mündet.

  • Bugs und Anfragen häufen sich → /triage. Es bewegt Issues durch Triage-Rollen und erzeugt agentenfertige Issues, die /implement später aufnimmt.

    Triage ist nur für Issues, die Sie nicht erstellt haben – Fehlermeldungen, eingehende Feature-Anfragen, alles, was roh ankommt. Issues, die /to-issues erzeugt hat, sind bereits agentenfertig, also triage Sie sie nicht.

  • Etwas ist kaputt → /diagnosing-bugs. Für die harten Fälle: der Bug, der einem ersten Blick widersteht, der intermittierende Flake, die Regression, die zwischen zwei bekannten guten Zuständen eingeschlichen ist. Es weigert sich zu theoretisieren, bis es eine enge Rückkopplungsschleife hat – ein Befehl, der bereits auf diesen Bug rot geht – und behebt ihn dann mit einem Regressionstest. Seine Nachbesprechung reicht an /improve-codebase-architecture weiter, wenn die eigentliche Erkenntnis ist, dass es keine gute Nahtstelle gibt, um den Bug festzunageln.

Codebase-Gesundheit

Keine Feature-Arbeit – Instandhaltung.

  • /improve-codebase-architecture – führen Sie es aus, wann immer Sie einen freien Moment haben, um die Codebasis für Agenten nutzbar zu halten. Es zeigt Vertiefungsmöglichkeiten auf; wenn Sie eine auswählen, wird eine Idee generiert, die Sie in den Hauptablauf bei /grill-with-docs mitnehmen können. Es ist die Übersicht, die die Kandidaten findet; /codebase-design (unten) ist die Werkbank, auf der Sie den Ausgewählten entwerfen.

Vokabular darunter

Zwei modellaufgerufene Referenzen, die unterhalb der anderen Skills laufen – jede die einzige Quelle der Wahrheit für ihr Vokabular. Greifen Sie direkt darauf zu, wenn die Wörter, nicht der Prozess, das Problem sind; oder lassen Sie die obigen Skills sie einziehen.

  • /domain-modeling – schärft die Domänensprache des Projekts: einen unscharfen Begriff hinterfragen, ein überladenes Wort auflösen („Konto“ mit drei Aufgaben), eine schwer umkehrbare Entscheidung als ADR festhalten. Es ist die aktive Disziplin, die /grill-with-docs antreibt, um CONTEXT.md als sauberes Glossar zu erhalten.
  • /codebase-design – das Tiefenmodul-Vokabular (Modul, Schnittstelle, Tiefe, Nahtstelle, Adapter, Hebelwirkung, Lokalität) zum Entwerfen der Form eines Moduls: viel Verhalten hinter einer kleinen Schnittstelle an einer sauberen Nahtstelle. /tdd und /improve-codebase-architecture sprechen beide dieses Vokabular.

Sitzungswechsel

  • /handoff – wenn ein Thread voll ist oder Sie abzweigen müssen (z.B. in eine /prototype-Sitzung), komprimiert dies die Konversation in eine Markdown-Datei. Sie machen nicht an Ort und Stelle weiter – Sie öffnen eine neue Sitzung und referenzieren diese Datei, um den Kontext zu übertragen. Es ist die Brücke zwischen Kontextfenstern in beide Richtungen. Verwenden Sie es, wenn Sie eine frische Sitzung wünschen, aber die aktuelle Konversation erhalten müssen.
  • /compact (eingebaut) – bleiben Sie in der gleichen Konversation und lassen Sie die früheren Wendungen zusammenfassen. Verwenden Sie es an bewussten Pausen zwischen Phasen, wenn es Ihnen nichts ausmacht, die wörtliche Historie zu verlieren. Komprimieren Sie nicht mitten in einer Phase – der Agent kann die Orientierung verlieren. /handoff verzweigt; /compact setzt fort.

Eigenständig

Vollständig außerhalb des Hauptablaufs.

  • /grill-me – das gleiche unerbittliche Interview wie /grill-with-docs, aber für den Fall, dass Sie keine Codebasis haben. Zustandslos: es speichert nichts lokal, erstellt keine CONTEXT.md. Greifen Sie darauf zu, um jeden Plan oder Entwurf zu schärfen, der nicht in einem Repository lebt.
  • /prototype – ein kleines Wegwerfprogramm, das eine Entwurfsfrage beantwortet: fühlt sich dieses Zustandsmodell richtig an oder wie sollte diese UI aussehen. Von Anfang an Wegwerf – behalten Sie die Antwort, löschen Sie den Code. Es ist der Umweg in Schritt 2 des Hauptablaufs, aber greifen Sie jederzeit darauf zu, wenn eine Entwurfsfrage auf dem Papier schwer zu klären ist.
  • /research – delegieren Sie Lesearbeit an einen Hintergrundagenten: er untersucht eine Frage anhand von Primärquellen und hinterlässt dann eine zitierte Markdown-Datei im Repository. Arbeiten Sie weiter, während er liest. Die Datei, die er erzeugt, wird in den Hauptablauf bei /grill-with-docs eingebracht – Recherche befruchtet das Denken, ersetzt es nicht.
  • /teach – lernen Sie ein Konzept über mehrere Sitzungen hinweg, wobei das aktuelle Verzeichnis als zustandsbehafteter Arbeitsbereich dient.
  • /writing-great-skills – Referenz zum guten Schreiben und Bearbeiten von Skills.

Vorbedingung

/setup-matt-pocock-skills – führen Sie es vor Ihrem ersten Engineering-Ablauf aus, um den Issue-Tracker, Triage-Labels und das Dokumentenlayout zu konfigurieren, das die anderen Skills erwarten. Benutzerdefinierte Issue-Tracker funktionieren ebenfalls.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

mattpocock/caveman

Ultra-compressed communication mode. Cuts token usage ~75% by dropping filler, articles, and pleasantries while keeping full technical accuracy. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman.

mattpocock/claude-handoff

Hand the current conversation off to a fresh background agent that picks up the work immediately.

mattpocock/codebase-design

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

mattpocock/diagnose

Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument → fix → regression-test. Use when user says "diagnose this" / "debug this", reports a bug, says something is broken/throwing/failing, or describes a performance regression.

mattpocock/diagnosing-bugs

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

mattpocock/domain-modeling

Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural decision, or when another skill needs to maintain the domain model.

mattpocock/edit-article

Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.

mattpocock/git-guardrails-claude-code

Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.

mattpocock/grilling

Grill the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

mattpocock/grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

mattpocock/handoff

Compact the current conversation into a handoff document for another agent to pick up.

mattpocock/implement

Implement a piece of work based on a PRD or set of issues.

mattpocock/implement-spec

Implement a specification in code.

mattpocock/improve-codebase-architecture

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

mattpocock/loop-me

Grill me about specs for the workflows I want to build, within this workspace.

mattpocock/migrate-to-shoehorn

Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

mattpocock/obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

Verwandte Skills