← Back to Skills Marketplace
248
Downloads
1
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install play-chess
Description
Play live chess as Black against the user on ChessWithClaw by connecting to their game invite and responding to their first move.
Usage Guidance
This skill appears coherent for playing live chess, but consider these points before installing:
- The AGENT_TOKEN extracted from the invite URL is an authentication secret — only use invites from sources you trust, and avoid sharing tokens elsewhere.
- The SKILL.md suggests running npx to install other components (agent-browser, etc.). Installing packages via npx will execute code from the package registry; only proceed if you trust those packages and their publishers.
- The skill asks agents to run a persistent polling loop and restart it if it dies. Confirm you are comfortable with the agent making repeated outbound HTTP requests to chesswithclaw.vercel.app while the game is active.
- Ask the skill author (or inspect the source if available) how tokens are stored/handled and whether the agent logs them; avoid persistent storage of tokens or logging sensitive headers.
If you need higher assurance, request the skill author to provide a code install spec and source repo for review or limit use to ephemeral, user-provided game invites without granting wider credentials.
Capability Analysis
Type: OpenClaw Skill
Name: play-chess
Version: 1.0.3
The play-chess skill is a well-documented bundle designed to allow an OpenClaw agent to play live chess on the chesswithclaw.vercel.app platform. It provides clear instructions for both API-based polling and browser-based interaction using standard agent tools. The skill focuses entirely on game logic, chess strategy, and legitimate API communication, with no evidence of data exfiltration, malicious execution, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: the skill explains how to connect to chesswithclaw.vercel.app, poll the API or use the built-in browser, and play moves. It does not request unrelated cloud credentials or system-level access.
Instruction Scope
Instructions require extracting GAME_ID and AGENT_TOKEN from a user-provided URL and storing them for API calls (token must be sent in an x-agent-token header). The guide also describes persistent polling and optional browser automation (clicking board squares, snapshots, chat). These behaviors are within the chess-play scope, but they request the agent to perform long-running polling and to install/Invoke other skills (npx clawhub install ..., agent-browser) which can broaden the runtime actions the agent will take.
Install Mechanism
The skill itself has no install spec and is instruction-only (lowest install risk). However the SKILL.md instructs the agent to run npx to install other skills/components for the browser method; those external installs will pull code from npm and should be treated as additional risk outside this skill.
Credentials
No environment variables, secrets, or system config paths are declared. The only credentials used are AGENT_TOKEN and GAME_ID extracted from an invite URL provided by the user — reasonable and proportional for a per-game authentication token.
Persistence & Privilege
always is false and the skill doesn't request persistent platform privileges, but the instructions explicitly tell the agent to maintain/auto-restart a polling loop (long-lived connection). That requires the agent to run background or repeated operations and could increase the blast radius if misused.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install play-chess - After installation, invoke the skill by name or use
/play-chess - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
No changes detected in this version.
- No file changes were made for version 1.0.3.
v1.0.2
Version 1.0.2
- Added support for both API/long-polling and live browser-based connection methods, with step-by-step integration guides for each method.
- Interactive browser method now describes how agents visually click squares for realistic human-like games, including relevant data-testid references.
- Clarified that the agent name should be included using the x-agent-name header for API requests and moves.
- Updated and expanded chess strategy guide: more concrete opening choices and strategic advice for various positions.
- Improved instructions for resume and recovery if polling is interrupted or killed, ensuring robust connection management.
v1.0.1
play-chess v1.0.1
- Added a new trigger: the skill now activates if the user mentions "npx clawhub install play-chess".
- Documentation updated to clarify: the agent token must be included in the request header only, never in the body, for every API request.
- The connection polling step now instructs to wait exactly the `retry_after` seconds specified in the API response.
- No code changes; documentation and usage guidance only.
v1.0.0
Initial release of play-chess skill — live chess against users via ChessWithClaw.
- Connects automatically to ChessWithClaw games when user provides an invite link or requests a game.
- Always plays as Black; waits for the human (White) to make the first move.
- Uses reliable long-polling to track game state, legal moves, and chat messages.
- Submits only legal moves using the UCI format, with clear rules for special moves and promotions.
- Supports real-time chat, draw offers/acceptance, and resignation logic.
- Follows established chess strategy for openings, middlegame, and endgame.
Metadata
Frequently Asked Questions
What is Play Chess on ChessWithClaw?
Play live chess as Black against the user on ChessWithClaw by connecting to their game invite and responding to their first move. It is an AI Agent Skill for Claude Code / OpenClaw, with 248 downloads so far.
How do I install Play Chess on ChessWithClaw?
Run "/install play-chess" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Play Chess on ChessWithClaw free?
Yes, Play Chess on ChessWithClaw is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Play Chess on ChessWithClaw support?
Play Chess on ChessWithClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Play Chess on ChessWithClaw?
It is built and maintained by Alightttt (@alightttt); the current version is v1.0.3.
More Skills