- name
- 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 personalized advice. Use when the user wants to improve their chess, check their current rating/stats, or receive feedback on their games.
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 <username> 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 <username> 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.