Claude Code skill로 체스 복기: Stockfish 검증 + 음성 해설 영상

Who Should Read

Claude Code skill로 엔진·외부 도구를 묶어 검증 가능한 분석 워크플로를 만들어 보려는 개발자

Core Mechanics

• Claude가 Stockfish를 직접 몰고 다닌다
  • Claude가 "내가 둔 수 말고 왜 이게 아니지?" 같은 질문을 엔진에 던진다.
  • 답이 납득될 때까지 계속 묻고, 결과를 사람 말로 적는다.
• 생각 녹음이 있으면 내 판단을 반박해 준다
  • 대국 중 소리 내어 생각한 음성을 whisper.cpp로 로컬에서 글로 바꾼다.
  • PGN(기보 파일)의 시계 시간으로 문장을 그 순간의 수에 맞춘다.
• 분석은 단계별 서브에이전트로 쪼갠다
  • 먼저 Stockfish로 모든 수를 훑는다.
  • 이어서 병렬 "investigator" 서브에이전트가 실수마다 엔진에 질문해 원인을 설명한다.
• 환각은 엔진 검증과 검증 패스로 줄인다
  • 모든 주장은 Stockfish로 확인하고, verifier 패스가 결과를 다시 읽는다.
  • 저자 경험상 오류는 드물지만, 이상하면 해당 局面을 엔진으로 다시 확인시키라고 안내한다.
• skill 4개로 나뉜다
  • chess-analysis는 주석 PGN과 HTML 보드, chess-video는 해설 영상을 만든다.
  • chess-position은 단일 局面 분석, chess-play는 엔진 없이 PGN으로 대국한다.

Community Reactions

• 엔진 없이 LLM만 쓰면 쓸모없다는 반론
  • LLM이 불법 수를 두거나 기물을 환각한다는 의견이 있었다.
  • Stockfish가 받쳐 주니 LLM이 해설만 더하는 구조는 흥미롭다는 의견도 있었다.
• 새롭지 않다는 지적
  • 전통 엔진 기반 자동 분석은 오래전부터 있었고 chess.com도 이미 했을 것이라는 의견이 있었다.
  • 그래도 배움과 호기심 측면에서는 의미 있다는 반응이 있었다.
• 실데이터를 프롬프트에 넣으면 쓸 만했다는 경험
  • 스크래블 AI의 LLM 설명기를 만들었더니 몬테카를로 시뮬레이션 데이터를 프롬프트에 넣어 환각이 적었다는 경험이 있었다.
  • 짧고 검증 가능한 리포트를 주는 도구가 코치 전체를 흉내 내는 도구보다 낫다는 의견도 있었다.
• SKILL.md를 AI가 썼다는 점과 비용에 대한 비판
  • 프롬프트를 AI로 쓰는 건 게으르다는 비판이 있었다.
  • 1회에 15달러라는 비용이 비싸다는 의견이 있었다.

How to Apply

• 오늘 skill을 설치하고 대국 하나 돌려 보기
  • git clone 후 skills 폴더를 ~/.claude/skills/에 복사한다.
  • Claude Code에 "install the dependencies for the chess skills"라고 말해 의존성을 깔게 한다.
• LLM 옆에 검증 도구 붙이는 구조 따라 하기
  • LLM이 약한 영역은 전용 엔진·계산기를 도구로 호출하게 한다.
  • 최종 답 전에 모든 주장을 그 도구로 확인하게 지시한다.
• 검증용 서브에이전트 패스 추가하기
  • 조사 에이전트를 병렬로 돌린 뒤 결과를 다시 읽는 verifier 단계를 넣는다.
  • 이상한 결과는 해당 항목만 도구로 재확인시킨다.
• 사용자 맥락을 CLAUDE.md에 고정하기
  • 독자 수준 같은 고정 정보를 CLAUDE.md에 한 번 적는다.
  • 예: "Write chess analysis for a 1800 player."

Try It

# Claude Code에 붙여넣기 (skill 설치 후 사용)

# 설치 (터미널)
git clone https://github.com/brumar/chess-postmortem-skills
cp -r chess-postmortem-skills/skills/* ~/.claude/skills/

# Claude Code에 입력
analyze this game: {{lichess 링크}}, here is my think-aloud recording: {{mp3 경로}}

# 이어서 해 볼 것
make a video of this game

Terminology

관련 논문

• 같은 시뮬레이션, 다른 근거: 도구 출력을 파일로 넘기면 LLM 에이전트 정확도가 어디서 깎이나

  긴 툴 출력을 파일로 넘기자 GPT-5.1은 정확도 11.3%p 하락, 정식 출력 지정하니 회복

• 가짜 뉴스가 진짜 폭락을: LLM 트레이딩 에이전트 대상 정보 주입 공격

  가짜 헤드라인 한 줄로 LLM 트레이딩 에이전트 62%를 조종했다(프롬프트 주입은 14%)

• Harness Engineering 101: LLM은 뇌, harness는 몸

  에이전트는 JSON 배열을 관리하는 루프이고, 16개 챕터로 직접 만들어 본다

• Harness²: 에이전트 harness를 스스로 고쳐 쓰는 재귀 최적화 프레임워크

  모델은 고정하고 harness를 재귀로 고쳤더니 벤치마크 점수가 최대 11.8%p 올랐다

• 해고된 Savannah 경찰관, ICE 요원 남편에게 Flock 계정 공유

  경찰관이 Flock 계정을 남편(ICE 요원)에게 공유했고, 감사에서 983건 검색이 드러나 해고됐다

• tmux와 Claude Code: 세션, send-keys, 그리고 한계선

  tmux로 Claude Code 여러 개를 돌리면 편하지만 에이전트 4개쯤에서 한계가 온다

• Hybrid Reasoning Agents: 잠재 공간에서 생각하고 텍스트로 행동하는 LLM 에이전트

  잠재 공간 추론과 텍스트 도구 호출을 섞었더니 성능 10.4%↑, 토큰 최대 54.7%↓

Related Resources

• https://github.com/brumar/chess-postmortem-skills
• https://news.ycombinator.com/item?id=49857528
• https://elogram.gg/
• https://github.com/bobjansen/Babelfish
• https://pwalessi.itch.io/chess-buddy
• https://chesspoly.com/