ChessGuardian Skill#

Interact with ChessGuardian — a live chess platform with Stockfish AI.

Configuration#

Set the base URL in the environment or default to:

text

CHESSGUARDIAN_URL=https://chessguardian-production.up.railway.app

API Endpoints#

Start a new game#

text

POST /api/live/start
Body: {"mode": "ai"} or {"mode": "pvp"}
Returns: {id, fen, history, lastMove}

Get game state#

text

GET /api/live/<game_id>
Returns: {id, fen, history, status, turn, winChance, gameOver}

Make a move#

text

POST /api/live/<game_id>/move
Body: {"move": "e5"} (SAN or UCI format)
Returns: {fen, history, stockfishMove, analysis, gameOver, status}

Get QR code#

text

GET /api/live/<game_id>/qr
Returns: PNG image

Workflows#

Start a game and send QR code#

1. POST /api/live/start with {"mode": "ai"}
2. GET /api/live/<id>/qr → save to outbound media
3. Send QR image + live link to user

Make a move for the user#

1. POST /api/live/<id>/move with the move in SAN (e.g. "e5", "Nf6", "O-O")
2. Show the AI analysis and Stockfish's reply
3. Optionally render the board snapshot

Run autoplay bot#

Execute the bundled scripts:

• Stockfish bot: python3 -u scripts/autoplay_stockfish.py <game_id|new> --depth 20 --delay 5
• Minimax bot: python3 -u scripts/autoplay_minimax.py <game_id|new> --depth 4 --delay 5

Both scripts support new to auto-start a game. Use -u for unbuffered output.

Render board snapshot#

1. Generate an HTML file using chessboard.js with the FEN from game state
2. Screenshot with Playwright: npx playwright screenshot --browser chromium --viewport-size=440,520 board.html output.png
3. Send the image to user

Dependencies#

• Python 3 with chess and requests packages
• Stockfish binary (for autoplay_stockfish.py)
• Playwright + Chromium (for board screenshots)
• curl or equivalent for API calls

Live page#

Users can watch games in browser at: <base_url>/live/<game_id>