Markdown 버전

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

# Claude Code 체스 스킬: Stockfish 분석과 플레이어의 메모를 결합하다

> 공개된 Claude Code 스킬 모음은 Stockfish 평가, 플레이어 메모, 모델이 작성한 해설을 검토 가능한 체스 복기 자료로 결합한다. 문서에 나온 작업 흐름과 한계를 살펴본다.

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.

공개된 Claude Code 스킬 모음은 한 판의 체스 경기를 주석이 달린 PGN과 HTML 분석 보드로 바꾼다. 작성자는 내레이션이 포함된 영상으로 만드는 방법도 제공한다. Stockfish가 포지션을 평가하고 Claude Code는 후속 질문을 던져 플레이어를 위한 설명을 작성한다. [저장소](https://github.com/brumar/chess-postmortem-skills)에는 작업 예시 한 판과 그 과정에 쓰이는 스크립트가 담겨 있다. BIG CHANGE는 2026년 9월 26일자 커밋 `46919038`의 문서와 코드를 살펴봤다. 워크플로를 실행하거나 체스 조언을 직접 평가하지는 않았다.

## 큰 변화

- **달라진 점:** 이 작은 공개 프로젝트는 엔진의 포지션 검사 결과를 체스 플레이어 자신의 경기와, 제공된 경우 기록해 둔 사고 과정에 맞춘 설명으로 연결하는 작업 흐름을 문서화한다.
- **중요한 이유:** 플레이어는 PGN, 엔진 전수 분석 결과, 저장된 질의 변형 수순, 주석을 따로 살펴볼 수 있다. 덕분에 생성된 설명이 다루는 포지션에서 그 설명에 의문을 제기하기가 쉽다. 이 방식이 플레이어의 실력 향상에 도움이 되는지는 여기서 측정하지 않았다.
- **지켜볼 점:** 모델은 여전히 질문을 고르고 엔진 수순을 해석해 학습 내용을 작성한다. 프롬프트 기반 검증기가 결과를 확인하지만, 검증기가 있다는 사실만으로 정확성이 입증되지는 않는다. 학습에 결과를 활용하려는 독자는 인용된 포지션과 수순을 검토해야 한다.

## 경기 기록에서 실수 후보 찾기

입력은 직접 제공하거나 경기 링크에서 가져온 PGN 경기 기록이다. `chess-analysis` 스킬은 먼저 독자의 수준을 설정해 해당 플레이어에게 맞는 설명을 생성한다. 직접 작성한 메모도 추가할 수 있다. 음성을 녹음하며 생각을 말한 경우, 문서에 나온 방법은 로컬 whisper.cpp로 음성을 전사한 뒤 PGN의 시계 주석을 사용해 발화를 수와 맞춘다. 이 정렬에는 쓸 수 있는 시계 데이터와 발화 속 경기 수에 대한 참조를 찾는 과정이 필요하다. PGN만으로 플레이어의 생각을 복원하는 방법은 아니다.

첫 번째 기계 분석 단계는 [`sweep.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/sweep.py)를 살펴보면 알 수 있다. 이 스크립트는 Stockfish에 각 수를 두기 전후의 포지션 평가를 요청하고, 후보 수와 점수를 기록한다. 측정된 손실이 기본값인 30센티폰에 도달하면 해당 수를 표시한다. 문서에 기재된 기본 탐색 깊이는 22다. 이러한 평가는 자세히 살펴볼 포지션을 찾아내지만, 점수만으로 실수의 원인을 설명하지는 못한다.

이어서 스킬은 Claude Code 조사 에이전트가 표시된 각 포지션을 살펴보도록 안내한다. [`query.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/query.py)는 대안 수를 Stockfish에 질의하고, 제안된 수로 탐색 범위를 제한한 분석도 수행한 뒤 결과 수순을 JSON으로 저장할 수 있다. 별도의 지침은 조사 에이전트가 보드 이미지를 살펴보고 특정 수나 대안이 왜 유효한지 설명하도록 한다. 플레이어 메모는 해당 수에 연결된 경우에만 설명에 반영될 수 있다. 이 단계에서 엔진 출력은 모델이 쓴 체스 해설로 바뀌며, 이때 판단과 오류 가능성이 결과에 들어간다.

## 검사와 출력으로 확인할 수 있는 것

저장소의 `chess-analysis` 스킬은 별도의 검증 에이전트가 완성된 주석을 분석 결과 및 플레이어 메모와 함께 검토하도록 한다. 체크리스트는 표시된 실수, 합법적인 변형 수순, 평가 관련 주장, 플레이어의 생각에 관한 진술을 다룬다. 평가 관련 주장은 분석 결과나 저장된 엔진 질의와 일치해야 한다. [`build_annotated.py` 스크립트](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py)는 PGN을 다시 파싱하고 파싱 오류를 보고한다. 이 둘은 서로 다른 검사다. 파싱은 수를 읽을 수 있는지 확인하고, 검증기는 설명을 모델 지침에 따라 다시 검토한다. 어느 쪽도 모든 해석이 옳다고 입증하지는 않는다. 작성자는 개인적으로 사용할 때 오류가 드물었다고 말하지만, 독립적인 오류 연구를 제시하지는 않았다.

저장된 주석 포함 PGN과 [`build_viewer.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_viewer.py)를 이용하면 주석과 평가 그래프, 캐시된 엔진 수순이 들어 있는 독립 실행형 HTML 보드를 만들 수 있다. 이후 선택 사항인 [`chess-video` 스킬](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md)은 주석 포함 PGN과 전수 분석 결과에서 시작한다. Claude Code에 스토리보드를 작성하게 한 다음 스크립트로 보드를 렌더링하고, 내레이션을 합성해 자막이 포함된 MP4를 만든다. 저장소에는 작성자 자신의 래피드 경기 사례가 하나 들어 있다. 전사문, 전수 분석, 주석, 길이 6분 49초의 영상이 포함된 예다. 이는 의도된 산출물을 보여주는 사례이지, 여러 플레이어나 경기에서 측정한 결과는 아니다.

## 사전 요건, 소요 시간과 한계

이 저장소의 [README](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md)에는 스킬 폴더를 Claude Code의 개인용 또는 프로젝트용 스킬 디렉터리에 복사한 다음 경기 링크나 PGN을 제공하라고 적혀 있다. [Claude Code 공식 문서](https://code.claude.com/docs/en/skills)는 해당 스킬 디렉터리 위치를 확인해 준다. 분석에는 Python과 `python-chess`가 필요하고, 여기에 `cairosvg`도 필요하며 Stockfish 실행 파일도 있어야 한다. 저장소의 다운로드 스크립트는 사용 가능한 실행 파일이 있으면 그것을 쓰고, 없으면 Linux x86-64용 Stockfish 17.1 빌드를 내려받는다. [Stockfish 공식 다운로드 페이지](https://stockfishchess.org/download/)에는 현재 버전 19가 올라와 있으므로 저장소의 대체 다운로드 경로는 이전 버전으로 고정되어 있다. 선택 사항인 오디오 기능에는 whisper.cpp와 모델이 필요하다. 해당 [문서](https://github.com/ggml-org/whisper.cpp)에는 오디오를 `whisper-cli`용 16비트 WAV로 변환하는 방법이 나온다. 영상 단계에는 Pillow, Piper 음성 합성 또는 espeak, FFmpeg도 필요하다. 이 경로와 종속성은 문서에 기재되어 있다. 이 기사는 설치 테스트가 아니며 특정 컴퓨터와의 호환성을 보장하지 않는다.

작성자는 전체 복기와 영상 처리에 약 한 시간이 걸린다고 추산한다. 저장소에는 해당 실행의 비용이 제시되어 있지 않다. [Anthropic의 현재 요금제 표](https://claude.com/pricing)에는 Claude Code가 Free가 아닌 Pro에 포함된 것으로 나와 있다. Pro는 월별 결제 시 월 20달러이며 사용량 제한이 적용된다. 로컬 계산 시간, 구독 또는 API 이용 여부, 선택적인 전사와 영상 설정에 따라 독자의 환경별 비용이 달라진다. 예시에 나온 시간과 정확도에 대한 작성자의 평가는 한 사용자의 경험으로 읽어야 한다.

## Sources

- [brumar/chess-postmortem-skills, 커밋 46919038의 README](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — 작성자가 경기, 입력, 결과 예시, 설치, 사전 요건 및 약 한 시간의 처리 시간을 설명한다. 오류와 소요 시간에 대한 개인적 평가는 독립적인 측정 결과가 아니다.
- [체스 분석 스킬 및 검증 체크리스트](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/SKILL.md) — PGN과 선택적 메모·오디오 입력, Stockfish 전수 분석, 조사 에이전트의 질의, 주석 빌드, 모델 지침 기반 검증기 및 HTML 출력을 설명한다. 검증 체크리스트는 연결된 references/style.md에 있다. 문서에 지침이 적혀 있다고 해서 모든 검토가 정확하다는 뜻은 아니다.
- [체스 분석 스크립트: sweep, query, 주석 빌드, 뷰어](https://github.com/brumar/chess-postmortem-skills/tree/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts) — 코드에서 기본 탐색 깊이와 손실 임계값, 저장된 수순을 사용하는 제한 탐색 Stockfish 질의, PGN 재파싱 및 HTML 묶음 구성을 확인할 수 있다. 소스 코드만 살펴보는 것은 실행 테스트나 품질 평가가 아니다.
- [체스 영상 스킬 및 렌더링 스크립트](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) — 별도 영상 사전 요건과 함께 선택적 스토리보드, 내레이션, MP4, 자막 및 HTML 단계를 설명한다. BIG CHANGE는 영상을 생성하지 않았다.
- [Claude Code 문서: 스킬](https://code.claude.com/docs/en/skills) — 개인용 및 프로젝트용 스킬 디렉터리 위치를 확인해 준다. 이 서드파티 프로젝트가 여러 버전에서 호환되는지는 검증하지 않는다.
- [Stockfish 공식 다운로드](https://stockfishchess.org/download/) — Stockfish 19와 플랫폼별 다운로드를 안내한다. 검토한 프로젝트의 대체 다운로드 스크립트는 Linux x86-64용 Stockfish 17.1로 고정되어 있다.
- [whisper.cpp 공식 저장소](https://github.com/ggml-org/whisper.cpp) — whisper-cli와 입력 오디오를 16비트 WAV로 변환하는 방법을 문서화한다. 전사 및 음성과 수의 정렬은 프로젝트의 선택 기능이며 여기서는 테스트하지 않았다.
- [Anthropic Claude 요금 안내](https://claude.com/pricing) — 개인 요금제 표에 Claude Code가 Free가 아닌 Pro에 포함되며, Pro는 월별 결제 시 월 20달러, 연간 결제 시 월 환산 17달러로 나온다. 사용량 제한과 요금 변경이 적용될 수 있다. 체스 프로젝트는 실행당 비용을 제시하지 않는다.