Открытый набор навыков для Claude Code превращает шахматную партию в аннотированный файл PGN и HTML-доску с анализом. Автор также описывает способ создать видео с закадровым текстом. Stockfish оценивает позиции; Claude Code задаёт уточняющие вопросы и пишет объяснения для игрока. репозиторий содержит пример одной разобранной партии и скрипты, лежащие в основе процесса. BIG CHANGE изучил документацию и код в коммите 46919038, датированном 26 сентября 2026 года; мы не запускали процесс и сами не оценивали шахматные рекомендации.

Главное изменение

  • Что изменилось: этот небольшой открытый проект описывает процесс, который связывает проверки позиций шахматным движком с разбором собственной партии игрока и, если они предоставлены, с его записанными рассуждениями.
  • Почему это важно: Игрок может отдельно изучить PGN, полный прогон анализа движка, сохранённые запросы и аннотации. Так созданное моделью объяснение проще поставить под сомнение применительно к конкретной позиции. Здесь не измерялось, помогает ли такой способ улучшать игру.
  • За чем следить: Модель по-прежнему выбирает вопросы, интерпретирует варианты движка и формулирует урок. Проверяющий агент на основе инструкций проверяет эту работу, но само его наличие не доказывает точность. Читателю, который решит использовать разбор для занятий, следует сверить указанные позиции и варианты.

От записи партии к кандидатам на ошибки

На вход подаётся партия в формате PGN — непосредственно или по ссылке на игру. Сначала навык chess-analysis определяет уровень игрока, чтобы подобрать подходящие ему комментарии. Можно добавить письменные заметки. Для записи рассуждений вслух в документации описан локальный процесс транскрибирования с помощью whisper.cpp и привязки речи к ходам по комментариям о времени на часах в PGN. Эта привязка требует пригодных данных о времени и возможности сопоставить устные упоминания с ходами; восстановить мысли игрока только по PGN она не позволяет.

Первый механический проход описан в скрипте sweep.py. Он просит Stockfish оценить позицию до и после каждого сделанного хода, записывает кандидатные ходы и оценки и отмечает ход, если измеренная потеря достигает установленного в скрипте порога в 30 сантипешек. Документированная глубина поиска по умолчанию — 22. Такие оценки помогают выбрать позиции для подробного разбора, но сами по себе не объясняют ошибку.

Затем навык поручает исследователю на Claude Code изучить каждую отмеченную позицию. Его скрипт query.py может запрашивать Stockfish о других ходах, включая поиск с ограничением на предложенный ход, и сохранять полученные варианты в JSON. Отдельные инструкции предписывают исследователю изучать изображения доски и объяснять, почему ход или альтернатива работают. Заметки игрока следует учитывать в объяснении только там, где они относятся к соответствующему ходу. На этом этапе результат работы движка превращается в шахматный текст, написанный моделью, а вместе с оценочными суждениями появляется и возможность ошибки.

Что именно проверяют и выдают инструменты

Репозиторий содержит навык chess-analysis, предусматривающий отдельную проверку готовых аннотаций агентом вместе с результатами полного анализа и заметками игрока. Контрольный список охватывает отмеченные ошибки, легальность вариантов, утверждения об оценках и высказывания о том, что думал игрок; оценки должны совпадать с полным анализом или сохранёнными запросами к движку. Далее выполняется файл build_annotated.py — скрипт также повторно разбирает PGN и сообщает об ошибках чтения. Это разные проверки: разбор подтверждает, что ходы можно прочитать, а проверяющий агент проводит ещё один анализ объяснений по инструкциям. Ни то ни другое не доказывает правильность каждой интерпретации. Автор пишет, что в личном использовании ошибки встречались редко, но не приводит независимого исследования точности.

Аннотированный PGN и build_viewer.py создают автономную HTML-доску с комментариями, графиком оценки и сохранёнными вариантами движка. Позже можно подключить ещё один необязательный chess-video — навык, который начинает работу с аннотированного PGN и полного анализа. Claude Code предлагает написать раскадровку, затем скрипты отображают доску, синтезируют закадровый текст и создают видео MP4 с субтитрами. В репозитории есть один пример на основе собственной быстрой партии автора, включая расшифровку, анализ, аннотации и видео длительностью 6 минут 49 секунд. Этот пример демонстрирует задуманные материалы, а не измеренный результат на выборке игроков или партий.

Предварительные требования, время и ограничения

В README указано, что нужно скопировать папки с навыками в личную или проектную директорию Claude Code, а затем передать ссылку на игру или PGN. Документация Claude Code подтверждает расположение этих директорий. Для анализа нужен Python с библиотеками python-chess и cairosvg, а также исполняемый файл Stockfish. Скрипт загрузки репозитория использует уже имеющуюся программу или скачивает сборку Stockfish 17.1 для Linux x86-64. На актуальной странице загрузки Stockfish указана версия 19, поэтому запасная загрузка в репозитории закреплена за более старым выпуском. Для необязательной обработки аудио нужны whisper.cpp и модель; в его документации описано преобразование аудио в WAV с глубиной 16 бит для whisper-cli. Для этапа видео также нужны Pillow, синтез речи Piper или espeak и FFmpeg. Эти способы и зависимости задокументированы; статья не является проверкой установки и не гарантирует совместимость с конкретным компьютером.

Автор оценивает обработку полного разбора и видео примерно в один час. В репозитории нет счёта за этот запуск. В актуальной таблице тарифов Anthropic указан Claude Code в плане Pro, а не Free; помесячная оплата Pro стоит $20, при оплате за год — в пересчёте $17 в месяц. На стоимость влияют время работы локального компьютера, подписка или использование API, а также настройка необязательных средств транскрибирования и видео. Время выполнения в примере и оценку точности следует рассматривать как рассказ одного пользователя.