skills.rest
afel6
afel6COMMUNITY
Explore all skills by this author →
GitHub

pokemon-player

Automate Pokemon gameplay by controlling a headless emulator and issuing strategic inputs.

Updated Mar 25, 2026
Search Tags:#automation#pokemon#gaming#gameplay#emulator#rom#pyboy
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill pokemon-player-afel6
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/gaming/pokemon-player
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill pokemon-player-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the manual, error-prone process of running a Game Boy/Game Boy Advance ROM in an emulator, observing game state, making strategic decisions, and controlling inputs so a user can watch or resume consistent playthroughs without manual button presses.

Core Features & Use Cases

  • Headless Emulation Control: Start and manage a local pokemon-agent game server, send short action sequences, and resume from saved states.
  • State + Vision Hybrid Observation: Combine RAM-exposed structured state with periodic screenshots for reliable navigation, dialog detection, and verification.
  • Save/Load & Progress Tracking: Create, list, and load named saves programmatically and record progress to memory using PKM: prefixed keys.
  • Remote Dashboard Viewing: Optionally expose a live dashboard via an SSH reverse tunnel for stakeholders to watch gameplay.
  • Tactical Gameplay Logic: Built-in priorities for dialog handling, battle decisions, healing, and safe navigation with tips for Gen 1 quirks and map transitions.
  • Safety & ROM Policy: Requires a user-provided ROM and explicitly forbids downloading or distributing ROM files.

Quick Start

Start the pokemon-agent server pointing at your ROM, wait for it to report healthy, then ask the agent to begin playing and provide the dashboard URL for watching.

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 a Game Boy ROM with an AI agent?▼

To automate playing a Game Boy ROM, you need a local pokemon-agent server hosting your valid ROM. The agent autonomously controls the headless emulator by reading RAM state and screenshots to issue strategic game inputs.

How does headless emulation decide what actions to take in Pokemon?▼

Headless emulation decides actions by combining RAM-exposed structured state with periodic screenshots. This hybrid observation enables reliable navigation, dialog detection, and tactical battle decisions without manual button presses.

Do I need to provide my own ROM to use the Pokemon automation agent?▼

Yes, you must provide your own valid Game Boy or Game Boy Advance ROM. The agent explicitly forbids downloading or distributing ROM files and requires a local pokemon-agent installation to function.

Can I expose a live dashboard to watch automated Pokemon gameplay remotely?▼

Yes, you can expose a live dashboard for remote viewing via an SSH reverse tunnel. This allows stakeholders to watch the automated gameplay and monitor the agent's progress over the network.

How does the agent save and load game states during an automated playthrough?▼

The agent creates, lists, and loads named saves programmatically to manage progress. It records progress to memory using PKM-prefixed keys and can resume playthroughs from these saved states.

What are the limitations of using RAM state and screenshots for Pokemon navigation?▼

The agent relies on RAM state and screenshots, requiring built-in priorities for dialog handling and safe navigation. Users should anticipate Gen 1 quirks and map transition challenges when relying on automated tactical gameplay logic.

Related Skills

Explore More Software Engineering Skills→
cryptopaficryptopafi

pokemon-player

Plays Game Boy and Game Boy Advance Pokemon games autonomously via terminal-controlled inputs and remote dashboard viewing.

Community
Advanced
musical-basicsmusical-basics

pokemon-player

Play Game Boy Pokemon games via emulation with RAM-based decision making.

Community
Intermediate
zerwizzerwiz

pokemon-player

Translate Pokémon game state into button inputs for autonomous play.

Community
Advanced
icyzhicyzh
1

pokemon-player

Play Pokemon ROMs autonomously via headless emulation with RAM state monitoring.

Community
Advanced