← Back to Skills Marketplace
twharmon

Chess Coach

by twharmon · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
122
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install chess-coach
Description
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...
README (SKILL.md)

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:

  1. Ask for their Chess.com username.
  2. Use scripts/chess_api.py \x3Cusername> stats to fetch their rating and stats.
  3. Store the username and their preferred formats (Blitz, Bullet, Rapid) in memory/chess_state.json.

2. Monitoring & Analysis

Periodically or upon request:

  1. Fetch recent games using scripts/chess_api.py \x3Cusername> games.
  2. Compare the game list against memory/chess_state.json to ensure no games are analyzed twice.
  3. Daily Budget: Only analyze one game per 24-hour period unless specifically requested.
  4. If new games exist, pick the most relevant one (e.g., a loss where the rating gap was small) and analyze it.
  5. 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.
  6. Consult references/skill_levels.md for coaching focus based on the user's current rating.
  7. 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:

  1. Review the logged observations to find recurring themes.
  2. Identify the single "highest ROI" area for improvement (e.g., "You lose 40% of games due to early Queen excursions").
  3. 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.
Usage Guidance
This skill appears to do what it says: it fetches public Chess.com data and stores simple local state. Before enabling it, confirm you are comfortable with the agent making outbound requests to api.chess.com and writing files under memory/ (memory/chess_state.json, memory/chess_observations.jsonl). Ensure your runtime has Python and the 'requests' package installed or be prepared to install them. If you do not want background monitoring, keep autonomous invocation disabled or explicitly invoke the skill only when you want analysis.
Capability Analysis
Type: OpenClaw Skill Name: chess-coach Version: 1.0.0 The chess-coach skill is a legitimate tool designed to provide chess coaching by interacting with the public Chess.com API. The Python script (scripts/chess_api.py) safely fetches player statistics and game history without requiring sensitive credentials or executing arbitrary code. The instructions in SKILL.md are well-defined, focusing on local state management and pattern recognition for coaching purposes, with no evidence of data exfiltration, malicious execution, or harmful prompt injection.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: the skill uses the Chess.com public API (api.chess.com) and a small helper script to fetch stats and games, and the documentation/references match the coaching objective.
Instruction Scope
SKILL.md instructs the agent to fetch public Chess.com data, analyze games, and store state/observations in memory/chess_state.json and memory/chess_observations.jsonl. Writing those files and periodic monitoring are expected for this skill, but they are not declared in metadata; the instructions also rely on running scripts/chess_api.py which assumes a Python runtime and network egress to Chess.com.
Install Mechanism
There is no install spec (instruction-only), which is low risk. However, the included scripts/chess_api.py depends on Python and the 'requests' package; the skill metadata does not declare required binaries or packages, so the runtime environment may need manual setup.
Credentials
The skill requests no credentials or environment variables and only accesses Chess.com public endpoints. It stores only usernames and observation logs locally per SKILL.md; no sensitive credentials are requested.
Persistence & Privilege
always:false (normal). The skill's SKILL.md allows periodic (background) monitoring and autonomous invocation (disable-model-invocation:false), which is expected for ongoing coaching but means the agent could perform repeated network calls and writes without explicit user action.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install chess-coach
  3. After installation, invoke the skill by name or use /chess-coach
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Chess Coach skill. - Connect your Chess.com profile to track rating and stats across Blitz, Bullet, and Rapid formats. - Get personalized game analysis and receive actionable feedback based on your skill level. - Logs recurring mistakes and synthesizes them into a focused weekly "Coaching Review" session. - Ensures only new, relevant games are analyzed and maintains a history of key observations for tailored coaching.
Metadata
Slug chess-coach
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments