Analyze your chess games into commented videos
Claude Code skills that turn one of your chess games into a post-mortem you can actually read: plain-language explanations of your mistakes, checked against Stockfish, and a narrated video of the whole game. Task: Claude Code skills that turn one of your chess games into a post-mortem you can actually read: plain-language explanations of your mistakes, checked against Stockfish, and a narrated video of the whole game. Edit: Damned this hit front page of HackerNews. You can go there for insightful conversations: https://news.ycombinator.com/item?id=49857528 I should have selected a game without a massive blunder on my side ahah. The video If the player above does not load (it needs a GitHub login), watch the mp4 directly (10 MB). 6:49, English narration, subtitles. This is a real game of mine: a 15+10 rapid on lichess (5KmlrdyT), White, Open Sicilian against a Najdorf, around 1700. During the game I recorded myself thinking aloud, in French, with a plain voice recorder running next to the board. After the game I gave Claude two things: the lichess link and the mp3. Claude transcribed the audio locally with whisper.cpp, then used the clock times in the PGN to match each sentence to the move I was deciding at that moment. So when the video says "at move eight you asked yourself whether the bishop belongs on c4 or e2", that is my own question, answered with the engine. Everything the video shows (the transcript, the Stockfish sweep, the annotated PGN, the storyboard) is in examples/game-010/. Why this exists A Stockfish analysis gives you numbers and lines. It is not fun to read, and often it does not tell you why: -1.8 after your move, and a 12-move variation you would never find at the board. I realized Claude can drive Stockfish itself. It asks the engine the questions a human would ask ("why not the move I played?", "what if Black simply takes?"), keeps asking until the answer makes sense, and writes it down in human terms. And since it knows what I was thinking during the game, it can refute my actual reasoning instead of a guessed one. After the analysis I can keep asking my own questions about any position, and it checks them with the engine before answering. Is it for you? Probably yes if: you play slow or rapid games and want to learn from them, not just see where the eval bar dropped; you are fine running Claude Code on your machine; you are willing to take notes or talk during the game (optional, but this is what makes the result interesting). Probably not if you want a quick check of a blitz game. Lichess or chess.com analysis does that in seconds. It takes time. A full run (sweep, investigations, annotations, video) takes around one hour of processing. Use it on games where you took the time to think, not on every game you play. Give it your thoughts. I strongly recommend passing your written notes or an audio recording covering the whole game. Without them you get a good engine explanation. With them you get a review of your reasoning: which fears were justified, which plans were sound, which questions you asked yourself and what the answer was. Hallucinations. The AI can still get something wrong. Every claim is checked against Stockfish and a verifier pass re-reads the result, so in my experience errors are rare. If something looks off, ask Claude to check that position with the engine. My workflow Play a game with some time to think (15+10 rapid, or correspondence). Record myself thinking aloud during the game (any phone or web voice recorder). For correspondence games, I write notes per move instead. After the game, open Claude Code and say something like: "analyze this game: , here is my think-aloud recording: ". Wait about an hour. I get an annotated PGN and a standalone HTML analysis board. Ask for the video: "make a video of this game". Read, watch, then ask questions about the positions I still do not understand. The skills The skills are written for Claude to read, so the SKILL.md files double as the documentation. Start with skills/chess-analysis/SKILL.md. Install Copy (or symlink) the skill folders into .claude/skills/ of your project, or into ~/.claude/skills/ for all projects: Then ask Claude something like "analyze this game: " or "make a video of game 010". Requirements You do not need to set these up by hand. Claude Code can most likely install them for you: ask it to "install the dependencies for the chess skills" and it will read the list below and the SKILL.md files. Python venv with python-chess, cairosvg (analysis), plus pillow, piper-tts for the video. The skills assume a .venv-chess at the repo root and create it if missing.; tools: Claude Code. Human role: The original post does not say how a person stayed involved.; limitations: Requires local execution of Claude Code, Stockfish, whisper.cpp, and Python dependencies. Not suitable for blitz games due to the one-hour processing time. Think-aloud recordings are optional but recommended for deeper insight. Hallucinations are possible, though mitigated by engine checks..
Tools
Published on Agent Work Atlas:
Overview
Claude Code skills that turn one of your chess games into a post-mortem you can actually read: plain-language explanations of your mistakes, checked against Stockfish, and a narrated video of the whole game.
Workflow
Claude Code skills that turn one of your chess games into a post-mortem you can actually read: plain-language explanations of your mistakes, checked against Stockfish, and a narrated video of the whole game. Edit: Damned this hit front page of HackerNews. You can go there for insightful conversations: https://news.ycombinator.com/item?id=49857528 I should have selected a game without a massive blunder on my side ahah. The video If the player above does not load (it needs a GitHub login), watch the mp4 directly (10 MB). 6:49, English narration, subtitles. This is a real game of mine: a 15+10 rapid on lichess (5KmlrdyT), White, Open Sicilian against a Najdorf, around 1700. During the game I recorded myself thinking aloud, in French, with a plain voice recorder running next to the board. After the game I gave Claude two things: the lichess link and the mp3. Claude transcribed the audio locally with whisper.cpp, then used the clock times in the PGN to match each sentence to the move I was deciding at that moment. So when the video says "at move eight you asked yourself whether the bishop belongs on c4 or e2", that is my own question, answered with the engine. Everything the video shows (the transcript, the Stockfish sweep, the annotated PGN, the storyboard) is in examples/game-010/. Why this exists A Stockfish analysis gives you numbers and lines. It is not fun to read, and often it does not tell you why: -1.8 after your move, and a 12-move variation you would never find at the board. I realized Claude can drive Stockfish itself. It asks the engine the questions a human would ask ("why not the move I played?", "what if Black simply takes?"), keeps asking until the answer makes sense, and writes it down in human terms. And since it knows what I was thinking during the game, it can refute my actual reasoning instead of a guessed one. After the analysis I can keep asking my own questions about any position, and it checks them with the engine before answering. Is it for you? Probably yes if: you play slow or rapid games and want to learn from them, not just see where the eval bar dropped; you are fine running Claude Code on your machine; you are willing to take notes or talk during the game (optional, but this is what makes the result interesting). Probably not if you want a quick check of a blitz game. Lichess or chess.com analysis does that in seconds. It takes time. A full run (sweep, investigations, annotations, video) takes around one hour of processing. Use it on games where you took the time to think, not on every game you play. Give it your thoughts. I strongly recommend passing your written notes or an audio recording covering the whole game. Without them you get a good engine explanation. With them you get a review of your reasoning: which fears were justified, which plans were sound, which questions you asked yourself and what the answer was. Hallucinations. The AI can still get something wrong. Every claim is checked against Stockfish and a verifier pass re-reads the result, so in my experience errors are rare. If something looks off, ask Claude to check that position with the engine. My workflow Play a game with some time to think (15+10 rapid, or correspondence). Record myself thinking aloud during the game (any phone or web voice recorder). For correspondence games, I write notes per move instead. After the game, open Claude Code and say something like: "analyze this game: , here is my think-aloud recording: ". Wait about an hour. I get an annotated PGN and a standalone HTML analysis board. Ask for the video: "make a video of this game". Read, watch, then ask questions about the positions I still do not understand. The skills The skills are written for Claude to read, so the SKILL.md files double as the documentation. Start with skills/chess-analysis/SKILL.md. Install Copy (or symlink) the skill folders into .claude/skills/ of your project, or into ~/.claude/skills/ for all projects: Then ask Claude something like "analyze this game: " or "make a video of game 010". Requirements You do not need to set these up by hand. Claude Code can most likely install them for you: ask it to "install the dependencies for the chess skills" and it will read the list below and the SKILL.md files. Python venv with python-chess, cairosvg (analysis), plus pillow, piper-tts for the video. The skills assume a .venv-chess at the repo root and create it if missing.
Reported result
The author reports that the workflow produces a 6:49 narrated video and annotated PGN for a specific game. They state that errors are rare due to Stockfish verification, but no quantitative success metrics or failure rates are provided. The process takes approximately one hour per game.
Human role
The original post does not say how a person stayed involved.
Limitations
Requires local execution of Claude Code, Stockfish, whisper.cpp, and Python dependencies. Not suitable for blitz games due to the one-hour processing time. Think-aloud recordings are optional but recommended for deeper insight. Hallucinations are possible, though mitigated by engine checks.
Try it
I want to analyze my recent chess game using Claude Code. Here is the Lichess game link: [replaceable input: lichess_url]. Here is my think-aloud audio recording: [replaceable input: audio_file_path]. Please use the chess-analysis skill to transcribe the audio, align it with the PGN moves, run Stockfish analysis, and generate an annotated PGN and a narrated video. First, perform a dry run on the first 10 moves and show me the transcript alignment and initial analysis. Wait for my confirmation before proceeding with the full game analysis and video generation. Ensure all engine claims are verified. If any dependencies are missing, ask me to install them. Do not publish or share the output without my explicit approval.
Source reports are not independently verified. Publication date is the catalog publication date, not the original article date.