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 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. 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 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 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 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,, 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 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 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 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 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 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.