setup-pre-commit

Überblick über das setup-pre-commit-Skill

Das setup-pre-commit-Skill hilft dir dabei, einen praxisnahen Git-Hook-Workflow einzurichten: Husky-Pre-Commit-Prüfungen, lint-staged-Formatierung mit Prettier und optionale typecheck-/Test-Läufe, bevor Code in einen Commit gelangt. Es eignet sich besonders für Repos, die bereits eine Node-basierte Toolchain nutzen und eine schnelle, wiederholbare Einrichtung brauchen statt eines manuell zusammengeschraubten Hooks.

Wofür setup-pre-commit gedacht ist

Nutze das setup-pre-commit-Skill, wenn du ein Sicherheitsnetz beim Commit willst, das Formatierung vereinheitlicht und offensichtliche Fehler früh abfängt. Die eigentliche Aufgabe besteht nicht darin, „einfach Husky zu installieren“, sondern lokale Commits sicherer zu machen, ohne das Repo umbauen zu müssen.

Wann es besonders gut passt

Es passt gut, wenn dein Repo Prettier, typecheck und test bereits verwendet oder problemlos verwenden kann und du eine klare Konvention suchst, die mit npm, pnpm, Yarn oder Bun funktioniert. Ebenso praktisch ist es, wenn du in einem bestehenden Projekt schnell eine saubere Lösung einführen willst, ohne lange über Policies zu diskutieren.

Wo seine Grenzen liegen

Weniger hilfreich ist dieses Skill, wenn dein Projekt nicht auf Node basiert, wenn du statt Pre-Commit eher Commit-Msg- oder Pre-Push-Logik brauchst oder wenn deine Prüfungen eine komplexere Orchestrierung als einen einfachen Hook erfordern. Außerdem setzt es voraus, dass du vor dem Einhängen der Skripte prüfst, welche davon im Projekt بالفعل vorhanden sind.

Wie man das setup-pre-commit-Skill verwendet

Installieren und die richtigen Dateien öffnen

Installiere es mit npx skills add mattpocock/skills --skill setup-pre-commit. Lies dann zuerst SKILL.md, weil dort der eigentliche Ablauf und die relevanten Entscheidungen stehen. Wenn deine Verzeichnisansicht nur eine Datei zeigt, reicht das für die Einrichtung aus, aber du solltest trotzdem den Repository-Baum auf Hinweise zu Paketmanager und Skripten prüfen.

Dem Skill den passenden Repo-Kontext geben

Für gute Ergebnisse solltest du dem Skill sagen, welche Lockfile-Datei vorhanden ist, ob package.json bereits typecheck und test enthält und ob Prettier schon konfiguriert ist. Eine gute Anfrage wäre zum Beispiel: „Richte setup-pre-commit in diesem Repo mit pnpm ein; behalte die bestehende Prettier-Konfiguration bei; füge nur die Skripte hinzu, die bereits existieren.“ Das ist besser als „füge Pre-Commit-Hooks hinzu“, weil dadurch keine Unklarheit über Paketmanager und Hook-Inhalte bleibt.

Den Workflow in der richtigen Reihenfolge befolgen

Das Skill ist auf eine einfache Reihenfolge ausgelegt: Paketmanager erkennen, Dev-Dependencies installieren, Husky initialisieren, .husky/pre-commit schreiben, lint-staged hinzufügen und eine Prettier-Konfiguration erstellen oder wiederverwenden. In der Praxis ist die wichtigste Entscheidung, ob npm run typecheck und npm run test eingebunden werden oder wegfallen, wenn diese Skripte fehlen. Diese Entscheidung hält den Hook nützlich statt fragil.

Praktisches Prompt-Muster

Verwende ein Prompt, das den Zustand des Repos und die gewünschte Policy nennt. Zum Beispiel: „Nutze setup-pre-commit, um Husky, lint-staged und Prettier in diesem Monorepo einzurichten. Die Lockfile ist pnpm-lock.yaml, typecheck existiert, test nicht, und es gibt bereits eine .prettierrc.“ So hat das Skill genug Details, um eine korrekte Einrichtung zu erzeugen, ohne Skripte zu erfinden oder Konfiguration zu überschreiben.

