Un conjunto público de habilidades de Claude Code convierte una partida de ajedrez en un PGN anotado y un tablero de análisis HTML. El autor también ofrece una vía para generar un video narrado. Stockfish evalúa las posiciones; Claude Code formula preguntas de seguimiento y redacta explicaciones para el jugador. El repositorio contiene una partida de ejemplo y los scripts que implementan ese proceso. BIG CHANGE examinó la documentación y el código del commit 46919038, fechado el 26 de septiembre de 2026; no ejecutamos el flujo ni evaluamos por nuestra cuenta los consejos ajedrecísticos.

El gran cambio

  • Qué cambió: Este pequeño proyecto público documenta un flujo que conecta las comprobaciones de posiciones de un motor con explicaciones basadas en la propia partida de quien juega y, si se proporcionan, en sus razonamientos registrados.
  • Por qué importa: Quien juega puede inspeccionar por separado el PGN, el análisis exhaustivo del motor, las consultas guardadas y las anotaciones. Así es más fácil cuestionar una explicación generada en la posición concreta a la que se refiere. Aquí no se midió si ayuda a mejorar el juego.
  • Qué conviene observar: El modelo sigue eligiendo las preguntas, interpretando las variantes del motor y redactando la lección. Un verificador guiado por instrucciones revisa ese trabajo, pero su presencia no demuestra que sea preciso. Quien quiera estudiar con el resultado debería revisar las posiciones y variantes citadas.

Del registro de una partida a los errores posibles

La entrada es una partida en formato PGN, que se puede proporcionar directamente u obtener mediante un enlace. La habilidad chess-analysis determina primero el nivel del lector para adaptar los comentarios. También se pueden añadir notas escritas. Para una grabación en la que el jugador explica su razonamiento en voz alta, el flujo documentado usa whisper.cpp local para transcribir y alinea el habla con las jugadas mediante los comentarios de reloj del PGN. Esa alineación requiere datos de reloj utilizables y referencias habladas que puedan asociarse a las jugadas; no permite recuperar los pensamientos de una persona a partir del PGN por sí solo.

La primera pasada mecánica se encuentra en sweep.py. Allí Stockfish evalúa la posición antes y después de cada jugada, registra las jugadas candidatas y sus puntuaciones, y marca una jugada cuando la pérdida medida alcanza el valor predeterminado de 30 centipeones del script. La profundidad de búsqueda predeterminada documentada es 22. Estas evaluaciones señalan posiciones que conviene inspeccionar; sus cifras no explican por sí solas un error.

La habilidad dirige entonces a un investigador de Claude Code para que examine cada posición marcada. Su query.py consulta a Stockfish sobre jugadas alternativas, incluida una búsqueda limitada a una jugada propuesta, y guarda las variantes resultantes en JSON. Otras instrucciones piden al investigador que examine imágenes del tablero y explique por qué funciona una jugada o una alternativa. Las notas del jugador solo deben influir en una explicación cuando correspondan a esa jugada. En este punto, el resultado del motor se convierte en prosa ajedrecística redactada por el modelo, con el juicio y los posibles errores que eso implica.

Qué establecen las comprobaciones y los resultados

La habilidad chess-analysis pide a un agente verificador independiente que revise las anotaciones terminadas junto con el análisis y las notas del jugador. Su lista de comprobación abarca los errores marcados, las variantes legales, las afirmaciones sobre evaluaciones y las referencias a lo que pensó el jugador; las evaluaciones deben coincidir con el análisis o con las consultas guardadas al motor. El script build_annotated.py también vuelve a procesar el PGN e informa de los errores de lectura. Son comprobaciones distintas: el análisis sintáctico confirma que las jugadas se pueden leer, mientras que el verificador realiza otra revisión de las explicaciones guiada por un modelo. Ninguna demuestra que todas las interpretaciones sean correctas. El autor afirma que en su uso personal ha habido pocos errores, pero no aporta un estudio independiente sobre la tasa de error.

El PGN anotado y build_viewer.py generan un tablero HTML independiente con comentarios, un gráfico de evaluación y variantes del motor guardadas en caché. Más adelante se puede usar la habilidad opcional chess-video, que parte del PGN anotado y del análisis. Pide a Claude Code que prepare un guion gráfico y luego sus scripts renderizan el tablero, sintetizan la narración y crean un MP4 con subtítulos. El repositorio incluye un ejemplo basado en una partida rápida del autor, con transcripción, análisis, anotaciones y un video de 6 minutos y 49 segundos. Ese ejemplo muestra los resultados previstos; no mide el desempeño en distintas partidas o entre jugadores.

Requisitos, tiempo y límites

El README indica que hay que copiar las carpetas de las habilidades al directorio personal o al del proyecto de Claude Code y, después, proporcionar un enlace a la partida o un PGN. La documentación oficial de Claude Code confirma la ubicación de esos directorios. El análisis requiere Python con python-chess y cairosvg, además de un ejecutable de Stockfish. El script de descarga del repositorio usa un ejecutable existente si lo encuentra; de lo contrario, descarga una compilación de Stockfish 17.1 para Linux x86-64. La página actual de descargas de Stockfish enumera la versión 19, por lo que la alternativa del repositorio está fijada a una versión anterior. El audio opcional requiere whisper.cpp y un modelo; su documentación describe cómo convertir el audio a WAV de 16 bits para whisper-cli. La etapa de video también requiere Pillow, Piper o espeak para la conversión de texto a voz, y FFmpeg. Estas rutas y dependencias están documentadas; este artículo no prueba la instalación ni garantiza la compatibilidad con un equipo concreto.

El autor calcula que el procesamiento completo del análisis y del video tarda alrededor de una hora. El repositorio no indica cuánto costó esa ejecución. La tabla actual de precios de Anthropic incluye Claude Code en Pro, no en Free; Pro cuesta 20 $ al mes si se factura mensualmente y tiene límites de uso. El tiempo de cómputo local, las suscripciones o el uso de API, y la configuración opcional de transcripción y video hacen que el costo dependa del entorno de cada persona. El tiempo del ejemplo y la valoración que hace el autor de su precisión son experiencias individuales.