Edición en Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Una habilidad de Claude Code para ajedrez combina el análisis de Stockfish con las notas del jugador

> Un conjunto público de habilidades de Claude Code combina evaluaciones de Stockfish, notas del jugador y explicaciones redactadas por un modelo en un análisis retrospectivo de ajedrez que puede revisarse. Aquí describimos el flujo documentado y sus límites.

By BIG CHANGE Editorial

Published: 2026-09-26T20:57:48.171Z
Updated: 2026-09-26T20:57:48.171Z
Canonical: https://bigchange.ai/blog/claude-code-chess-stockfish-postmortem-skill

![A chess player studies a midgame position on a wooden chessboard beside an analog chess clock in a quiet club room.](https://bigchange.ai/api/media/file/chess-postmortem-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

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](https://github.com/brumar/chess-postmortem-skills) 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`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/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`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/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](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/build_annotated.py) 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`](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts/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](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) 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](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) 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](https://code.claude.com/docs/en/skills) 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](https://stockfishchess.org/download/) 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](https://github.com/ggml-org/whisper.cpp) 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](https://claude.com/pricing) 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.

## Sources

- [brumar/chess-postmortem-skills, archivo README del commit 46919038](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/README.md) — Relato del autor sobre la partida, los datos de entrada, los resultados de ejemplo, la instalación, los requisitos y el tiempo de procesamiento estimado de aproximadamente una hora. Su valoración personal de los errores y del tiempo no constituye una medición independiente.
- [Habilidad de análisis de ajedrez y lista de comprobación del verificador](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/SKILL.md) — Describe la entrada de PGN y las notas o el audio opcionales, el análisis de Stockfish, las consultas del investigador, la creación de anotaciones, la verificación guiada por un modelo y el resultado HTML. La lista de comprobación está en la referencia enlazada references/style.md; que existan instrucciones escritas no demuestra que todas las revisiones sean correctas.
- [Scripts de análisis de ajedrez: barrido, consultas, creación de anotaciones y visor](https://github.com/brumar/chess-postmortem-skills/tree/46919038bd849995522d9414b4781d3442940a3d/skills/chess-analysis/scripts) — El código establece la profundidad y el umbral de pérdida predeterminados, las consultas restringidas a Stockfish con variantes guardadas, el reprocesamiento del PGN y la generación del HTML. Inspeccionar el código fuente no equivale a ejecutar el flujo ni a evaluar su calidad.
- [Habilidad de video de ajedrez y script de renderizado](https://github.com/brumar/chess-postmortem-skills/blob/46919038bd849995522d9414b4781d3442940a3d/skills/chess-video/SKILL.md) — Documenta las etapas opcionales de guion gráfico, narración, MP4, subtítulos y HTML, así como sus requisitos de video específicos. BIG CHANGE no generó ningún video.
- [Documentación de Claude Code: habilidades](https://code.claude.com/docs/en/skills) — Confirma la ubicación de los directorios personal y del proyecto para las habilidades. No valida la compatibilidad de este proyecto de terceros entre distintas versiones.
- [Descargas oficiales de Stockfish](https://stockfishchess.org/download/) — Enumera Stockfish 19 y las descargas para distintas plataformas. El script de descarga alternativa del proyecto inspeccionado está fijado a Stockfish 17.1 para Linux x86-64.
- [Repositorio oficial de whisper.cpp](https://github.com/ggml-org/whisper.cpp) — Documenta whisper-cli y la conversión de entrada a WAV de 16 bits. La transcripción y la alineación del audio con las jugadas son funciones opcionales de este proyecto y no se probaron aquí.
- [Precios de Claude de Anthropic](https://claude.com/pricing) — La tabla de planes individuales incluye Claude Code en Pro, no en Free, y fija Pro en 20 $ al mes o el equivalente a 17 $ mensuales con facturación anual. Se aplican límites de uso y los precios pueden cambiar; el proyecto de ajedrez no informa el costo por ejecución.