# 클로드 스킬로 체스 하기: 지금 있는 것과 쓰는 법

> 체스용 클로드 스킬이 있을까요? Agent Skills와 MCP 커넥터가 무엇인지, 깃허브의 체스 스킬, 클로드 코드에서 체스 커넥터를 쓰는 법까지 정리했어요.

- URL: https://thechesscoach.netlify.app/ko/guides/claude-chess-skill/
- Updated: 2026-10-28
- Author: Ignacio Soler

공식 클로드 체스 스킬은 없어요. 2026년 10월 26일 기준으로 Anthropic이 미리 만들어 둔 Agent Skills는 PowerPoint, Excel, Word, PDF를 다루고, 체스는 없어요. 찾을 수 있는 건 깃허브의 커뮤니티 체스 스킬(대부분 클로드 코드용)과, Claude에 외부 도구를 붙여 주는 프로토콜인 MCP로 만든 체스 커넥터예요. 둘은 푸는 문제가 달라요. 스킬은 Claude에게 일하는 방식을 가르치고, 커넥터는 진짜 체스 엔진 같은 새 도구를 건네줘요.

이 가이드는 Anthropic 공식 문서를 바탕으로 둘을 설명하고, 체스용으로 실제로 무엇이 있는지 정리하고, 실제 포지션으로 엔진이 왜 중요한지 보여 주고, 클로드 코드에서 체스 커넥터를 쓰는 법을 다뤄요. 아래의 모든 설정 명령은 옆에 링크한 공식 페이지에서 가져왔어요.

## 클로드 스킬이란

Anthropic은 [Agent Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)를 지시문, 메타데이터, 스크립트 같은 선택적 리소스를 묶은 폴더로 설명해요. 관련이 있을 때 Claude가 자동으로 써요(2026년 10월 26일 문서 확인). 핵심은 `SKILL.md` 파일 하나예요. `name`과 `description`이 담긴 짧은 헤더로 시작하고, 그 아래에 평범한 마크다운 지시문이 와요.

체스에서는 세 가지가 중요해요.

