Edição Markdown

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

# Uma skill de xadrez para o Claude Code combina a análise do Stockfish com as notas do jogador

> Uma coleção pública de skills para o Claude Code combina avaliações do Stockfish, notas do jogador e explicações geradas pelo modelo numa análise pós-jogo que pode ser revista. Descrevemos o fluxo documentado e os seus limites.

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.

Uma coleção pública de skills para o Claude Code transforma uma partida de xadrez num PGN anotado e num tabuleiro de análise em HTML. O autor disponibiliza também um fluxo de trabalho para criar um vídeo narrado. O Stockfish avalia as posições; o Claude Code faz perguntas de seguimento e redige explicações para o jogador. O [repositório](https://github.com/brumar/chess-postmortem-skills) fornece uma partida analisada como exemplo e os scripts que sustentam o processo. A BIG CHANGE analisou a documentação e o código na versão do commit `46919038`, de 26 de setembro de 2026; não executámos o fluxo de trabalho nem avaliámos por conta própria o aconselhamento de xadrez.

## A grande mudança

- **O que mudou:** Este pequeno projeto público documenta um fluxo de trabalho que liga as avaliações de posições por um motor de xadrez a explicações adaptadas à partida do próprio jogador e, quando este as fornece, ao raciocínio que anotou.
- **Por que isso importa:** O jogador pode inspecionar separadamente o PGN, a análise do motor, as linhas consultadas e guardadas e as respetivas notas. Assim, pode questionar uma explicação no contexto da posição que esta descreve. Não se avaliou se este processo ajuda alguém a melhorar.
- **O que acompanhar:** O modelo continua a escolher as perguntas, a interpretar as linhas do motor e a redigir a lição. Um verificador baseado em prompts analisa esse trabalho, mas a sua existência não comprova que esteja correto. Quem decidir estudar a partir do resultado deve rever as posições e linhas citadas.

## Do registro da partida a possíveis erros

A entrada é uma partida em PGN, fornecida diretamente ou obtida por um link de jogo. A habilidade `chess-analysis` define primeiro o nível do leitor para adequar os comentários ao jogador. Também é possível acrescentar notas escritas. Para uma gravação em que a pessoa explica o seu raciocínio em voz alta, o fluxo documentado utiliza a transcrição local com whisper.cpp e alinha a fala com os lances através de comentários temporizados no PGN. Esse alinhamento depende de dados de relógio utilizáveis e da correspondência entre as referências faladas e os lances; não recupera, por si só, os pensamentos do jogador a partir de um PGN.

A primeira análise mecânica aparece em [`sweep.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/sweep.py). O script pede ao Stockfish que avalie a posição antes e depois de cada lance jogado, regista lances candidatos e respetivas pontuações, e assinala um lance quando a perda medida atinge o limiar de 30 centipawns definido no script. A profundidade de pesquisa predefinida é 22. Estas avaliações identificam posições para uma análise mais aprofundada; os números, por si só, não explicam um erro.

Em seguida, a skill instrui um agente investigador do Claude Code a examinar cada posição assinalada. O [`query.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/query.py) pode consultar o Stockfish sobre lances alternativos, incluindo pesquisas limitadas a um lance proposto, e guardar as linhas resultantes em JSON. Instruções separadas pedem ao investigador que examine imagens do tabuleiro e explique por que razão um lance ou alternativa funciona. As notas do jogador só podem contribuir para uma explicação quando dizem respeito àquele lance. É nesta fase que a saída do motor se transforma em texto de xadrez redigido pelo modelo, sujeito a julgamento e a possíveis erros.

## O que as verificações e os resultados demonstram

A habilidade `chess-analysis` do repositório pede a um agente verificador separado que reveja as anotações finais juntamente com a análise e as notas do jogador. A lista de verificação abrange erros assinalados, variantes legais, afirmações sobre avaliações e declarações sobre o que o jogador pensou; as avaliações devem corresponder à análise ou às consultas guardadas ao motor. O ficheiro [`build_annotated.py` é o script que](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py) também volta a analisar o PGN e assinala erros de leitura. São verificações distintas: a análise confirma que os lances podem ser lidos, enquanto o verificador faz uma segunda revisão das explicações orientada por modelo. Nenhuma delas demonstra que todas as interpretações estejam corretas. O autor afirma que os erros foram raros na sua experiência pessoal, mas não apresenta um estudo independente de erros.

O PGN anotado salvo e [`build_viewer.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_viewer.py) geram um tabuleiro HTML independente, com comentários, um gráfico de avaliação e linhas do motor guardadas em cache. Uma skill opcional posterior, chamada [`chess-video`,](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md), começa com o PGN anotado e a análise. Pede ao Claude Code que redija um guião visual; depois, os scripts renderizam o tabuleiro, sintetizam a narração e criam um MP4 com legendas. O repositório inclui um exemplo baseado numa partida rápida do próprio autor, com transcrição, análise, anotações e um vídeo com 6 minutos e 49 segundos. O exemplo mostra os artefactos previstos, não resultados medidos em vários jogadores ou partidas.

## Pré-requisitos, duração e limites

O [README](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) recomenda copiar as pastas de skills para a pasta pessoal ou para a pasta do projeto do Claude Code e, depois, fornecer uma ligação para uma partida ou um PGN. A [documentação do próprio Claude Code](https://code.claude.com/docs/en/skills) confirma estes locais para as skills. A análise requer Python com `python-chess` e `cairosvg`, além de um executável do Stockfish. O script de instalação do repositório reutiliza um executável existente quando disponível ou baixa uma versão Linux x86-64 do Stockfish 17.1. A [página oficial de downloads do Stockfish](https://stockfishchess.org/download/) lista a versão 19; por conseguinte, o script de instalação do repositório está fixado numa versão mais antiga. O áudio opcional requer whisper.cpp e um modelo; a respetiva [documentação](https://github.com/ggml-org/whisper.cpp) descreve a conversão do áudio para WAV de 16 bits para `whisper-cli`. A etapa de vídeo também requer Pillow, síntese de voz Piper ou espeak e FFmpeg. Esses fluxos e dependências estão documentados; este artigo não é um teste de instalação nem uma garantia de compatibilidade com um computador específico.

O autor estima que a análise completa e o vídeo demorem cerca de uma hora a processar. O repositório não indica o custo dessa execução. A [tabela de planos atual da Anthropic](https://claude.com/pricing) inclui o Claude Code no plano Pro, mas não no Free. O Pro custa 20 dólares norte-americanos por mês com faturação mensal e tem limites de utilização. O tempo de computação local, qualquer assinatura ou utilização da API e a configuração opcional de transcrição e vídeo fazem com que o custo dependa do ambiente do leitor. A duração do exemplo e a avaliação de precisão do autor devem ser entendidas como o relato de um único utilizador.

## Sources

- [brumar/chess-postmortem-skills, README no commit 46919038](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — Relato do autor sobre a partida, os dados de entrada, os resultados do exemplo, a instalação, os pré-requisitos e o processamento de cerca de uma hora. A avaliação pessoal do autor sobre os erros e a duração não constitui uma medição independente.
- [Skill de análise de xadrez e lista de verificação do agente verificador](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/SKILL.md) — Descreve a entrada em PGN, as opções de notas ou áudio, a análise do Stockfish, as consultas do investigador, a criação das anotações, o verificador orientado por modelo e a saída em HTML. A lista de verificação está no ficheiro de referências style.md; instruções escritas não comprovam que todas as revisões estejam corretas.
- [Scripts de análise de xadrez: análise, consultas, criação de anotações e visualizador](https://github.com/brumar/chess-postmortem-skills/tree/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts) — O código define a profundidade e o limiar de perda predefinidos, consultas restritas ao Stockfish com linhas guardadas, a nova análise do PGN e a criação do HTML. Inspecionar o código não equivale a executar o programa nem a avaliar a sua qualidade.
- [Habilidade de vídeo de xadrez e script de renderização](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) — Documenta o guião visual opcional, a narração, o MP4, as legendas e a fase de HTML, com pré-requisitos de vídeo separados. A BIG CHANGE não gerou vídeos.
- [Documentação do Claude Code: skills](https://code.claude.com/docs/en/skills) — Confirma os locais pessoais e do projeto para as pastas de skills. Não valida a compatibilidade do projeto de terceiros entre versões.
- [Downloads oficiais do Stockfish](https://stockfishchess.org/download/) — Lista o Stockfish 19 e as transferências por plataforma. O script de instalação do projeto inspecionado está fixado no Stockfish 17.1 para Linux x86-64.
- [Repositório oficial do whisper.cpp](https://github.com/ggml-org/whisper.cpp) — Documenta o whisper-cli e a conversão da entrada para WAV de 16 bits. A transcrição e o alinhamento do áudio com os lances são partes opcionais do projeto e não foram testados aqui.
- [Preços do Claude da Anthropic](https://claude.com/pricing) — A tabela de planos individuais inclui o Claude Code no Pro, mas não no Free, e indica o custo de 20 dólares norte-americanos por mês, ou um valor equivalente a 17 dólares por mês com faturação anual. Aplicam-se limites de utilização e eventuais alterações de preço; o projeto de xadrez não informa o custo de cada execução.