Agent skill

Pokemon Player

Automate Pokémon games via headless emulation + RAM reading. An agent skill from taracodlabs/aiden.

Apache-2.0Auto-check passed

Install Pokemon Player

skills CLI

$ npx skills add taracodlabs/aiden --skill pokemon-player -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden pokemon-player --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pokemon-player .claude/skills/pokemon-player && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "pokemon-player" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player into .claude/skills/pokemon-player/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pokemon-player", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add taracodlabs/aiden --skill pokemon-player -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden pokemon-player --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/pokemon-player .agents/skills/pokemon-player && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "pokemon-player" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player into .agents/skills/pokemon-player/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pokemon-player", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add taracodlabs/aiden --skill pokemon-player -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden pokemon-player --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/pokemon-player .cursor/skills/pokemon-player && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "pokemon-player" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player into .cursor/skills/pokemon-player/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pokemon-player", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/taracodlabs/aiden.git --path skills/pokemon-player

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add taracodlabs/aiden --skill pokemon-player -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden pokemon-player --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/pokemon-player .gemini/skills/pokemon-player && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "pokemon-player" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player into .gemini/skills/pokemon-player/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pokemon-player", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install taracodlabs/aiden pokemon-player

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add taracodlabs/aiden --skill pokemon-player -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/pokemon-player .github/skills/pokemon-player && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "pokemon-player" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player into .github/skills/pokemon-player/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pokemon-player", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add taracodlabs/aiden --skill pokemon-player -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden pokemon-player --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/pokemon-player .opencode/skills/pokemon-player && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "pokemon-player" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/pokemon-player into .opencode/skills/pokemon-player/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pokemon-player", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: pokemon-player
GitHub stars: 852
Token cost: ~1.1k tokens
SKILL.md length: 295 words
Files: 2
Skills in repo: 63
Repo updated: Sep 13, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Automate Pokémon games via headless emulation + RAM reading. An agent skill from taracodlabs/aiden.

Works in 6 steps: Install mGBA → Understand mGBA scripting (Lua) → Send button inputs via Lua → …
SKILL.md covers When to Use, How to Use, Examples and Cautions
Reaches mgba.io

What it does

Pokemon Player is an agent skill from taracodlabs/aiden. Automate Pokémon games via headless emulation + RAM reading

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

It works with Lua. The repository describes itself as: Aiden — an autonomous AI agent and work engine built solo. It can operate your browser, terminal, files, apps, APIs, skills and tools, remember context, recover from failures… The licence is Apache-2.0.

Example prompts

“/pokemon-player”

Requirements

Python 3

Workflow steps

6 steps, taken from the step headings in SKILL.md.

Install mGBA
Understand mGBA scripting (Lua)
Send button inputs via Lua
Automate shiny hunting (soft reset loop)
Read party Pokémon HP
Control mGBA from Python via socket

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are lua, powershell and python).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- mgba.io
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pokemon Player loads about 1.1k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 295 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~19
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 295 words, ~1,076 tokens.

Download SKILL.mdSave it as .claude/skills/pokemon-player/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: pokemon-player
description: Automate Pokémon games via headless emulation + RAM reading
category: gaming
version: 1.0.0
origin: aiden
license: Apache-2.0
tags: pokemon, emulator, gameboy, automation, mgba, rom, ram, scripting, gaming, bot

Pokémon Game Automation

Automate Pokémon games using mGBA (Game Boy Advance emulator) with scripting support. Read RAM state, inject button inputs, and build bots for grinding, breeding, or exploration.

When to Use

User wants to automate repetitive tasks in a Pokémon game (grinding, breeding, shiny hunting)
User wants to read game state (player position, party HP, item count) programmatically
User wants to build a battle or movement bot
User wants to run a headless emulator for scripted playthrough
User wants to replay a battle or scenario automatically

How to Use

1. Install mGBA

powershell

# Download mGBA from https://mgba.io/downloads.html
# Portable version — no install required
# Extract to C:\tools\mGBA\
# Verify
& "C:\tools\mGBA\mgba.exe" --version

2. Understand mGBA scripting (Lua)

mGBA has a built-in Lua scripting interface accessible via Tools → Scripting Console.

lua

