pokemon-player

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

1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/Araara7/hermes-skills --skill pokemon-player-araara7
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/Araara7/hermes-skills/tree/main/gaming/pokemon-player
Command: npx skills add https://github.com/Araara7/hermes-skills --skill pokemon-player-araara7

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing a Game Boy Pokemon game autonomously requires coordinating an emulator, reading game state, making navigation and battle decisions, and avoiding common traps like getting lost or stuck on dialog. This Skill provides a complete operational playbook for running a headless Pokemon agent with verified, vision-checked gameplay. ## Core Features & Use Cases - Headless Emulation Server: Starts the pokemon-agent server with a user-provided ROM, exposing REST endpoints for state, screenshots, actions, and save/load management. - Vision-Verified Gameplay Loop: Combines RAM state reads with screenshot analysis every few steps to navigate maps, handle warps, ledges, and dialog reliably. - Battle and Progression Strategy: Includes a Gen 1 type chart, battle decision tree, save/load discipline, and gym-by-gym milestone tracking. - Use Case: A user says "play pokemon" and provides a Pokemon Red ROM; the Skill boots the server, opens a live dashboard tunnel for the user to watch, and plays through the game while saving progress periodically. ## Quick Start Say "play pokemon" and provide your Pokemon ROM file so the agent can start the emulator server and begin playing.

Frequently Asked Questions about pokemon-player

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

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

Provide a Game Boy Pokemon ROM file, then the agent clones and installs the pokemon-agent package, starts its server with the ROM, and plays via a REST API. You can watch live through a browser dashboard exposed over an SSH tunnel.

How does the Pokemon agent avoid getting lost while navigating?▼

It combines RAM state reads for position and HP with frequent screenshot analysis every 2-4 movement steps. Vision confirms spatial details like ledges, doors, and NPCs that RAM data alone cannot reveal.

Can I use my own Pokemon ROM with the emulator?▼

Yes, you must supply your own ROM file such as a .gb, .gbc, or .gba file. The Skill never downloads or provides ROMs; it only starts the server pointing at the ROM path you provide.

Does the Pokemon agent support saving and resuming games?▼

Yes, it saves named states via the server's save endpoint before risky fights and every 15-20 turns. Games resume by passing the save name with the load-state flag when restarting the server.

Why does the Pokemon agent get stuck after entering doors?▼

Map transitions fade to black and take extra frames, so position reads go stale without waiting. The Skill adds wait actions after warps and sidesteps after exiting buildings to avoid re-entering the door.