pokemon-player

Automate Pokemon Red/Blue/Yellow gameplay with headless emulation, RAM reads, and screenshot verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you play and observe Pokemon games end-to-end by combining headless emulation with RAM state reading and vision-based verification, reducing the trial-and-error of navigation and battle decisions.

Core Features & Use Cases

  • Headless game emulation control: Launches and manages a Pokemon game server via the pokemon-agent package, including optional state loading for save-based resumes.
  • Closed-loop decision making: Uses RAM state (position/HP/battle/dialog flags) alongside screenshots analyzed through vision to orient, verify movement, and avoid getting lost.
  • Checkpointed progression: Guides periodic saving/loading through the agent API to reduce loss and support safe recovery before gyms, rivals, and risky fights.
  • User-visible live dashboard: Provides a live dashboard URL via an SSH reverse tunnel so you can watch the gameplay in your browser.

Quick Start

Tell the assistant: "Play Pokemon by using the ROM located in roms/pokemon_red.gb, start the server on port 9876, open the live dashboard for me, and begin playing while saving before Brock and other risky battles."

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I automate playing Pokemon games with an AI using headless emulation?

Headless Pokemon gameplay automation works by launching a game server via the pokemon-agent package, then looping through observe, orient, decide, act, and verify cycles using RAM state reads and screenshot vision verification.

Can I resume a Pokemon game from a previous save state using a headless emulator?

You can resume Pokemon gameplay from a previous save by using the optional --load-state flag at startup, restoring RAM state and progression to continue from a checkpointed position.

How does RAM state reading and vision verification work for Pokemon game automation?

RAM state reading captures position, HP, battle, and dialog flags while vision verification analyzes screenshots to orient the AI, confirm movement, and prevent navigation errors during gameplay.

What is the best way to watch headless Pokemon gameplay in my browser?

Watching headless Pokemon gameplay is done through a live dashboard wired via a reverse SSH tunnel, providing a browser URL to view real-time game progression and AI decisions.

How do I set up checkpointed saving before risky battles in Pokemon Red and Blue?

Checkpointed saving before risky battles is handled by periodic /save API calls during the gameplay loop, preserving progress before gyms and fights to reduce loss and enable recovery.

Does this Pokemon agent work with Pokemon Yellow and related Game Boy ROMs?

The agent supports Pokemon Red, Blue, Yellow, and related ROMs by launching pokemon-agent serve with a specified ROM file path and port, applying RAM reads and vision verification across compatible titles.