pokemon-player

Play Pokemon games via headless emulation with RAM state reading and button inputs.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/hochoa13/Asistente-Harlest --skill pokemon-player-hochoa13
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/hochoa13/Asistente-Harlest/tree/main/skills/gaming/pokemon-player
Command: npx skills add https://github.com/hochoa13/Asistente-Harlest --skill pokemon-player-hochoa13

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables autonomous gameplay of Pokemon titles through headless emulation, allowing an AI to play the game, make strategic decisions, and interact with the game world directly from the terminal.

Core Features & Use Cases

  • Headless Emulation: Plays Pokemon games without a graphical interface using pyboy.
  • State Reading & Decision Making: Reads game state from RAM and makes strategic choices based on observed game conditions.
  • Automated Input: Sends button inputs to the emulator to control gameplay.
  • Use Case: Watch an AI play through Pokemon Red, or have it train your Pokemon for you while you do other tasks.

Quick Start

Use the pokemon-player skill to start playing Pokemon Red from a ROM file.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I set up an AI agent to play Pokemon autonomously?

Autonomous Pokemon gameplay is enabled by running a headless pyboy emulator that reads game state from RAM, makes strategic decisions, and sends button inputs directly from the terminal.

Can I use pyboy to control Pokemon gameplay without a graphical interface?

Yes, pyboy enables headless emulation for Pokemon games, allowing an AI agent to read RAM state and send button inputs without requiring a graphical interface.

What is the best way to read Pokemon game state from RAM for an AI agent?

Reading Pokemon game state from RAM involves using the pokemon-agent package to extract structured data, enabling the AI to make strategic gameplay decisions based on observed conditions.

Does autonomous Pokemon gameplay support saving and loading game states?

Yes, autonomous Pokemon gameplay supports saving, loading, and interacting with game elements through API calls, allowing the AI agent to manage progress directly from the terminal.

What are the limitations of using a headless emulator for Pokemon gameplay?

Using a headless emulator for Pokemon gameplay requires relying entirely on structured RAM state reading and API calls to monitor the AI agent's progress and make strategic decisions without a graphical interface.