Javni skup veština za Claude Code pretvara šahovsku partiju u anotirani PGN i HTML tablu za analizu. Autor nudi i postupak za izradu videa sa naracijom. Stockfish procenjuje pozicije, a Claude Code postavlja dodatna pitanja i piše objašnjenja za igrača. Repozitorijum sadrži primer obrađene partije i skripte koje pokreću taj postupak. BIG CHANGE je pregledao dokumentaciju i kod na reviziji 46919038, datiranoj 26. septembra 2026; nismo pokretali postupak niti sami procenjivali šahovske savete.

Suštinska promena

  • Šta se promenilo: Ovaj mali javni projekat opisuje postupak koji povezuje provere pozicija pomoću šahovskog engine-a sa objašnjenjima prilagođenim partiji konkretnog igrača i, kada ih dostavi, njegovim zabeleženim razmišljanjima.
  • Zašto je to važno: Igrač može zasebno da pregleda PGN, analizu engine-a kroz poteze, sačuvane upite i anotacije. Tako je lakše preispitati generisano objašnjenje na poziciji na koju se odnosi. Ovde nije mereno da li to pomaže igraču da napreduje.
  • Na šta treba obratiti pažnju: Model i dalje bira pitanja, tumači linije engine-a i piše lekciju. Provera zasnovana na promptu pregleda taj rad, ali njeno postojanje ne dokazuje da je rezultat tačan. Čitalac koji razmatra upotrebu rezultata za učenje treba da proveri navedene pozicije i linije.

Od zapisnika partije do mogućih grešaka

Ulaz je PGN partije, dostavljen direktno ili preuzet sa veze ka partiji. Veština chess-analysis najpre određuje nivo igrača kako bi prilagodila komentare. Mogu se dodati i pisane beleške. Za snimljeno razmišljanje naglas, dokumentovani postupak koristi lokalnu transkripciju pomoću whisper.cpp i povezuje govor sa potezima preko vremenskih komentara u PGN-u. To povezivanje zavisi od upotrebljivih podataka o vremenu i podudaranja izgovorenih referenci sa potezima; samo iz PGN-a nije moguće rekonstruisati misli igrača.

Prvi mehanički prolaz prikazan je u sweep.py skripti. Ona traži od Stockfish-a da proceni poziciju pre i posle svakog odigranog poteza, beleži kandidate za potez i njihove ocene i označava potez kada izmereni gubitak dostigne podrazumevanih 30 centipiona. Dokumentovana podrazumevana dubina pretrage je 22. Ove procene izdvajaju pozicije za detaljniji pregled; same brojčane vrednosti ne objašnjavaju grešku.

Veština zatim upućuje Claude Code istraživača da pregleda svaku označenu poziciju. Njegov query.py može da pita Stockfish o alternativnim potezima, uključujući pretragu ograničenu na predloženi potez, i da sačuva dobijene linije u JSON-u. Posebna uputstva nalažu istraživaču da pregleda slike table i objasni zašto potez ili alternativa funkcionišu. Beleške igrača mogu da posluže pri pisanju objašnjenja samo kada se odnose na taj potez. Tu se izlaz engine-a pretvara u tekst o šahu koji piše model, pa u rezultat ulazi i njegova procena, uz mogućnost greške.

Šta provere i izlazi potvrđuju

Veština chess-analysis zahteva da poseban agent za proveru pregleda završene anotacije zajedno sa analizom engine-a i beleškama igrača. Njena kontrolna lista obuhvata označene greške, legalne varijante, tvrdnje o procenama i navode o tome šta je igrač mislio; tvrdnje o proceni treba da odgovaraju analizi ili sačuvanim upitima engine-a. build_annotated.py skripta takođe ponovo parsira PGN i prijavljuje greške u parsiranju. To su različite provere: parsiranje potvrđuje da se potezi mogu pročitati, dok je provera još jedan pregled objašnjenja usmeren promptom. Nijedna ne potvrđuje da je svako tumačenje tačno. Autor kaže da su greške retke u njegovom ličnom iskustvu, ali ne pruža nezavisno istraživanje grešaka.

Sačuvani anotirani PGN i build_viewer.py daju samostalnu HTML tablu sa komentarima, grafikom procene i keširanim linijama engine-a. Kasnija, opciona chess-video veština polazi od anotiranog PGN-a i analize. Od Claude Code-a traži da napiše scenario, a zatim njene skripte prikazuju tablu, sintetizuju naraciju i prave MP4 sa titlovima. Repozitorijum sadrži jedan primer autorove brze partije, uključujući transkript, analizu, anotacije i video od 6 minuta i 49 sekundi. Taj primer prikazuje predviđene rezultate, ali ne i izmeren učinak na različitim igračima ili partijama.

Preduslovi, vreme i ograničenja

U README piše da fascikle sa veštinama treba kopirati u lični direktorijum veština za Claude Code ili u direktorijum projekta, a zatim uneti vezu do partije ili PGN-a. Dokumentacija samog Claude Code-a potvrđuje te lokacije. Za analizu su potrebni Python sa python-chess i cairosvg, uz izvršnu datoteku Stockfish-a. Skripta za preuzimanje u repozitorijumu koristi postojeću izvršnu datoteku ako je dostupna ili preuzima Linux x86-64 verziju Stockfish-a 17.1. Aktuelna stranica za preuzimanje Stockfish-a navodi verziju 19, tako da je rezervno preuzimanje u repozitorijumu vezano za stariju verziju. Za opcionu obradu zvuka potrebni su whisper.cpp i model; njegova dokumentacija opisuje pretvaranje zvuka u 16-bitni WAV za whisper-cli. Za video-fazu potrebni su i Pillow, Piper za pretvaranje teksta u govor ili espeak, kao i FFmpeg. Ovi postupci i zavisnosti dokumentovani su; članak ne sadrži test instalacije niti garanciju kompatibilnosti sa konkretnim računarom.

Autor procenjuje da je za kompletnu proveru i izradu videa potrebno oko sat vremena obrade. Repozitorijum ne navodi cenu tog pokretanja. Anthropic-ova aktuelna tabela planova navodi Claude Code u paketu Pro, a ne Free; Pro košta 20 dolara mesečno uz mesečno plaćanje i ima ograničenja korišćenja. Vreme lokalnog računara, eventualna pretplata ili korišćenje API-ja, kao i opciono podešavanje transkripcije i videa, određuju trošak u zavisnosti od okruženja čitaoca. Navedeno vreme i autorova ocena tačnosti odnose se na iskustvo jednog korisnika.