Ein Schach-Skill für Claude Code verbindet Stockfish-Analysen mit den Notizen eines Spielers

Ein öffentliches Set von Claude-Code-Skills verwandelt eine Schachpartie in eine kommentierte PGN-Datei und ein HTML-Analysebrett. Der Autor bietet außerdem einen Weg zu einem kommentierten Video. Stockfish bewertet Stellungen; Claude Code stellt Rückfragen und verfasst Erklärungen für den Spieler. Das Repository enthält eine durchgespielte Partie und die Skripte hinter diesem Ablauf. BIG CHANGE hat die Dokumentation und den Code in Commit 46919038, vom 26. September 2026, geprüft; wir haben den Ablauf nicht ausgeführt und die Schachberatung nicht selbst bewertet.

Die große Veränderung

• Was sich geändert hat: Dieses kleine öffentliche Projekt dokumentiert einen Ablauf, der Engine-Prüfungen von Stellungen mit Erklärungen zur eigenen Partie eines Schachspielers und, sofern bereitgestellt, dessen aufgezeichneten Überlegungen verbindet.
• Warum das wichtig ist: Ein Spieler kann die PGN-Datei, den Engine-Durchlauf, gespeicherte Abfragen und Kommentare getrennt prüfen. So lässt sich eine generierte Erklärung leichter anhand der Stellung hinterfragen, auf die sie sich bezieht. Ob der Ablauf Spielern beim Verbessern hilft, wurde hier nicht gemessen.
• Worauf es ankommt: Das Modell wählt weiterhin die Fragen aus, deutet Engine-Varianten und verfasst die Lektion. Der promptgesteuerte Prüfer kontrolliert diese Arbeit, doch allein seine Existenz belegt keine Richtigkeit. Wer die Ausgabe zum Lernen verwenden möchte, sollte die angeführten Stellungen und Varianten selbst prüfen.

Vom Partieprotokoll zu möglichen Fehlern

Eingabe ist eine PGN-Partie, die direkt bereitgestellt oder über einen Link zu einem Spiel abgerufen wird. Der chess-analysis Skill ermittelt zunächst das Spielniveau, damit die Kommentare zum Spieler passen. Zusätzlich lassen sich schriftliche Notizen einfügen. Bei einer aufgezeichneten Denksequenz nutzt der dokumentierte Ablauf whisper.cpp zur lokalen Transkription und gleicht die Äußerungen anhand von Zeitangaben in den PGN-Kommentaren den Zügen zu. Dafür braucht es brauchbare Zeitangaben und eine Zuordnung gesprochener Bezüge zu Zügen; aus einer PGN-Datei allein lassen sich die Gedanken eines Spielers damit nicht rekonstruieren.

Der erste mechanische Durchlauf ist in sweep.py – das Skript lässt Stockfish die Stellung vor und nach jedem gespielten Zug bewerten, zeichnet Kandidatenzüge und Bewertungen auf und markiert einen Zug, wenn der gemessene Verlust den Standardwert von 30 Centipawns erreicht. Die dokumentierte Standardsuchtiefe beträgt 22. Diese Bewertungen zeigen Stellungen an, die näher untersucht werden sollten; für sich genommen erklären die Zahlen keinen Fehler.

Anschließend weist der Skill einen Claude-Code-Analysten an, jede markierte Stellung zu untersuchen. Seine query.py kann Stockfish nach alternativen Zügen fragen, auch mit einer auf einen vorgeschlagenen Zug beschränkten Suche, und die Varianten als JSON speichern. Separate Anweisungen fordern den Analysten auf, Brettbilder zu prüfen und zu erklären, warum ein Zug oder eine Alternative funktioniert. Notizen des Spielers dürfen nur dann in eine Erklärung einfließen, wenn sie zum betreffenden Zug gehören. Hier wird aus der Engine-Ausgabe vom Modell verfasster Schachtext – mit zusätzlichem Urteilsvermögen, aber auch möglicher Fehleranfälligkeit.

