pokemon-player

Run a headless Pokemon emulator with AI-controlled decisions via a local server.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/shiftrepo/aws --skill pokemon-player-shiftrepo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/shiftrepo/aws/tree/main/HermesAgent/skills/skills/gaming/pokemon-player
Command: npx skills add https://github.com/shiftrepo/aws --skill pokemon-player-shiftrepo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables autonomous Pokemon gameplay by running a headless emulator and making strategic decisions via AI, all controlled from the terminal.

Core Features & Use Cases

  • Headless emulation and automated play of Pokemon games
  • Reads structured game state from RAM, makes strategic decisions, and sends button inputs
  • Start a game server and monitor gameplay from a live terminal dashboard
  • Supports ROM files such as Pokemon Red/Blue/Yellow/FireRed across different ports

Quick Start

Set up the pokemon-agent environment and start the server by pointing --rom to your ROM file and --port to the desired HTTP port.

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 using an AI agent?

To automate Pokemon gameplay, you run a headless emulator controlled by an AI agent that reads RAM state and sends button inputs. You need the pokemon-agent package, a valid ROM file, and a Python 3.10+ environment to start a local server.

What Pokemon ROMs are supported for headless emulation?

Headless emulation supports Pokemon ROM files including Red, Blue, Yellow, and FireRed. You point the server to your specific ROM file using the --rom flag to load the desired game port for AI-driven play.

How does an AI agent read game state to make strategic decisions?

The AI agent reads structured game state directly from RAM and supports vision-assisted decision-making to evaluate the screen. It processes this observation data to choose strategic actions and sends corresponding button inputs to the emulator.

Do I need Python to run headless Pokemon emulation?

Yes, you need a Python 3.10+ environment to run headless Pokemon emulation. The setup requires installing the pokemon-agent package to start a local server that exposes state and action endpoints for the AI agent.

How do I monitor autonomous Pokemon gameplay from the terminal?

You monitor autonomous Pokemon gameplay through a live terminal dashboard provided by the game server. After starting the server with your ROM and port, the dashboard displays the ongoing gameplay as the AI agent executes decisions.

Can vision-based AI play Pokemon games without reading RAM?

The AI agent supports both RAM-based observation and vision-assisted decision-making for playing Pokemon games. You can utilize the vision capabilities to evaluate on-screen visuals, though the system reads structured state from RAM for strategic inputs.