autonomous-agent-gaming — Claude Code skill: what it does
autonomous-agent-gaming is a skill with runnable examples of rule-based, minimax, MCTS and Q-learning bots, plus a chess engine for agents choosing game moves.
no license 274 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a claude-codeWhat autonomous-agent-gaming does
Under examples/ sit four strategies: a rule-based player, minimax with alpha-beta pruning, Monte Carlo Tree Search, and tabular Q-learning. There is also a chess engine in examples/chess_engine.py, plus scripts/game_theory_analyzer.py for game-theory analysis and scripts/agent_benchmark.py for pitting agents against each other.
Environments follow one contract: reset(), step(action), get_legal_actions(state), is_terminal(state), render(). Gym environments plug in directly, and PygameGameEnvironment is the base class when you draw your own board. Strategy pieces live in examples/strategy_modules.py: an opening book that hashes positions for fast lookup and endgame tablebases.
The chess example needs pip install python-chess before it runs, and drawing a custom game takes pygame. Put those in place first.
What it helps with
- Build a turn-based bot that searches the move tree
- Train a Q-learning agent on your own state space
- Validate chess moves and play a full game
- Wrap a homemade game in the shared environment interface
- Benchmark several agents over the same matches
Example prompts for the agent
- Write a minimax agent with alpha-beta pruning for tic-tac-toe
- Run
examples/qlearning_agent.pyand explain how epsilon decay works - Build a pygame environment for my card game based on
examples/game_environment.py
How to install autonomous-agent-gaming
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a claude-code2Manually: put the files in place
~/.claude/skills/autonomous-agent-gaming/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/autonomous-agent-gaming/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a codex2Manually: put the files in place
.agents/skills/autonomous-agent-gaming/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a cursor2Manually: put the files in place
.cursor/skills/autonomous-agent-gaming/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/autonomous-agent-gaming2Manually: put the files in place
.github/skills/autonomous-agent-gaming/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/autonomous-agent-gamingManually: put the files in place
.devin/skills/autonomous-agent-gaming/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about autonomous-agent-gaming
How do I install autonomous-agent-gaming in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill autonomous-agent-gaming -a claude-code. The skill ends up at ~/.claude/skills/autonomous-agent-gaming/SKILL.md.
What does autonomous-agent-gaming do?
It supplies working game-agent examples: rule-based, minimax, MCTS, Q-learning and chess, along with an environment interface and strategy modules for openings and endgames.
What do I need to run the chess example?
The python-chess package, installed with pip install python-chess. Drawing your own game also takes pygame.