Install
npx skills add ast-grep/agent-skillFür wen
Nutzen Sie diesen Skill, wenn ein Programmierassistent nach Codestruktur (abstrakter Syntaxbaum) suchen soll, nicht nur nach Texttreffern. Offiziell liegt er im Plugin-Marktplatz von Claude Code und liefert die Struktursuche von ast-grep.
Voraussetzungen: ast-grep ist auf diesem Rechner bereits installiert, und der Assistent kann Skills installieren. Die Anleitung sagt nicht, wie man ast-grep selbst installiert; erfinden Sie keinen Installer. Die Anleitung nennt Claude Code; behandeln Sie andere Clients nicht als offiziell exklusiv. Ob etwas außerhalb dieser genannten Menge nutzbar ist, steht nicht da.
Es gibt nur einen Installationsweg: ein einziges npx-Kommando. Nach der Installation müssen Sie in der Frage ausdrücklich verlangen, diesen Skill zu nutzen, zum Beispiel "Use ast-grep to find...". Die Anleitung sagt, dass Claude Code im November 2025 in allen passenden Situationen ast-grep noch nicht automatisch auswählt. Ein Zielverzeichnis steht nicht in der Anleitung; nach der Installation prüfen Sie nur im aktuellen Assistenten, dass der Skill namentlich aufrufbar ist.
Erster Versuch in 3 Minuten
Offizielle Seite:
https://github.com/ast-grep/agent-skill
Bestätigen Sie zuerst, dass lokales ast-grep funktioniert, und führen Sie dann die empfohlene Installation aus (sie schreibt Skill-Dateien auf diesen Rechner; prüfen Sie zuerst den Repository-Namen):
npx skills add ast-grep/agent-skill
Schlägt der Befehl fehl, halten Sie an. Nach Erfolg ändern Sie zuerst keinen Anwendungscode. Öffnen Sie ein vorhandenes Repository und sagen Sie klar in natürlicher Sprache: Use ast-grep to find..., plus ein risikoarmes Strukturziel, zum Beispiel eine bestimmte Funktionsaufrufform. Bitten Sie den Assistenten, zuerst zu prüfen, ob ast-grep passt, Beispiele und Regeln für den Abgleich zu schreiben und zuerst an den Beispielen zu testen.
Erfolgssignal: Der Assistent hat ast-grep ausdrücklich verwendet, die Regel wurde an den Beispielen geprüft, und die Ergebnisse für das ganze Repository enthalten Dateipfade und Zeilennummern. Will es eine Regeldatei schreiben oder Anwendungscode ändern, stoppen Sie es zuerst und klären Sie Nebenwirkungen, bevor Sie weitermachen.
Anwendungsbeispiele
Beispiel 1: schreibgeschützte Struktursuche. Die Frage muss ast-grep ausdrücklich nennen. Lassen Sie den Assistenten Treffer nach Struktur finden und Dateipfade sowie Zeilennummern zurückgeben. Beim ersten Durchgang nur die Ergebnisse ansehen; lassen Sie es nicht nebenbei refaktorieren. Die Anleitung nennt keinen Sprachumfang und kein Beispiel-Repository; schließen Sie nicht aus einer erfundenen Sprachenliste.
Beispiel 2: zuerst die Regel schreiben, dann prüfen, zuletzt das ganze Repository durchsuchen. Die Schritte in der Anleitung sind: prüfen, ob die Anfrage zu ast-grep passt, Beispielcode für den Abgleich anlegen, die Regel schreiben, am Beispiel testen, erst danach die ganze Codebasis durchsuchen, zuletzt Pfade und Zeilennummern liefern. Die Suche im ganzen Repository ist nur erlaubt, wenn der Beispieltest besteht. Die Anleitung nennt keinen Regeldateipfad und keine CLI-Flags; ergänzen Sie Fehlendes nicht.
Grenzen
Der Hauptweg dokumentiert nur:
npx skills add ast-grep/agent-skill
Auf diesem Rechner muss ast-grep bereits installiert sein. Der Auslöser muss es ausdrücklich nennen, zum Beispiel "Use ast-grep to find..."; erwarten Sie keine automatische Wahl in jeder Situation.
Belegt ist die Fähigkeit nur für Struktursuche und die Kette "Beispiel → Regel → Test → ganzes Repository → Pfad und Zeilennummer". Es ist als Skill im Plugin-Marktplatz von Claude Code beschrieben, aber beim ersten Versuch wechseln Sie nicht zu Klickschritten im Marktplatz, die nirgends vorkommen.
Die Anleitung dokumentiert keine Installationsbefehle für ast-grep, keine Abrechnung, keinen Sprachumfang und kein Zielverzeichnis. Der erste Durchgang ist nur schreibgeschützte Suche; behandeln Sie ihn nicht als Einstieg ins Refactoring. Undokumentiertes bleibt unbekannt; erfinden Sie keine Operationen.