How do I install the Chessguardian skill?

Run npx skillmds@latest add lord1egypt/chessguardian in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Chessguardian safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Chessguardian?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Chessguardian free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Chessguardian?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Chessguardian by lord1egypt — Agent Skill

Name: Chessguardian
Rating: 4.2 (5 reviews)
Author: Lord1Egypt

Chessguardian

Play chess via ChessGuardian API — start games, make moves, watch live games, run autoplay bots (Stockfish or Minimax), and get board snapshots. Use when the user wants to play chess, start a new chess game, make a chess move, view a live chess board, run an AI chess bot, get a QR code for a chess game, analyze a chess position, or any chess-related interaction. Requires a running ChessGuardian instance.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

ChessGuardian Skill

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

Configuration

Set the base URL in the environment or default to:

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

API Endpoints

Start a new game

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

Get game state

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

Make a move

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

Get QR code

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

Workflows

Start a game and send QR code

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

Make a move for the user

POST /api/live/<id>/move with the move in SAN (e.g. "e5", "Nf6", "O-O")
Show the AI analysis and Stockfish's reply
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

Generate an HTML file using chessboard.js with the FEN from game state
Screenshot with Playwright: npx playwright screenshot --browser chromium --viewport-size=440,520 board.html output.png
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>

---name: chessguardiandescription: Play chess via ChessGuardian API — start games, make moves, watch live games, run autoplay bots (Stockfish or Minimax), and get board snapshots. Use when the user wants to play chess, start a new chess game, make a chess move, view a live chess board, run an AI chess bot, get a QR code for a chess game, analyze a chess position, or any chess-related interaction. Requires a running ChessGuardian instance.---# ChessGuardian SkillInteract with ChessGuardian — a live chess platform with Stockfish AI.## ConfigurationSet the base URL in the environment or default to:```CHESSGUARDIAN_URL=https://chessguardian-production.up.railway.app```## API Endpoints### Start a new game```POST /api/live/startBody: {"mode": "ai"} or {"mode": "pvp"}Returns: {id, fen, history, lastMove}```### Get game state```GET /api/live/<game_id>Returns: {id, fen, history, status, turn, winChance, gameOver}```### Make a move```POST /api/live/<game_id>/moveBody: {"move": "e5"} (SAN or UCI format)Returns: {fen, history, stockfishMove, analysis, gameOver, status}```### Get QR code```GET /api/live/<game_id>/qrReturns: PNG image```## Workflows### Start a game and send QR code1. POST `/api/live/start` with `{"mode": "ai"}`2. GET `/api/live/<id>/qr` → save to outbound media3. Send QR image + live link to user### Make a move for the user1. POST `/api/live/<id>/move` with the move in SAN (e.g. "e5", "Nf6", "O-O")2. Show the AI analysis and Stockfish's reply3. Optionally render the board snapshot### Run autoplay botExecute 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 snapshot1. Generate an HTML file using chessboard.js with the FEN from game state2. 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 pageUsers can watch games in browser at: `<base_url>/live/<game_id>`

Frequently asked questions