LE MONDE NE S’ARRÊTE PAS.RSS
BIG CHANGE.

Édition Markdown

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

# Une compétence d’analyse d’échecs pour Claude Code associe Stockfish aux notes du joueur

> Un ensemble public de compétences pour Claude Code associe les évaluations de Stockfish, les notes du joueur et des explications rédigées par un modèle dans une analyse rétrospective d’une partie d’échecs que l’on peut examiner. Nous retraçons le processus documenté et ses limites.

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.

Un ensemble public de compétences pour Claude Code transforme une partie d’échecs en PGN annoté et en échiquier d’analyse HTML. L’auteur propose aussi un moyen de produire une vidéo commentée. Stockfish évalue les positions ; Claude Code pose des questions complémentaires et rédige des explications pour le joueur. Le [dépôt](https://github.com/brumar/chess-postmortem-skills) fournit une partie analysée et les scripts qui réalisent ce processus. BIG CHANGE a examiné la documentation et le code au commit `46919038`, daté du 26 septembre 2026 ; nous n’avons pas exécuté le processus ni évalué nous-mêmes les conseils d’échecs.

## Le grand changement

- **Ce qui change :** Ce petit projet public décrit un processus qui relie les vérifications de positions d’un moteur à des explications portant sur la propre partie d’un joueur et, si elles sont fournies, sur son raisonnement enregistré.
- **Pourquoi c’est important :** Le joueur peut examiner séparément le PGN, l’analyse du moteur, les requêtes enregistrées et les annotations. Il lui est ainsi plus facile de remettre en question une explication générée à la position qu’elle décrit. Ici, aucun résultat ne mesure si cela aide un joueur à progresser.
- **À surveiller :** Le modèle choisit toujours les questions, interprète les variantes du moteur et rédige la leçon. Le vérificateur guidé par une invite contrôle ce travail, mais sa présence ne prouve pas son exactitude. Une personne qui envisage d’utiliser le résultat pour étudier devrait examiner les positions et variantes citées.

## Du compte rendu d’une partie aux erreurs possibles

L’entrée est une partie au format PGN, fournie directement ou obtenue à partir d’un lien vers une partie. La compétence `chess-analysis` détermine d’abord le niveau du lecteur afin d’adapter les commentaires à celui-ci. Il est possible d’ajouter des notes écrites. Pour un enregistrement où le joueur expose son raisonnement à voix haute, le processus documenté utilise whisper.cpp en local pour transcrire la voix et la faire correspondre aux coups à l’aide des commentaires d’horloge du PGN. Cette correspondance dépend de données d’horloge exploitables et de références orales que l’on peut associer aux coups ; elle ne permet pas de retrouver les pensées du joueur à partir du seul PGN.

La première étape mécanique est visible dans [`sweep.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/sweep.py). Le script demande à Stockfish d’évaluer la position avant et après chaque coup joué, consigne les coups candidats et leurs scores, puis signale un coup lorsque la perte mesurée atteint son seuil par défaut de 30 centipions. La profondeur de recherche par défaut indiquée est de 22. Ces évaluations repèrent les positions à examiner de plus près ; leurs chiffres n’expliquent pas à eux seuls une erreur.

La compétence charge ensuite un agent d’analyse dans Claude Code d’examiner chaque position signalée. Son [`query.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/query.py) peut interroger Stockfish sur d’autres coups, notamment au moyen d’une recherche limitée à un coup proposé, et enregistrer les variantes obtenues au format JSON. Des consignes distinctes demandent à l’agent d’examiner les images de l’échiquier et d’expliquer pourquoi un coup ou une autre possibilité fonctionne. Les notes du joueur ne peuvent éclairer une explication que si elles concernent le coup en question. C’est à ce stade que les résultats du moteur deviennent un texte d’échecs rédigé par le modèle, avec la part de jugement et le risque d’erreur que cela comporte.

## Ce que les vérifications et les résultats permettent d’établir

La compétence `chess-analysis` du dépôt prévoit qu’un agent vérificateur distinct examine les annotations terminées à l’aide de l’analyse et des notes du joueur. Sa liste de contrôle porte sur les erreurs signalées, la légalité des variantes, les affirmations d’évaluation et les déclarations sur ce que le joueur pensait ; les affirmations d’évaluation doivent correspondre à l’analyse ou aux requêtes Stockfish enregistrées. Le fichier [`build_annotated.py` est un script qui](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py) réanalyse aussi le PGN et signale les erreurs d’analyse syntaxique. Il s’agit de contrôles différents : l’analyse syntaxique établit que les coups peuvent être lus, tandis que le vérificateur effectue une autre révision des explications, guidée par le modèle. Aucun de ces contrôles ne garantit que toutes les interprétations sont justes. L’auteur dit avoir rarement rencontré des erreurs dans son usage personnel, mais ne fournit aucune étude indépendante sur leur fréquence.

Le PGN annoté enregistré et le script [`build_viewer.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_viewer.py) produisent un échiquier HTML autonome avec des commentaires, un graphique d’évaluation et des variantes du moteur mises en cache. Une autre étape facultative est la compétence [`chess-video` ; elle](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) part du PGN annoté et de l’analyse. Elle demande à Claude Code de rédiger un storyboard ; ses scripts génèrent ensuite l’échiquier, la narration et un fichier MP4 sous-titré. Le dépôt contient un exemple tiré d’une partie rapide de l’auteur, avec la transcription, l’analyse, les annotations et une vidéo de 6 minutes et 49 secondes. Cet exemple montre les éléments produits visés, pas un résultat mesuré sur plusieurs joueurs ou parties.

## Prérequis, durée et limites

Le [README](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) indique de copier les dossiers de compétences dans le répertoire personnel ou celui du projet de Claude Code, puis de fournir un lien vers une partie ou un PGN. [La documentation de Claude Code](https://code.claude.com/docs/en/skills) confirme l’emplacement de ces répertoires. L’analyse nécessite Python avec `python-chess` et `cairosvg`, ainsi qu’un exécutable Stockfish. Le script de téléchargement du dépôt réutilise un exécutable existant s’il en trouve un ; sinon, il télécharge Stockfish 17.1 pour Linux x86-64. [La page actuelle de téléchargement de Stockfish](https://stockfishchess.org/download/) indique la version 19 : le téléchargement de secours du dépôt est donc fixé à une version antérieure. Pour l’audio, il faut en option whisper.cpp et un modèle ; sa [documentation](https://github.com/ggml-org/whisper.cpp) décrit la conversion audio au format WAV 16 bits pour `whisper-cli`. L’étape vidéo requiert également Pillow, Piper pour la synthèse vocale ou espeak, ainsi que FFmpeg. Ces parcours et dépendances sont documentés ; cet article ne constitue ni un test d’installation ni une garantie de compatibilité avec une machine donnée.

L’auteur estime qu’une analyse complète suivie de la vidéo demande environ une heure de traitement. Le dépôt ne chiffre pas cette exécution. Le tableau tarifaire actuel d’[Anthropic](https://claude.com/pricing) classe Claude Code dans l’offre Pro, et non Free ; Pro coûte 20 $ par mois avec une facturation mensuelle, sous réserve de limites d’utilisation. Le temps de calcul local, l’abonnement éventuel ou l’usage de l’API, ainsi que la configuration facultative de la transcription et de la vidéo font varier le coût selon l’environnement du lecteur. La durée de l’exemple et l’évaluation de sa précision par l’auteur restent le témoignage d’une seule personne.

## Sources

- [brumar/chess-postmortem-skills, README au commit 46919038](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — Récit de l’auteur sur la partie, les entrées, les résultats d’exemple, l’installation, les prérequis et la durée de traitement d’environ une heure. Son évaluation personnelle des erreurs et de la durée ne constitue pas une mesure indépendante.
- [Compétence d’analyse d’échecs et liste de contrôle du vérificateur](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/SKILL.md) — Décrit les entrées PGN et les notes ou enregistrements audio facultatifs, l’analyse Stockfish, les requêtes de l’agent d’analyse, la génération des annotations, la vérification guidée par le modèle et le résultat HTML. La liste du vérificateur figure dans les références liées à references/style.md ; des consignes écrites ne garantissent pas que chaque vérification soit correcte.
- [Scripts d’analyse d’échecs : analyse Stockfish, requêtes, génération des annotations et affichage](https://github.com/brumar/chess-postmortem-skills/tree/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts) — Le code établit la profondeur par défaut et le seuil de perte, les requêtes Stockfish limitées avec variantes enregistrées, la réanalyse du PGN et la création de la page HTML. L’inspection du code ne constitue ni une exécution ni une évaluation de la qualité.
- [Compétence vidéo d’échecs et script de rendu](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) — Décrit le storyboard facultatif, la narration, le MP4, les sous-titres et l’étape HTML, ainsi que les prérequis propres à la vidéo. BIG CHANGE n’a généré aucune vidéo.
- [Documentation de Claude Code : compétences](https://code.claude.com/docs/en/skills) — Confirme l’emplacement des répertoires de compétences personnels et de projet. Ne valide pas la compatibilité de ce projet tiers entre différentes versions.
- [Téléchargements officiels de Stockfish](https://stockfishchess.org/download/) — Répertorie Stockfish 19 et les téléchargements par plateforme. Le script de téléchargement de secours du projet examiné est fixé à Stockfish 17.1 pour Linux x86-64.
- [Dépôt officiel de whisper.cpp](https://github.com/ggml-org/whisper.cpp) — Documente whisper-cli et la conversion de l’entrée en WAV 16 bits. La transcription et l’association de l’audio aux coups sont des étapes facultatives du projet qui n’ont pas été testées ici.
- [Tarifs de Claude chez Anthropic](https://claude.com/pricing) — Le tableau des offres individuelles inclut Claude Code dans Pro, et non Free, et indique un tarif de 20 $ par mois ou l’équivalent de 17 $ par mois avec une facturation annuelle. Des limites d’utilisation et des changements tarifaires s’appliquent ; le projet d’échecs ne donne aucun coût par exécution.