/install chess-coach
Chess Coach
This skill helps you improve your chess game by monitoring your Chess.com profile and offering advice tailored to your skill level.
Features
- Profile Tracking: Connect your Chess.com username and track stats across formats (Blitz, Bullet, Rapid).
- Recent Game Analysis: Analyze your most recent games and identify coaching opportunities.
- Skill-Level Calibration: Automatically Adjusts advice based on your current rating.
Workflows
1. Setup
When a user mentions chess or improving their game for the first time:
- Ask for their Chess.com username.
- Use
scripts/chess_api.py \x3Cusername> statsto fetch their rating and stats. - Store the username and their preferred formats (Blitz, Bullet, Rapid) in
memory/chess_state.json.
2. Monitoring & Analysis
Periodically or upon request:
- Fetch recent games using
scripts/chess_api.py \x3Cusername> games. - Compare the game list against
memory/chess_state.jsonto ensure no games are analyzed twice. - Daily Budget: Only analyze one game per 24-hour period unless specifically requested.
- If new games exist, pick the most relevant one (e.g., a loss where the rating gap was small) and analyze it.
- Observation Logging: Instead of just giving a one-off tip, log the core mistake or pattern (e.g., "Missed pin on d-file", "Weakened back rank") to
memory/chess_observations.jsonl. - Consult
references/skill_levels.mdfor coaching focus based on the user's current rating. - Provide 2-3 actionable points. Keep it punchy and encouraging.
3. Synthesis (The "Grand Lesson")
Once per week, or when memory/chess_observations.jsonl reaches 5+ entries:
- Review the logged observations to find recurring themes.
- Identify the single "highest ROI" area for improvement (e.g., "You lose 40% of games due to early Queen excursions").
- Present this as a dedicated "Coaching Review" session.
Example
"I see you've played 10 Blitz games since we last talked. In your game against 'Grandmaster123', you missed a simple fork on the f2 square! At your current rating (850), focusing on basic tactics like these will help you reach 1000 fast."
Resources
scripts/chess_api.py: Interacts with the Chess.com public API.references/skill_levels.md: Provides guidance on coaching priorities by rating bracket.memory/chess_state.json: Store the user's username, preferred formats, and the ID of the last analyzed game.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chess-coach - After installation, invoke the skill by name or use
/chess-coach - Provide required inputs per the skill's parameter spec and get structured output
What is Chess Coach?
Interactive chess coaching based on Chess.com games and stats. Monitors a user's progress, analyzes recent games according to their skill level, and offers p... It is an AI Agent Skill for Claude Code / OpenClaw, with 122 downloads so far.
How do I install Chess Coach?
Run "/install chess-coach" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Chess Coach free?
Yes, Chess Coach is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Chess Coach support?
Chess Coach is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Chess Coach?
It is built and maintained by twharmon (@twharmon); the current version is v1.0.0.