skills.rest
patty-chow
patty-chowCOMMUNITY
Explore all skills by this author →
GitHub

pokemon-player

Plays Pokemon games via headless PyBoy emulation with RAM state reads and screenshot verification.

Updated May 28, 2026
Search Tags:#automation#vision#pokemon#gameplay#emulator#pyboy#gameboy
One-click install
npx skills add https://github.com/patty-chow/the-stable --skill pokemon-player-patty-chow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/patty-chow/the-stable/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/patty-chow/the-stable --skill pokemon-player-patty-chow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing a Game Boy Pokemon game autonomously requires bridging emulator control, game state awareness, and navigation decisions, which is difficult to coordinate manually through trial and error. ## Core Features & Use Cases - Headless Emulation Control: Starts a pokemon-agent server over a ROM file and issues actions (move, press A/B, wait) through a REST API on port 9876. - State and Vision Loop: Combines RAM-based state reads (position, HP, battle, dialog) with screenshot analysis to navigate maps, handle battles, and avoid getting stuck. - Save State Management: Saves and loads named game states before risky encounters and resumes sessions via a --load-state flag. - Live Spectator Dashboard: Exposes a browser dashboard through an SSH reverse tunnel so the user can watch gameplay in real time. - Use Case: A user says "play pokemon" and the agent boots Pokemon Red, picks a starter, battles through Viridian Forest, saves progress, and shares a live dashboard URL. ## Quick Start Ask the agent to start playing Pokemon with your ROM file and share the live dashboard link.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I have an AI play Pokemon with an emulator?▼

Install the pokemon-agent package with the pyboy extra, start its server with your ROM file, then drive gameplay through its REST API for state, screenshots, and actions. The agent loops through observe, decide, act, and verify steps using both RAM data and vision.

How do I save and load game states in a PyBoy emulator?▼

Send a POST request to the /save endpoint with a descriptive name to snapshot the current state, and POST to /load to restore it. You can also pass --load-state at server startup to resume directly from a named save.

Can I watch the AI play Pokemon in my browser?▼

Yes, the server exposes a dashboard that can be shared through an SSH reverse tunnel via localhost.run. The generated URL changes on each restart, so append /dashboard/ to the fresh tunnel address.

Why does the agent get stuck or lost while navigating?▼

RAM state only reports position and HP, not surroundings like ledges, doors, or NPCs, so movement without screenshots causes overshoots. Take a screenshot every 2-4 steps, wait after warp transitions, and sidestep after exiting buildings.

Where do I get the ROM file needed to play?▼

You must supply your own legally obtained ROM file such as a .gb, .gbc, or .gba dump. The skill never downloads or provides ROM files, so point the server at a ROM path on your machine.

Related Skills

Explore More Personal & Entrepreneur Skills→
kaminocorpkaminocorp
1

pokemon-player

Plays Pokemon games autonomously via headless PyBoy emulation with RAM state reading and vision-based navigation.

Official
Advanced
fpontejosfpontejos

plan

Convert memory bank state into phased implementation plans with milestones.

Community
Basic
arthur0narthur0n
8

godot-enemy-ai

Build a Godot 4.6 enemy AI with patrol, chase, and attack states.

Community
Advanced
AnandaAnugrahHandyantoAnandaAnugrahHandyanto

pokemon-player

Automate Pokemon Gen 1 gameplay via headless emulator and RAM/state data.

Community
Advanced