-- Read a memory address (example: Pokémon FireRed player X position)
-- Addresses vary by game — look up RAM maps for your ROM
local playerX = memory.read8(0x02036E2C)
local playerY = memory.read8(0x02036E28)
print(string.format("Player position: %d, %d", playerX, playerY))

3. Send button inputs via Lua

lua

-- Simulate pressing A button
input.press("A")
emu.frameadvance()   -- advance one frame

-- Walk right 5 steps
for i = 1, 5 do
  input.press("Right")
  emu.frameadvance()
  emu.frameadvance()
end

4. Automate shiny hunting (soft reset loop)

lua

-- Pokémon FireRed shiny hunting — keep soft resetting until shiny found
-- Shiny flag address varies by game version
local SHINY_ADDR = 0x020244B0   -- example address

local resets = 0
while true do
  local isShiny = memory.read8(SHINY_ADDR)
  if isShiny == 1 then
    print(string.format("SHINY FOUND after %d resets!", resets))
    break
  end
  resets = resets + 1
  -- Soft reset: L+R+Start+Select
  input.press("L"); input.press("R"); input.press("Start"); input.press("Select")
  emu.frameadvance()
  emu.reset()
end

5. Read party Pokémon HP

lua

-- FireRed/LeafGreen party struct base addresses (Gen 3)
local PARTY_BASE = 0x02024284
local STRUCT_SIZE = 100   -- bytes per Pokémon in party

for slot = 0, 5 do
  local base   = PARTY_BASE + slot * STRUCT_SIZE
  local species = memory.read16(base + 0)
  local hpCurr  = memory.read16(base + 56)
  local hpMax   = memory.read16(base + 58)
  if species > 0 then
    print(string.format("Slot %d: species=%d HP=%d/%d", slot+1, species, hpCurr, hpMax))
  end
end

6. Control mGBA from Python via socket

mGBA can expose a scripting socket for external control:

lua

-- mGBA side: open a socket and listen
local sock = socket.tcp()
sock:bind("127.0.0.1", 8888)
sock:listen(1)
local client = sock:accept()
while true do
  local cmd = client:receive("*l")
  if cmd == "press_a" then input.press("A") end
  emu.frameadvance()
end

python

import socket, time

s = socket.socket()
s.connect(("127.0.0.1", 8888))

def press(btn):
  s.sendall(f"press_{btn}\n".encode())
  time.sleep(0.05)

press("a")
press("right")

Examples

"Automate grinding by walking in tall grass until party is fainted" → Use step 3 to loop walking movements. Read party HP from step 5 to detect all fainted.

"Count how many soft resets it takes to find a shiny Starter" → Use step 4 with the game's shiny flag address. It increments the counter and stops on shiny.

"Read my current party's HP and print a status report" → Use step 5 inside the mGBA Lua scripting console.

Cautions

ROM files are copyrighted — only use ROMs of games you legally own
RAM addresses differ between game versions (FireRed v1.0 vs v1.1, Japanese vs English) — verify with RAM maps from romhacking.net
mGBA Lua API differs from older emulators (VBA-M, BizHawk) — code is not directly portable
Automated soft-reset loops run very fast — add frame limits to avoid 100% CPU usage
mGBA's socket scripting is not enabled by default — must be started from Tools → Scripting

Files

SKILL.md and 1 other file in skills/pokemon-player of taracodlabs/aiden.

SKILL.md
skill.json

Open the folder on GitHubat commit 3704204

Compare with similar skills

Pokemon Player next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Pokemon Player compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Pokemon Player this skilltaracodlabs/aiden	852	—	~1.1k	Automated safety check: Pass	Apache-2.0	26 days ago
Pandoc DOCX TemplateAchuan-2/pandoc_docx_template	1.1k	—	~1k	Automated safety check: Pass	None	3 mo ago
Add Lua Binding Simplecataclysmbn/Cataclysm-BN	1.3k	—	~846	Automated safety check: Pass	Custom licence	today
Cpp Compiler FlagsSerial-Studio/Serial-Studio	7.2k	—	~2.1k	Automated safety check: Pass	Custom licence	today
Agentic GitHub Discussioncarlos-algms/agentic.nvim	641	—	~1.1k	Automated safety check: Pass	MIT	today
Luamakeactboy168/luamake	210	—	~2k	Automated safety check: Pass	MIT	yesterday

