pokemon-player

Automate Gen 1 Pokemon gameplay via PyBoy headless emulation.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill pokemon-player-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pokemon-player
Source: https://github.com/Signmanal/VIGIL/tree/main/optional-skills/gaming/pokemon-player
Command: npx skills add https://github.com/Signmanal/VIGIL --skill pokemon-player-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually playing classic Pokemon games requires constant input and attention, which is tedious for long playthroughs, testing, or watching AI-driven gameplay. This Skill automates the entire process using headless emulation and AI vision to navigate, battle, and progress through the game without manual controller input.

Core Features & Use Cases

  • Headless Emulator Integration: Runs Gen 1 Pokemon games (Red, Blue, Yellow, etc.) via the PyBoy emulator with full RAM state access for real-time game data.
  • AI-Powered Gameplay Loop: Combines screenshot vision analysis and RAM state checks to navigate maps, handle dialog, win battles, and progress through story milestones automatically.
  • Progress Tracking & Save Management: Automatically saves game states at key milestones, tracks objectives and team stats in memory, and supports loading previous saves to retry sections.
  • Use Case Example: Use this Skill to run an automated playthrough of Pokemon Red, track progress through all gym badges, and stream the live gameplay to a browser dashboard for viewing.

Quick Start

Use the pokemon-player skill to start an automated playthrough of your Pokemon Red ROM file and stream the live gameplay dashboard to your browser.

Frequently Asked Questions about pokemon-player

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

FAQPage Schema
How do I automate Pokemon gameplay using a headless emulator?

You can automate Pokemon gameplay by running a valid ROM file through the PyBoy emulator, which uses AI vision and RAM state analysis to handle navigation, battles, and story progression without manual input.

How does AI vision handle battles and navigation in Pokemon Red?

AI vision in Pokemon Red combines screenshot analysis with real-time RAM state checks to interpret maps, manage dialog, win battles, and automatically track progress through story milestones.

Do I need a specific ROM file to run an automated Pokemon playthrough?

Yes, you must provide a valid user-provided Pokemon ROM file. The automated playthrough also requires setting up a local pokemon-agent runtime to execute the headless emulation loop.

Can I stream automated Pokemon gameplay to a browser dashboard?

Yes, you can stream automated Pokemon gameplay to a live browser dashboard. Optional SSH reverse tunneling is supported to enable remote access for viewing the headless emulation session.

Does automated Pokemon gameplay track progress and save game states?

Automated Pokemon gameplay automatically saves game states at key milestones, tracks objectives and team stats in memory, and supports loading previous saves to retry difficult sections.

What are the limitations of using AI for headless Pokemon emulation?

Headless Pokemon emulation is limited to Gen 1 titles like Red, Blue, and Yellow. It requires a local runtime setup and a valid ROM file, relying on PyBoy emulator compatibility for automated progression.