pokemon-player

Execute autonomous Pokemon gameplay via headless emulator with vision-based state verification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyboy.

What problem does it solve?

This skill enables an AI agent to play GameBoy-era Pokemon games autonomously by combining headless emulation with real-time visual and memory-based feedback.

Core Features & Use Cases

  • Autonomous Gameplay: Handles navigation, battle decision-making, and dialog management using a closed-loop system.
  • Visual & RAM Integration: Uses both RAM state for precise data and vision analysis for spatial awareness to prevent navigation errors.
  • Use Case: Perfect for testing agent capabilities in complex, state-dependent environments or for long-term automated gameplay sessions.

Quick Start

Start the pokemon-player skill by navigating to the agent directory and launching the game server with your 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 autonomous AI agent to play Pokemon on a headless GameBoy emulator?

To enable autonomous Pokemon gameplay, you need a pyboy headless emulator environment and a vision-capable model. The agent executes navigation, battle decisions, and dialog management using a closed-loop system with visual and RAM state feedback.

How does an AI agent verify game state when automating GameBoy emulator gameplay?

The agent verifies GameBoy emulator state by combining RAM state data with real-time vision analysis. This dual approach provides precise data for mechanics and spatial awareness to prevent navigation errors during complex gameplay.

Do I need a vision-capable model to automate Pokemon gameplay with pyboy?

Yes, a vision-capable model is required for spatial reasoning and navigation accuracy. The agent relies on visual analysis to understand the game environment and prevent spatial navigation errors during autonomous gameplay sessions.

What is the best way to manage save-states during long-term automated Pokemon gameplay?

The best way to manage save-states during long-term automated Pokemon gameplay is through the agent's integrated save-state management system. This supports complex navigation across various GameBoy ROMs while maintaining state-dependent environment consistency.

Can I use this approach to test agent capabilities in complex state-dependent environments?

Yes, you can use autonomous Pokemon gameplay to test agent capabilities in complex, state-dependent environments. The closed-loop system handles navigation and battle strategy, making it perfect for evaluating long-term automated decision-making.

Why does my AI agent make navigation errors during autonomous GameBoy gameplay?

Navigation errors during autonomous GameBoy gameplay typically occur when vision analysis is insufficient or spatial reasoning fails. The agent uses both RAM state and visual feedback to prevent these errors, requiring a vision-capable model for accurate spatial awareness.