Was die Prüfungen und Ausgaben belegen

Der chess-analysis Skill des Repositorys verlangt einen separaten Prüfer-Agenten, der die fertigen Kommentare anhand des Engine-Durchlaufs und der Notizen des Spielers kontrolliert. Seine Checkliste umfasst markierte Fehler, legale Varianten, Bewertungsbehauptungen und Aussagen über die Gedanken des Spielers; Bewertungen sollen mit dem Durchlauf oder gespeicherten Engine-Abfragen übereinstimmen. Auch das build_annotated.py Skript liest die PGN-Datei erneut ein und meldet Parserfehler. Das sind unterschiedliche Prüfungen: Das Einlesen bestätigt, dass die Züge verarbeitet werden können; der Prüfer ist eine weitere modellgesteuerte Kontrolle der Erklärungen. Keine der beiden Prüfungen belegt, dass jede Deutung stimmt. Der Autor berichtet, dass Fehler bei der eigenen Nutzung selten gewesen seien, legt aber keine unabhängige Fehlerstudie vor.

Aus der kommentierten PGN-Datei erzeugen build_viewer.py ein eigenständiges HTML-Brett mit Kommentaren, Bewertungsdiagramm und zwischengespeicherten Engine-Varianten. Ein späterer, optionaler chess-video Skill beginnt mit der kommentierten PGN-Datei und dem Engine-Durchlauf. Claude Code soll ein Storyboard schreiben; anschließend rendern Skripte das Brett, erzeugen eine Sprachspur und erstellen eine MP4-Datei mit Untertiteln. Das Repository enthält ein Beispiel aus einer eigenen Schnellpartie des Autors – mit Transkript, Engine-Durchlauf, Kommentaren und einem 6 Minuten und 49 Sekunden langen Video. Dieses Beispiel zeigt die vorgesehenen Dateien, aber kein gemessenes Ergebnis über mehrere Spieler oder Partien hinweg.

Voraussetzungen, Zeitaufwand und Grenzen

Laut README sollen die Skill-Ordner in das persönliche Skills-Verzeichnis oder das Projektverzeichnis von Claude Code kopiert werden; anschließend wird ein Spiellink oder eine PGN-Datei bereitgestellt. Die Dokumentation von Claude Code bestätigt diese Verzeichnisse. Für die Analyse braucht es Python mit python-chess und cairosvg; außerdem eine ausführbare Stockfish-Datei. Das Abrufskript verwendet eine vorhandene ausführbare Datei oder lädt eine Linux-x86-64-Version von Stockfish 17.1 herunter. Die aktuelle Downloadseite von Stockfish führt Version 19 auf; der Rückgriff des Repositorys ist somit auf eine ältere Version festgelegt. Für die optionale Tonspur braucht es whisper.cpp und ein Modell; die Dokumentation beschreibt die Umwandlung von Audio in 16-Bit-WAV für whisper-cli. Für den Videoschritt werden außerdem Pillow, Piper Text-to-Speech oder espeak sowie FFmpeg benötigt. Diese Abläufe und Abhängigkeiten sind dokumentiert; dieser Artikel ist weder ein Installationstest noch eine Kompatibilitätsgarantie für bestimmte Geräte.

Der Autor schätzt, dass die vollständige Analyse samt Video etwa eine Stunde Rechenzeit beansprucht. Das Repository nennt keine Kosten für diesen Durchlauf. Anthropics aktuelle Tarifübersicht führt Claude Code unter Pro statt unter Free auf; Pro kostet bei monatlicher Abrechnung 20 US-Dollar und hat Nutzungslimits. Lokale Rechenzeit, ein Abonnement oder API-Nutzung sowie die optionale Transkriptions- und Videokonfiguration beeinflussen die Kosten je nach Umgebung. Zeitangabe und Einschätzung der Genauigkeit beruhen auf dem Bericht eines einzelnen Nutzers.