Edição em Markdown

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

# Uma habilidade do Claude Code para análise pós-jogo de xadrez combina Stockfish e anotações do jogador

> Um conjunto público de habilidades para Claude Code combina avaliações do Stockfish, anotações do jogador e explicações geradas pelo modelo em uma análise pós-jogo revisável. Descrevemos o fluxo documentado e 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.

Um conjunto público de habilidades para Claude Code transforma uma partida de xadrez em um PGN anotado e um tabuleiro de análise em HTML. O autor também oferece um fluxo para criar um vídeo narrado. O Stockfish avalia as posições; o Claude Code faz perguntas de acompanhamento e escreve explicações para o jogador. O [repositório](https://github.com/brumar/chess-postmortem-skills) fornece uma partida trabalhada como exemplo e os scripts por trás do processo. A BIG CHANGE inspecionou a documentação e o código no commit `46919038`, datado de 26 de setembro de 2026; não executamos o fluxo nem avaliamos por conta própria os conselhos de xadrez.

## A grande mudança

- **O que mudou:** Este pequeno projeto público documenta um fluxo que conecta verificações de posições por um mecanismo de xadrez a explicações voltadas à própria partida do jogador e, quando fornecido, ao raciocínio que ele registrou.
- **Por que isso importa:** O jogador pode inspecionar separadamente o PGN, a análise do mecanismo, as linhas consultadas e salvas e as anotações. Isso facilita questionar uma explicação gerada na posição que ela descreve. Não se mediu aqui se o processo ajuda alguém a melhorar.
- **O que acompanhar:** O modelo ainda escolhe as perguntas, interpreta as linhas do mecanismo e escreve a lição. O verificador baseado em prompts examina esse trabalho, mas sua existência não comprova a precisão. Quem decidir estudar com o resultado deve revisar 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 que os comentários sejam adequados àquele jogador. Também é possível adicionar anotações escritas. Para uma gravação em que a pessoa explica seu raciocínio em voz alta, o fluxo documentado usa a transcrição local do whisper.cpp e alinha a fala aos lances por meio de comentários com o relógio no PGN. Esse alinhamento depende de dados de relógio utilizáveis e da correspondência entre referências faladas e 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, registra lances candidatos e suas pontuações e sinaliza um lance quando a perda medida atinge o padrão de 30 centipawns do script. A profundidade de busca padrão documentada é 22. Essas avaliações localizam posições para análise mais detalhada; os números, por si só, não explicam um erro.

Em seguida, a habilidade orienta um investigador do Claude Code a examinar cada posição sinalizada. Seu [`query.py`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/query.py) pode consultar o Stockfish sobre lances alternativos, inclusive com uma busca restrita a um lance proposto, e salvar as linhas resultantes em JSON. Instruções separadas pedem ao investigador que examine imagens do tabuleiro e explique por que um lance ou alternativa funciona. As anotações do jogador só podem informar uma explicação quando correspondem àquele lance. É nessa etapa que a saída do mecanismo se transforma em texto de xadrez escrito pelo modelo, com espaço para julgamento e possíveis erros.

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

A habilidade `chess-analysis` do repositório pede que um agente verificador separado revise as anotações prontas junto com a análise e as anotações do jogador. A lista de verificação abrange erros sinalizados, variações 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 salvas ao mecanismo. O arquivo [`build_annotated.py` é o script que](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py) também analisa novamente o PGN e informa erros de leitura. São verificações distintas: a análise confirma que os lances podem ser lidos, enquanto o verificador faz outra revisão das explicações orientada por modelo. Nenhuma delas demonstra que toda interpretação esteja correta. O autor diz que erros foram raros em seu uso 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, gráfico de avaliação e linhas do mecanismo em cache. Uma habilidade 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. Ela pede ao Claude Code que escreva um roteiro visual; em seguida, seus scripts renderizam o tabuleiro, sintetizam a narração e criam um MP4 com legendas. O repositório inclui um exemplo baseado em uma partida rápida do próprio autor, com transcrição, análise, anotações e um vídeo de 6 minutos e 49 segundos. O exemplo mostra os artefatos previstos, não um resultado medido entre vários jogadores ou partidas.

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

O [README](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) diz para copiar as pastas de habilidades para o diretório pessoal ou do projeto do Claude Code e, depois, fornecer um link de partida ou um PGN. A [documentação do próprio Claude Code](https://code.claude.com/docs/en/skills) confirma esses locais para habilidades. A análise precisa de 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; portanto, o script reserva do repositório está fixado em uma versão mais antiga. O áudio opcional requer whisper.cpp e um modelo; sua [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 cerca de uma hora de processamento para a análise completa e o vídeo. O repositório não informa o custo daquela execução. A [tabela de planos atual da Anthropic](https://claude.com/pricing) lista o Claude Code no plano Pro, não no Free; o Pro custa US$ 20 por mês quando cobrado mensalmente e tem limites de uso. O tempo de computação local, qualquer assinatura ou uso de API e a configuração opcional de transcrição e vídeo fazem o custo depender 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 usuário.

## 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 aproximadamente uma hora. Sua avaliação pessoal sobre erros e a duração não são medições independentes.
- [Habilidade 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 de PGN e 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 HTML. A lista de verificação está no arquivo de referências/style.md; instruções escritas não comprovam que todas as revisões sejam 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 estabelece a profundidade e o limite de perda padrão, consultas restritas ao Stockfish com linhas salvas, nova análise do PGN e criação do HTML. Inspecionar o código não é um teste de execução nem uma avaliação de 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 roteiro visual opcional, a narração, o MP4, as legendas e a etapa HTML, com pré-requisitos de vídeo separados. A BIG CHANGE não gerou vídeos.
- [Documentação do Claude Code: habilidades](https://code.claude.com/docs/en/skills) — Confirma os locais pessoais e do projeto para as pastas de habilidades. 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 os downloads por plataforma. O script reserva 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 whisper-cli e a conversão de entrada para WAV de 16 bits. A transcrição e o alinhamento de áudio aos 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 lista o Claude Code no Pro, não no Free, e informa US$ 20 por mês ou valor equivalente a US$ 17 mensais com cobrança anual. Aplicam-se limites de uso e eventuais alterações de preço; o projeto de xadrez não informa o custo por execução.