Markdown-Ausgabe

AI-translated from English; not yet reviewed by a fluent editor.

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

> Ein öffentlich verfügbarer Claude-Code-Skill kombiniert Stockfish-Bewertungen, Notizen des Spielers und vom Modell verfasste Erklärungen zu einer nachvollziehbaren Schachpartie-Analyse. Wir zeichnen den dokumentierten Ablauf und seine Grenzen nach.

By BIG CHANGE Editorial

Published: 2026-09-26T20:57:48.171Z
Updated: 2026-09-26T20:57:48.171Z
Canonical: https://bigchange.ai/blog/claude-code-chess-stockfish-postmortem-skill

![A chess player studies a midgame position on a wooden chessboard beside an analog chess clock in a quiet club room.](https://bigchange.ai/api/media/file/chess-postmortem-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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](https://github.com/brumar/chess-postmortem-skills) 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`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/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`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/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](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py) 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`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_viewer.py) ein eigenständiges HTML-Brett mit Kommentaren, Bewertungsdiagramm und zwischengespeicherten Engine-Varianten. Ein späterer, optionaler [`chess-video` Skill](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) 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](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) 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](https://code.claude.com/docs/en/skills) 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](https://stockfishchess.org/download/) 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](https://github.com/ggml-org/whisper.cpp) 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](https://claude.com/pricing) 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.

## Sources

- [brumar/chess-postmortem-skills, README in Commit 46919038](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — Bericht des Autors zur Partie, den Eingaben, Beispielausgaben, Installation, Voraussetzungen und einer geschätzten Verarbeitungszeit von rund einer Stunde. Die persönliche Einschätzung zu Fehlern und Zeitaufwand sind keine unabhängigen Messungen.
- [Schachanalyse-Skill und Prüfer-Checkliste](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/SKILL.md) — Beschreibt PGN- und optionale Notiz-/Audioeingaben, Stockfish-Durchlauf, Abfragen des Analysten, Aufbau der Kommentare, modellgesteuerten Prüfer und HTML-Ausgabe. Die Prüfer-Checkliste steht in den verlinkten Referenzen unter style.md; schriftliche Anweisungen belegen nicht, dass jede Prüfung korrekt ist.
- [Skripte zur Schachanalyse: Durchlauf, Abfragen, Kommentaraufbau und Viewer](https://github.com/brumar/chess-postmortem-skills/tree/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts) — Der Code belegt Standardsuchtiefe und Verlustschwelle, eingeschränkte Stockfish-Abfragen mit gespeicherten Varianten, erneutes Einlesen der PGN-Datei und Bündelung als HTML. Die Codeprüfung ist weder ein Ausführungstest noch eine Qualitätsbewertung.
- [Schachvideo-Skill und Render-Skript](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) — Dokumentiert das optionale Storyboard, die Sprachspur, MP4-Datei, Untertitel und HTML-Ausgabe samt eigenen Videovoraussetzungen. BIG CHANGE hat kein Video erstellt.
- [Dokumentation von Claude Code: Skills](https://code.claude.com/docs/en/skills) — Bestätigt die persönlichen und projektbezogenen Verzeichnisse für Skills. Die Kompatibilität dieses Drittanbieterprojekts mit verschiedenen Versionen wird damit nicht geprüft.
- [Offizielle Stockfish-Downloads](https://stockfishchess.org/download/) — Listet Stockfish 19 und Downloads für verschiedene Plattformen. Das geprüfte Abrufskript des Projekts ist auf Stockfish 17.1 für Linux x86-64 festgelegt.
- [Offizielles Repository von whisper.cpp](https://github.com/ggml-org/whisper.cpp) — Dokumentiert whisper-cli und die Umwandlung der Eingabe in 16-Bit-WAV. Transkription und Zuordnung von Audio zu Zügen sind optionale Bestandteile des Projekts und wurden hier nicht getestet.
- [Anthropic: Claude-Preise](https://claude.com/pricing) — Die Tarifübersicht für Einzelpersonen führt Claude Code unter Pro statt Free und nennt für Pro 20 US-Dollar pro Monat beziehungsweise umgerechnet 17 US-Dollar pro Monat bei jährlicher Abrechnung. Es gelten Nutzungslimits und mögliche Preisänderungen; das Schachprojekt nennt keine Kosten pro Durchlauf.