pokemon-player

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

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill pokemon-player-episvr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/episvr/USTB-2026-SummerInternship/tree/main/hermes-config/optional-skills/gaming/pokemon-player
Command: npx skills add https://github.com/episvr/USTB-2026-SummerInternship --skill pokemon-player-episvr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pokemon-agent, pyboy.

What problem does it solve? Playing Pokemon through an emulator requires constant visual attention and manual input, making it impossible to automate or demonstrate AI gameplay without a structured control loop. This Skill provides a complete workflow for running Pokemon games headlessly, reading game state from emulator RAM, and making vision-verified decisions. ## Core Features & Use Cases - Headless Emulation Server: Runs the pokemon-agent package with PyBoy to serve game state, screenshots, and action endpoints over HTTP on port 9876. - Vision-Guided Gameplay Loop: Combines RAM state reads (position, HP, battle, dialog) with screenshot analysis to navigate maps, handle battles, and avoid getting stuck on ledges or warps. - Save State Management: Creates named save states before risky encounters and resumes from them via API or startup flags. - Live Dashboard Sharing: Sets up an SSH reverse tunnel through localhost.run so users can watch gameplay in a browser. - Use Case: A user says "play pokemon" and the AI starts Pokemon Red, navigates from Pallet Town to defeat Brock, saving progress before the gym battle while the user watches via a shared dashboard URL. ## Quick Start Ask the AI to "play pokemon" and provide the path to your own legally obtained Game Boy ROM file.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How can I watch the AI play Pokemon in my browser?▼

The Skill sets up an SSH reverse tunnel through localhost.run, forwarding local port 9876 to a public .lhr.life URL. Append /dashboard/ to that URL to watch live gameplay, noting the URL changes on each restart.