pokemon-player

Plays Pokemon games via headless emulation using the pokemon-agent package and vision-guided navigation.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill pokemon-player-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/gaming/pokemon-player
Command: npx skills add https://github.com/yakeworld/Synthos --skill pokemon-player-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing a Pokemon game autonomously through a headless emulator requires constant spatial awareness, dialog handling, battle decisions, and save management that naive action scripting cannot handle. This Skill provides a complete observe-orient-decide-act loop with vision verification, battle strategy, and safe save/load practices for the pokemon-agent emulation server. ## Core Features & Use Cases - Headless Game Server Control: Starts and manages the pokemon-agent server with a user-provided ROM, health checks, and save-state loading via a REST API on port 9876. - Vision-Guided Gameplay Loop: Combines RAM state reads with screenshot analysis every 2-4 moves to handle ledges, warps, building exits, and dialog without getting lost. - Battle and Progression Strategy: Applies Gen 1 type matchups, run/fight decision trees, and a full badge-by-badge progression plan from Pallet Town to the Elite Four. - Use Case: A user says "play pokemon" and provides a Pokemon Red ROM; the Skill starts the server, opens a live dashboard tunnel, plays through Route 1 with periodic saves, and reports progress. ## Quick Start Ask the assistant to play Pokemon with your own ROM file, for example: start pokemon-agent with my pokemon_red.gb ROM and begin playing while I watch the dashboard.

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 headless emulation?

Install the pokemon-agent package, start it with pokemon-agent serve pointing to your own ROM file, then drive gameplay through its REST endpoints for state, screenshots, actions, and saves. The Skill manages the full observe-decide-act loop with vision verification.

How do I set up the pokemon-agent server and live dashboard?

Clone NousResearch/pokemon-agent, create a Python 3.10+ virtual environment with uv or venv, and install with the pyboy extra. Run pokemon-agent serve with --rom and --port 9876, then expose the dashboard through an SSH reverse tunnel via localhost.run.

Can the agent download a Pokemon ROM for me?

No. The Skill strictly refuses to download, generate, or provide ROM files under any circumstances. You must supply your own legally obtained ROM file, and the agent will ask you for its path before starting.

Why does the agent get lost or stuck while navigating in the game?

RAM state only reports position and HP, not surroundings like ledges, doors, or NPCs. The Skill prevents this by taking a screenshot every 2-4 moves, waiting after warp transitions, and sidestepping after exiting buildings.

When does the agent save game progress during play?

It saves every 15-20 turns and always before gym battles, rival encounters, new areas, or any uncertain action. Saves use descriptive names like before_brock via POST /save, and can be reloaded with POST /load or the --load-state startup flag.