Skills de Claude Code que analizan tus partidas de ajedrez con Stockfish

Un desarrollador ha publicado chess-postmortem-skills, una colección de skills para Claude Code que coge una partida de ajedrez y devuelve un análisis que se puede leer: explicaciones de los errores en lenguaje llano, verificadas contra Stockfish, y hasta un vídeo narrado con subtítulos incrustados. El repositorio ha llegado a la portada de Hacker News en el día de su publicación.

No es una web ni un motor. Son ficheros SKILL.md que Claude lee y ejecuta, y que sirven a la vez de documentación.

Tres skills, tres tareas

chess-analysis hace un barrido con Stockfish de cada jugada y después lanza subagentes "investigator" en paralelo que interrogan al motor con preguntas ingenuas del tipo "¿por qué no la jugada que hice?" o "¿y si las negras simplemente capturan?", y sigue preguntando hasta que el error queda explicado. La salida es un PGN anotado por capas, un tablero HTML autónomo y un "plan pause" con los planes de ambos bandos derivados del motor.

Esa skill también traga con una grabación de voz. En el ejemplo que acompaña al repositorio, el autor jugó una rápida 15+10 en lichess con blancas, siciliana abierta contra una Najdorf, nivel alrededor de 1700, y se grabó pensando en voz alta en francés. Claude transcribe el audio en local con whisper.cpp y alinea cada frase con la jugada que se estaba decidiendo, usando los tiempos de reloj del PGN. El vídeo resultante dura 6:49, va narrado en inglés con subtítulos y ocupa 10 MB.

chess-video monta ese vídeo a partir de un storyboard: tablero, flechas, indicador de evaluación, TTS con piper y subtítulos quemados, más un visor HTML interactivo. chess-play, la tercera, permite jugar contra Claude sobre ficheros PGN, con el tablero renderizado a PNG para que el modelo lo vea, y subagentes que buscan metidas de pata. Esa no usa motor.

Instalación y coste real

La instalación consiste en copiar o enlazar las carpetas de skills en .claude/skills/ del proyecto, o en ~/.claude/skills/ para tenerlas en todos. Los requisitos son un venv de Python con python-chess, cairosvg, pillow y piper-tts, más Stockfish —el script get_stockfish.sh respeta la variable $STOCKFISH o el binario del PATH y, si no hay ninguno, descarga el oficial de Linux—, ffmpeg y una voz de piper. whisper.cpp es opcional. Los ficheros de partidas viven en una carpeta chess-games/.

Claude Code puede instalar las dependencias por su cuenta si se lo pides. El nivel al que se dirige cada comentario se declara una vez en audience.level dentro de annotations.json, o en el propio CLAUDE.md del proyecto.

Hay un aviso de tiempo que conviene leer antes de lanzarlo: una ejecución completa, con barrido, investigaciones, anotaciones y vídeo, ronda una hora de proceso. No está pensado para revisar blitz, donde el análisis instantáneo de la plataforma ya sobra.

Sobre las alucinaciones, el autor asegura que cada afirmación se contrasta con Stockfish y que una pasada de verificación relee el resultado, por lo que en su experiencia los fallos son raros. Es su experiencia, no una garantía, y él mismo invita a pedirle a Claude que reconsulte una posición cuando algo no cuadre.

Lo interesante para quien trabaja con agentes no es el ajedrez, sino el patrón: skills que envuelven una herramienta determinista, subagentes que la interrogan hasta obtener una respuesta comprensible y una pasada final que revisa lo escrito. Ese esqueleto se puede portar a cualquier dominio donde haya un verificador externo al que agarrarse, y el hilo de Hacker News tiene unas cuantas discusiones sobre hasta dónde aguanta.