pokemon-player

Automate Pokémon gameplay with RAM reads and vision-verified screenshots.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill pokemon-player-jamesfincher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/JamesFincher/gengar/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/JamesFincher/gengar --skill pokemon-player-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

It solves the challenge of getting an AI to actually play Pokémon games end-to-end so users can watch progress and resume from saves without manual emulator operation.

Core Features & Use Cases

  • Headless emulation gameplay: Runs Pokémon using the pokemon-agent package and a user-provided ROM (e.g., .gb/.gbc/.gba).
  • RAM + vision loop: Reads game state via RAM APIs and verifies movement using screenshots with vision analysis.
  • Save/load management: Saves at safe checkpoints and reloads state to continue later, including enumerating available saves.
  • Live spectator dashboard: Uses an SSH reverse tunnel (via localhost.run) to stream a dashboard URL to the user for real-time watching.

Quick Start

Ask the agent to start Pokemon gameplay using your ROM and to open a watchable dashboard URL.

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 with an AI agent using emulator RAM reads?

You can watch automated Pokemon gameplay through a live spectator dashboard exposed via a localhost.run SSH reverse tunnel. This dashboard streams the headless emulator output to your browser in real-time.

Can I resume Pokemon emulator gameplay from a previous save state?

Yes, the agent manages save and load operations at safe checkpoints using emulator save states. You can enumerate available saves and reload previous RAM states to resume gameplay without losing progress.

What do I need to set up before starting AI Pokemon gameplay?

You need to provide a Pokemon ROM file (.gb, .gbc, or .gba) and set up a pokemon-agent server. The system uses this server to run health checks, manage save endpoints, and execute the observe-orient-decide-act-verify loop.

How does the AI verify movement and battle decisions in Pokemon?

The AI verifies movement and battle decisions by combining RAM state reads with screenshot vision analysis. This dual approach validates in-game navigation and ensures actions execute correctly before proceeding.

Does the Pokemon agent support headless emulator streaming via localhost.run?

Yes, the Pokemon agent runs a headless emulator and streams the gameplay dashboard via localhost.run. This SSH reverse tunnel exposes the local spectator dashboard to a public URL for remote viewing.