pokemon-player

Automate Pokémon gameplay through a headless emulator using the pokemon-agent package.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/AlexiosBluffMara/mercury --skill pokemon-player-alexiosbluffmara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/AlexiosBluffMara/mercury/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/AlexiosBluffMara/mercury --skill pokemon-player-alexiosbluffmara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates Pokémon gameplay via a headless emulator using the pokemon-agent package.

Core Features & Use Cases

  • Headless play: runs Pokémon games via a headless emulator controlled by the agent.
  • Decision loop: observes RAM state and vision, makes strategic inputs, and iterates the gameplay loop.
  • Use Case: Watch an AI play for strategy research or generate gameplay datasets across ROMs.

Quick Start

Clone the pokemon-agent project, create a Python 3.10+ virtual environment, install dependencies, and start the server with the ROM and port to begin.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I automate Pokémon gameplay using a headless emulator?

Automating Pokémon gameplay involves using a headless emulator controlled by an AI agent that observes RAM state and vision to make strategic inputs, iterating the gameplay loop automatically.

What is needed to run an AI agent for headless Pokémon emulation?

To run headless Pokémon emulation, you need Python 3.10+, the pokemon-agent codebase, a Pokémon ROM file, and a running server configured on a designated port.

How does an AI agent make decisions during Pokémon emulation?

During Pokémon emulation, the AI agent makes decisions by observing the game's RAM state and visual output, then generating strategic inputs to progress the gameplay loop autonomously.

Can I collect gameplay data across different Pokémon ROMs and generations?

Yes, you can collect gameplay datasets across different Pokémon ROMs and generations by deploying the AI agent to play autonomously and log strategic decisions and game states.

What are the limitations of using a headless emulator for Pokémon automation?

A key limitation of headless Pokémon automation is the strict dependency on a specific Python 3.10+ environment, the pokemon-agent codebase, and a valid ROM file to function.

Is headless Pokémon emulation suitable for strategy research?

Headless Pokémon emulation is highly suitable for strategy research, allowing users to watch an AI play, study its decision-making loop, and analyze automated gameplay tactics.