Häufige Fragen zum setup-pre-commit-Skill

Ist setup-pre-commit nur für neue Repositories gedacht?

Nein. Das setup-pre-commit-Skill ist in bestehenden Repos oft sogar wertvoller, weil du damit eine einheitliche Hook-Policy hinzufügen kannst, ohne Dateien manuell neu aufzubauen. Am besten funktioniert es, wenn du bereits weißt, welche Skripte und welche Konfiguration vorhanden sind.

Brauche ich sowohl Husky als auch lint-staged?

Für diesen Workflow ja, genau darum geht es. Husky löst den Hook aus, und lint-staged beschränkt die Formatierung auf gestagte Dateien, damit Commits schnell bleiben. Wenn du nur einen dieser Bausteine willst, ist ein allgemeines Prompt oft einfacher als das setup-pre-commit-Skill.

Überschreibt es mein Prettier-Setup?

Bei sorgfältiger Nutzung sollte es das nicht tun. Das Skill legt .prettierrc nur an, wenn keine vorhanden ist, und die zentrale Entscheidung ist, ob dein Repo bereits eine Formatter-Konfiguration hat, die erhalten bleiben soll. Wenn es eine bestehende Style-Policy gibt, nenne sie ausdrücklich.

Ist es eher für CI oder für lokale Commits gedacht?

Der Hauptnutzen liegt in der lokalen Pre-Commit-Durchsetzung, aber dieselben Checks spiegeln oft auch CI-Erwartungen wider. Wenn dein CI andere Befehle nutzt, kopiere den Hook nicht blind; stimme ihn auf die Skripte ab, die deine Pipeline tatsächlich ausführt. Genau das ist der zentrale Punkt bei setup-pre-commit for CI Troubleshooting.

So verbesserst du das setup-pre-commit-Skill

Gib dem Skill die echten Bedingungen deines Repos

Der größte Qualitätssprung entsteht, wenn du setup-pre-commit mitteilst, welcher Paketmanager, welche Skripte und welche Konfigurationsdateien bereits existieren. Fehlt dieser Kontext, führt das schnell zu falschen Befehlsprefixen, unnötig neu angelegten Skripten oder Hook-Schritten, die schon beim ersten Commit scheitern.

Häufige Hook-Fehler vermeiden

Der häufigste Fehler ist, typecheck oder test in .husky/pre-commit einzutragen, obwohl diese Skripte gar nicht existieren. Ein weiteres typisches Problem ist, alle Dateien statt nur die gestagten zu formatieren, wodurch Commits unnötig langsam werden. Wenn der Hook zuverlässig sein soll, solltest du klar angeben, was passieren soll, wenn ein Skript fehlt.

Das erste Ergebnis mit klaren Zielvorgaben verbessern

Bitte um konkrete Ergebnisse, nicht nur um die Installation. Eine bessere Anweisung lautet etwa: „Füge Husky-Pre-Commit-Hooks hinzu, die lint-staged auf gestagte Dateien ausführen, die vorhandene Prettier-Konfiguration beibehalten und typecheck nur dann einschließen, wenn package.json es bereits definiert.“ Das liefert ein brauchbareres setup-pre-commit guide-Ergebnis als eine vage Anfrage.

Nach dem ersten Durchlauf nachjustieren

Prüfe nach der ersten Einrichtung, ob der Hook zu den Erwartungen des Teams an Geschwindigkeit und Strenge passt. Wenn er sich zu schwer anfühlt, nimm teure Prüfungen aus dem Pre-Commit heraus und verschiebe sie in CI; wenn er zu locker ist, ergänze das fehlende Skript oder grenze den lint-staged-Scope ein. Das beste setup-pre-commit install-Ergebnis ist das, das dein Team auch wirklich dauerhaft verwendet.