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 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. 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 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 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 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 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 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 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 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 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 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.