pokemon-player

Automate Pokemon gameplay with a headless emulator and live dashboard.

1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill pokemon-player-changzhou-xj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/ChangZhou-xj/zxj_skill/tree/main/gaming/pokemon-player
Command: npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill pokemon-player-changzhou-xj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate Pokemon gameplay by running a headless emulator and reading RAM/state to drive decisions, enabling AI play and analysis without manual interaction.

Core Features & Use Cases

  • Headless Pokemon emulation and RAM/state observation for AI control
  • Save/load, state management, and replayable gameplay across ROM variations
  • Live dashboard workflow for monitoring progress and decisions

Quick Start

Clone the pokemon-agent repo, create a Python 3.10+ virtual environment, install with the pyboy extras, and start the server pointing to a ROM.

Frequently Asked Questions about pokemon-player

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Pokemon gameplay headlessly using RAM reads?

Automate Pokemon gameplay by running a headless emulator that reads RAM and state to drive decisions. This Skill exposes /state, /action, /save, and /load endpoints for deterministic control and progress tracking across ROM titles like Red, Blue, Yellow, and FireRed.

What Python environment do I need to run a headless Pokemon emulator for AI control?

Running a headless Pokemon emulator requires Python 3.10+ and the pokemon-agent package with pyboy extras. You must clone the repository, create a virtual environment, install dependencies, and provide a valid ROM file to start the server.

Can I observe and control AI play across different Pokemon ROM variations?

Yes, the headless emulator supports observing and controlling AI play across ROM variations like Red, Blue, Yellow, and FireRed. It provides save and load functionality for state management and replayable gameplay analysis.

How does a headless emulator expose state and action endpoints for deterministic gameplay?

The headless emulator exposes /state, /action, /save, and /load HTTP endpoints for deterministic control. Reading RAM allows the AI to observe the current game state, execute actions, and track progress through a live dashboard workflow.

What's the best way to monitor AI decisions during automated Pokemon gameplay?

Monitor AI decisions during automated Pokemon gameplay through the live dashboard workflow. It tracks progress and decisions by reading emulator RAM state, enabling observation of AI play without manual interaction.

Why do I need a ROM file to automate Pokemon gameplay with a headless emulator?

A ROM file is required to automate Pokemon gameplay because the headless emulator needs the game data to run. The server must be pointed to a valid ROM file to begin reading RAM state and driving AI decisions.