Claude Code génère une analyse post‑mortem d’échecs avec Stockfish

Principe de fonctionnement

Le skill chess‑postmortem‑skills de Claude Code transforme une partie d’échecs en un post‑mortem complet. L’utilisateur fournit deux entrées : le lien Lichess (ou le fichier PGN) et un enregistrement audio de ses pensées pendant la partie. L’audio est transcrit localement avec whisper.cpp, puis chaque phrase est alignée aux coups grâce aux horloges du PGN. Claude interroge ensuite Stockfish pour chaque position, pose des questions naïves (« pourquoi pas ce coup ? », « et si les Noirs prennent ? ») et reformule les réponses en langage naturel. Le résultat comprend un PGN annoté, une page HTML interactive et une vidéo narrée de 6 min 49 s (10 Mo) contenant le tableau, des flèches, la jauge d’évaluation et des sous‑titres générés par Piper TTS.

Architecture technique

Le skill orchestre trois sous‑agents : sweep, qui lance Stockfish sur chaque coup ; investigator, qui génère les questions humaines et valide les réponses ; et transcription, qui utilise whisper.cpp pour la reconnaissance vocale. Les sous‑agents fonctionnent en parallèle, ce qui explique le temps de traitement d’environ une heure pour une partie de 30 coups (exemple : partie 15+10 rapid, rating ~1700, Open Sicilian contre Najdorf). Les sorties sont assemblées dans le répertoire examples/game-010/, où le storyboard aligne texte, audio et mouvements. Le code source, publié sous licence MIT sur GitHub, expose les points d’entrée du skill et les scripts de génération vidéo.

Analyse des performances et limites

Le processus repose sur la puissance de Stockfish (version non précisée) et sur la précision de whisper.cpp. Une transcription erronée peut désynchroniser le texte et les coups, mais le skill effectue une passe de vérification où chaque affirmation est re‑consultée par le moteur, réduisant les hallucinations à un niveau rare. La contrainte principale est le temps de calcul : un blitz ne bénéficie pas d’une analyse instantanée comme Lichess ou Chess.com, qui offrent des évaluations en quelques secondes. De plus, l’exécution nécessite une installation locale de Claude Code et un accès à un GPU ou à un CPU performant pour le décodage audio. Enfin, l’efficacité dépend de la qualité des notes ou de l’enregistrement ; sans audio, le skill fournit uniquement l’analyse du moteur, perdant la dimension « réfutation du raisonnement personnel ».