Similar skills

Pandoc DOCX Template
Achuan-2/pandoc_docx_template
A skill your agent uses when converting Markdown to Word DOCX or DOCX back to Markdown with Pandoc, especially when the output should use the bundled Chinese Word reference templates, heading…
1.1k GitHub stars~1k tokensUpdated 3 mo ago
Documents & OfficeAuto-check passed
Add Lua Binding Simple
cataclysmbn/Cataclysm-BN
Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types.
1.3k GitHub stars~846 tokensUpdated today
Auto-check passed
Cpp Compiler Flags
Serial-Studio/Serial-Studio
C++ compiler/linker flag guidance for Serial Studio's build (GCC, Clang, AppleClang, MSVC cl.exe, clang-cl, MinGW, IntelLLVM).
7.2k GitHub stars~2.1k tokensUpdated today
DevelopmentAuto-check passed
Agentic GitHub Discussion
carlos-algms/agentic.nvim
A skill your agent uses when creating, listing, or managing GitHub discussions in carlos-algms/agentic.nvim repository
641 GitHub stars~1.1k tokensUpdated today
Auto-check passed
Luamake
actboy168/luamake
Luamake 构建系统指南——用于当前项目的 luamake / make.lua / Ninja 生成流程。当用户需要编写、修改、排查或理解 make.lua、目标定义、lm:conf、deps / objdeps、代码生成、Lua C 模块、Bee 运行时集成，或需要解决当前项目中由 luamake 驱动的构建问题时，使用此 skill。即使用户没有明确提到…
210 GitHub stars~2k tokensUpdated yesterday
Auto-check passed
Lua Eco
zhaojh329/lua-eco
International lua-eco public API skill for writing, reviewing, explaining, and fixing Lua 5.4 code that runs on the eco runtime.
103 GitHub stars~1.7k tokensUpdated today
Backend & APIsAuto-check passed

Questions about Pokemon Player

What does Pokemon Player do?

Automate Pokémon games via headless emulation + RAM reading. An agent skill from taracodlabs/aiden. Pokemon Player is an agent skill from taracodlabs/aiden.

How do I install Pokemon Player in Claude Code?

Run `npx skills add taracodlabs/aiden --skill pokemon-player -a claude-code`. Or copy the skill folder (skills/pokemon-player in taracodlabs/aiden) into .claude/skills/pokemon-player in your project. Claude Code loads it when a task matches its description.

How do I install Pokemon Player in Codex?

Run `npx skills add taracodlabs/aiden --skill pokemon-player -a codex`. Or copy the skill folder (skills/pokemon-player in taracodlabs/aiden) into .agents/skills/pokemon-player in your project. Codex loads it when a task matches its description.

Can I use Pokemon Player in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add taracodlabs/aiden --skill pokemon-player -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pokemon-player, .gemini/skills/pokemon-player, .github/skills/pokemon-player and .opencode/skills/pokemon-player in your project.

What does Pokemon Player need to run?

SKILL.md names no scripts, command-line tools or credentials: Pokemon Player is instructions for the agent only. Our summary lists: Python 3.

Does Pokemon Player access the network?

SKILL.md names 1 domain. In commands or code: mgba.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Pokemon Player safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Pokemon Player use?

Pokemon Player is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pokemon Player use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Pokemon Player?

Skills that share tags, products or a category with Pokemon Player: Pandoc DOCX Template (Achuan-2/pandoc_docx_template, 1.1k stars), Add Lua Binding Simple (cataclysmbn/Cataclysm-BN, 1.3k stars), Cpp Compiler Flags (Serial-Studio/Serial-Studio, 7.2k stars) and Agentic GitHub Discussion (carlos-algms/agentic.nvim, 641 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pokemon Player?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 852 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

Source: taracodlabs/aiden on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Pokemon Player

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Pokémon Game Automation

When to Use

How to Use

1. Install mGBA

2. Understand mGBA scripting (Lua)

3. Send button inputs via Lua

4. Automate shiny hunting (soft reset loop)

5. Read party Pokémon HP

6. Control mGBA from Python via socket

Examples

Cautions

Files

Compare with similar skills

Similar skills

More from taracodlabs/aiden

Related

Questions about Pokemon Player