1. **Claude는 스킬을 단계적으로 불러와요.** 시작할 때는 각 스킬의 이름과 설명만 읽어요. 스킬 하나에 약 100토큰이에요. 요청이 설명과 맞아떨어지면 전체 지시문을 불러오고, 함께 든 파일은 필요할 때만 불러와요. 그래서 체스 스킬이 언제 깨어날지는 설명이 결정해요.
2. **스킬에 스크립트를 넣을 수 있어요.** 스크립트는 명령줄에서 실행되고, Claude에게는 그 출력만 전달돼요. 체스 스킬이 Stockfish를 부르는 방법이 이거예요. 스크립트가 엔진을 돌리고 Claude는 결과를 읽어요.
3. **스킬을 두는 위치는 환경마다 달라요.** [클로드 코드](https://code.claude.com/docs/en/skills)에서는 개인 스킬을 `~/.claude/skills/<스킬-이름>/SKILL.md`에, 프로젝트 스킬을 `.claude/skills/<스킬-이름>/SKILL.md`에 둬요. claude.ai에서는 설정에서 zip 파일을 올리는데, 코드 실행이 켜진 유료 플랜이어야 해요. Anthropic은 사용자 스킬이 claude.ai, API, 클로드 코드 사이에 동기화되지 않는다고 밝혀요.

체스 스킬을 좌우하는 제약이 하나 있어요. 개요 문서에 따르면 Claude API의 스킬은 네트워크 접근 없이 실행되고, claude.ai의 스킬은 설정에 따라 전체·일부·없음 중 하나이며, 클로드 코드에서는 내 컴퓨터의 다른 프로그램과 같은 네트워크 접근 권한을 가져요. 리체스 대국을 내려받거나 Stockfish를 설치하는 스킬은 클로드 코드에서 가장 자연스럽게 돌아가요.

## MCP 커넥터란

[Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro)은 AI 어시스턴트를 외부 도구와 데이터에 연결하는 개방형 표준이에요. MCP 서버는 도구를 제공하고, 어시스턴트가 언제 호출할지 정해요. 원격 MCP 서버는 인터넷에서 돌아가니까 내 컴퓨터에 아무것도 설치하지 않아요. 보통 OAuth로 로그인하는데, 서비스가 Claude에게 내 비밀번호를 절대 보여 주지 않는다는 뜻이에요.

claude.ai에서는 Anthropic 도움말 [원격 MCP로 사용자 커넥터 시작하기](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)에 URL로 커넥터를 추가하고 계정을 연결하는 방법이 나와 있어요(2026년 10월 확인). 클로드 코드에서는 [MCP 문서](https://code.claude.com/docs/en/mcp)가 원격 HTTP 서버에 대해 이 문법을 안내해요.

```
claude mcp add --transport http <name> <url>
```

같은 페이지에 따르면 클로드 코드는 원격 서버에 OAuth 2.0을 지원해요. 클로드 코드 안에서 `/mcp`를 실행하고 브라우저에서 로그인을 마치면 돼요. 또 claude.ai 계정으로 클로드 코드에 로그인하면 claude.ai에 추가한 커넥터를 클로드 코드에서 자동으로 쓸 수 있다고 해요. 클로드 코드가 API 키나 외부 클라우드 제공자를 쓰는 경우에는 해당하지 않아요.

## 클로드 체스 스킬 vs 체스 커넥터

둘 다 Claude를 체스에 더 쓸모 있게 만들지만 방식이 달라요. 실제 차이는 이래요.

| | 체스 스킬 | 체스 커넥터(원격 MCP) |
|---|---|---|
| 정체 | `SKILL.md`가 든 폴더, 스크립트가 있을 수도 | 도구를 제공하는 서버 |
| 엔진이 도는 곳 | 스킬에 엔진이 있다면 내 컴퓨터 | 제공자의 서버 |
| 설정 | 폴더 복사, 파이썬 패키지와 Stockfish 설치 | URL 붙여넣기, 로그인 |
| 쓸 수 있는 곳 | 주로 클로드 코드, claude.ai는 제한적 | Claude 앱, 클로드 코드, 일부는 ChatGPT에서도 |
| 내 대국 가져오기 | 스크립트가 해 줄 때만 | 서버가 그 도구를 제공하면 |
| 업데이트 담당 | 나(저장소에서) | 제공자 |
| 주요 위험 | 내 컴퓨터에서 코드 실행 | 외부 서비스로 데이터 전송 |

이렇게 생각하면 쉬워요. 스킬은 레시피고, 커넥터는 주방 가전이에요. 체스 스킬은 Claude에게 "설명하기 전에 항상 엔진으로 수를 확인해"라고 시킬 수 있어요. 그래도 엔진은 어딘가에 있어야 해요. 스크립트에 들어 있든, 커넥터로 닿든요.

## 지금 찾을 수 있는 클로드 코드 체스 스킬

2026년 10월 26일에 깃허브와 웹을 검색했어요. 저희가 직접 확인할 수 있었던 공개 체스 스킬은 이거예요. 스타 수는 바뀌어요.

| 프로젝트 | 하는 일 | 엔진 | 메모 |
|---|---|---|---|
| [brumar/chess-postmortem-skills](https://github.com/brumar/chess-postmortem-skills) | 클로드 코드 스킬 네 개: 대국 전체 분석, 포지션 하나 연구, 내레이션 영상, Claude와 대국 | 분석과 포지션용으로 내 컴퓨터의 Stockfish | MIT 라이선스, 스타 75개, 주석 달린 PGN과 HTML 보드를 출력, 작성자는 전체 실행에 약 한 시간이 걸린다고 함 |
| [yongqyu/claude-chess](https://github.com/yongqyu/claude-chess) | 터미널에서 Claude와 대국, 매 수 코멘트와 저장되는 대국 리뷰 | 없음: README에 Stockfish가 필요 없다고 적혀 있음 | 스타 5개, 리뷰에 Claude가 직접 매긴 "추정 ELO"가 포함됨 |

첫 번째 프로젝트가 저희가 찾은 클로드 코드 체스 스킬 중 가장 완성도가 높아요. README도 장단점을 솔직하게 적어 둬요. 시간이 걸리고, 깊이 생각하며 둔 느린 대국에 맞고, Claude가 쓴 내용을 Stockfish로 확인한다고요. 두 번째는 재미있는 연습 상대지만, 엔진이 없어서 수 평가는 Claude 자신의 판단이고 [클로드 체스](/answers/can-claude-play-chess/)에서 설명한 한계가 그대로 있어요.

둘 중 무엇이든 설치하기 전에 [스킬 개요](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)에 있는 Anthropic의 보안 안내를 읽으세요. 믿을 수 있는 출처의 스킬만 쓰고 모든 파일을 확인하라는 내용이에요. 스킬이 Claude에게 코드를 실행하라고 지시할 수 있기 때문이에요. 먼저 `SKILL.md`와 스크립트를 열어 보세요. 10분이면 돼요.

## 체스 스킬에 엔진이 필요한 이유: 예시 하나

언어 모델은 계산이 아니라 패턴으로 포지션을 판단해요. 수 하나가 모든 걸 바꾸기 전까지는 잘 통하죠. 입문자가 아주 자주 걸리는 함정의 포지션이에요. 백의 퀸과 비숍이 둘 다 흑 킹 옆의 폰을 노리고 있어요.

> **흑 차례. 나이트 수가 활발해 보이지만 바로 져요.**
> Position (FEN): `r1bqkbnr/pppp1ppp/2n5/4p2Q/2B1P3/8/PPPP1PPP/RNB1K1NR b KQkq - 3 3`
> Played: Nf6 — 나이트 f6로 퀸과 e4 폰을 공격
> Better: g6 — 폰 g6로 퀸을 공격하고 대략 균형 유지

나이트 수는 훌륭해 보여요. 퀸과 폰을 동시에 공격하는 이중 공격이니까요. 하지만 흑 킹 옆의 폰을 킹 혼자 지키게 남겨 두고, Stockfish는 1수 메이트를 찾아요. 퀸이 그 폰을 잡는 거예요. 엔진의 1순위는 대신 폰 수인데, 퀸을 공격하면서 대국을 대략 균형으로 유지해요.

기억에 의존해 쓰는 모델은 나이트 수를 칭찬할 수도 있어요. "나이트를 전개하면서 퀸을 공격한다"는 말이 좋은 조언처럼 들리니까요. 엔진은 1수 메이트를 절대 놓치지 않아요. 그래서 위의 포스트모템 스킬처럼 더 나은 체스 스킬은 설명은 Claude에게, 무엇이 맞는지는 Stockfish에게 맡겨요. 모델이 혼자서 어떻게 두는지 큰 그림은 [LLM 체스 벤치마크](/data/llm-chess-benchmark/) 페이지에서 볼 수 있어요.

## 클로드 코드에서 체스 커넥터 쓰는 법

Stockfish를 설치하지 않고 엔진으로 검증한 리뷰를 원한다면 원격 커넥터가 더 빠른 길이에요. Chess Coach도 그중 하나로, OAuth 로그인을 쓰는 원격 MCP 서버예요. Anthropic의 [클로드 코드 MCP 문서](https://code.claude.com/docs/en/mcp)(2026년 10월 26일 확인)에 따르면 이런 서버에 닿는 문서화된 방법은 두 가지예요.

1. **claude.ai를 통해.** claude.ai에 사용자 커넥터로 추가하고 거기서 로그인하세요. 같은 claude.ai 계정으로 클로드 코드에 로그인하면 claude.ai 커넥터가 클로드 코드에 자동으로 나타난다고 문서에 적혀 있어요. `/mcp`를 실행해서 확인하세요.
2. **클로드 코드에서 직접.** 문서의 문법에 서버 이름(원하는 대로)과 URL을 넣고, `/mcp`를 실행해 로그인하세요.

```
claude mcp add --transport http chess-coach https://chess-coach-246271308938.europe-west1.run.app/mcp
```

솔직하게 두 가지를 말씀드릴게요. 첫째, Chess Coach는 Claude와 ChatGPT 앱용으로 만들고 테스트했고, 클로드 코드용으로 따로 만든 건 아니에요. 둘째, 인터랙티브 보드는 MCP App, 즉 호스트 앱이 그려 주는 페이지예요. 클로드 코드 MCP 문서는 이를 호스트 애플리케이션이 렌더링하는 페이지로 설명하고, 터미널이 보여 준다고는 하지 않아요. 그러니 클로드 코드에서는 클릭할 수 있는 보드가 아니라 텍스트로 된 리뷰를 예상하세요.

## 나만의 클로드 코드 체스 스킬 만들기

직접 만들고 싶다면 형식은 작아요. [클로드 코드 스킬 문서](https://code.claude.com/docs/en/skills)를 따르면 이래요.

1. **폴더를 만드세요.** `~/.claude/skills/chess-review/`(개인용) 또는 `.claude/skills/chess-review/`(프로젝트 하나용)처럼요.
2. **`SKILL.md`를 쓰세요.** 스킬이 무엇을 하고 언제 쓰는지 설명을 넣어요. 예: "끝난 체스 대국을 리뷰한다. 사용자가 PGN, 리체스나 체스닷컴 링크를 공유하거나 왜 졌는지 물을 때 사용한다."
3. **지시문을 쓰세요.** 평범한 마크다운으로, 어떤 도구나 스크립트가 사실을 주는지, 플레이어 수준에 맞게 실수를 어떻게 설명할지, 절대 하지 말아야 할 일은 무엇인지 적어요.
4. **사실을 어디서 가져올지 정하세요.** 내 컴퓨터에서 Stockfish를 돌리는 스크립트를 넣거나, Claude에게 커넥터 도구(예: Chess Coach의 `review_game`과 `show_board`)를 부르라고 시켜요.
5. **테스트하세요.** 설명과 맞아야 하는 요청을 해 보고, Claude가 스킬을 집어 들지 않으면 문구를 고쳐요.

## 클로드 체스 스킬에서 흔한 실수

- **엔진 없는 스킬을 믿기.** 폴더 안에 Stockfish를 돌리거나 커넥터를 부르는 게 없다면, 모든 평가는 Claude의 추측이에요.
- **모호한 설명.** "체스 도우미"로는 거의 작동하지 않아요. PGN, 대국 링크, "왜 졌지" 같은 상황을 적으세요.
- **읽지 않고 설치하기.** 스킬은 코드를 실행할 수 있어요. Anthropic이 권하는 대로 확인하세요.
- **스킬이 어디서나 따라올 거라 기대하기.** 클로드 코드의 스킬은 claude.ai에도 올리기 전까지는 claude.ai에 없어요.
- **대국 중에 쓰기.** 리뷰는 끝난 대국용이에요. Chess Coach는 진행 중인 대국은 돕지 않고, 어떤 체스 스킬을 설치하든 같은 규칙을 지켜야 해요.

## Chess Coach의 자리

Chess Coach는 스킬이 아니에요. 인터랙티브 보드가 있는 원격 MCP 서버, 즉 Claude와 ChatGPT용 커넥터예요. 끝난 체스닷컴·리체스 대국을 (아이디, 대국 링크, 붙여 넣은 PGN으로) 찾아서 저희 서버의 Stockfish로 분석하고, 어시스턴트가 핵심 장면을 쉬운 말로 설명하게 해 줘요. 내가 둔 수는 빨간 화살표, 더 나은 수는 초록 화살표로 보여 줘요. 수를 넘겨 보고, 내 수를 직접 두어 보고, 실수를 연습할 수 있어요. 진행 중인 대국은 절대 돕지 않아요. 무료 플랜에는 하루 한 번의 심층 리뷰가 포함돼요. [Claude나 ChatGPT에 연결하기](/connect/), [문서](/docs.html)를 보거나, [Stockfish MCP](/answers/stockfish-mcp-server/)에서 로컬 엔진과 비교해 보세요.

## FAQ

### 공식 클로드 체스 스킬이 있나요?

아니요. 2026년 10월 26일 기준으로 Anthropic이 미리 만들어 둔 스킬은 PowerPoint, Excel, Word, PDF용이고, 오픈소스 [스킬 저장소](https://github.com/anthropics/skills)에도 체스 스킬은 없어요. 찾을 수 있는 체스 스킬은 깃허브의 커뮤니티 프로젝트예요.

### 클로드 스킬과 MCP 커넥터는 뭐가 다른가요?

스킬은 지시문을 담은 폴더(SKILL.md 파일과 선택적인 스크립트)이고, 요청이 맞아떨어질 때 Claude가 읽어요. MCP 커넥터는 Claude가 호출할 수 있는 도구를 주는 서버로, 로그인해서 쓰는 원격 서버인 경우가 많아요. 체스 스킬은 Claude에게 일하는 방식을 알려 주고, 체스 커넥터는 엔진과 내 대국을 건네줘요.

### 클로드 코드로 체스를 할 수 있나요?

네. 클로드 코드는 ~/.claude/skills/ 또는 .claude/skills/에 둔 사용자 스킬을 지원하고, Anthropic 문서에 따르면 OAuth 로그인을 쓰는 원격 HTTP MCP 서버도 지원해요. 커뮤니티 체스 스킬은 내 컴퓨터에서 Stockfish를 돌리고, 원격 커넥터는 자기 서버에서 엔진을 돌려요.

### Chess Coach는 클로드 스킬인가요?

아니요. Chess Coach는 Claude와 ChatGPT용 원격 MCP 커넥터예요. 끝난 체스닷컴·리체스 대국을 저희 서버의 Stockfish로 분석하고, Claude와 ChatGPT 앱 안의 인터랙티브 보드에 보여 줘요.

### 깃허브의 체스 스킬은 설치해도 안전한가요?

다운로드하는 다른 소프트웨어처럼 다루세요. 스킬은 Claude가 코드를 실행하게 만들 수 있어서, Anthropic은 믿을 수 있는 출처의 스킬만 쓰고 모든 파일을 확인하라고 권해요. 폴더를 복사하기 전에 SKILL.md와 스크립트를 읽어 보세요.

## Related

- [클로드 MCP 서버로 체스 분석: Chess Coach 커넥터](https://thechesscoach.netlify.app/ko/connect.md)
- [Stockfish MCP: Claude에게 진짜 체스 엔진을](https://thechesscoach.netlify.app/ko/answers/stockfish-mcp.md)
- [클로드 체스 분석, 가능할까? Stockfish와 함께라면 가능해요](https://thechesscoach.netlify.app/ko/answers/claude-chess-analysis.md)
- [AI랑 체스 두기: 클로드와 대국하는 방법 (2026)](https://thechesscoach.netlify.app/ko/guides/play-chess-with-claude.md)
- [LLM chess benchmark: 4 public leaderboards (Oct 2026)](https://thechesscoach.netlify.app/data/llm-chess-benchmark.md)