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