# infinite-pokemon

Adopt this skill: https://proskills.md/skills/other/shellishack-infinite-pokemon-skills-infinite-pokemon

Page: https://proskills.md/skills/other/shellishack-infinite-pokemon-skills-infinite-pokemon
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/infinite-pokemon/SKILL.md
size: 6316
sha: bd9efd54e185ef12b10d91395375b56b45f5ec9c
upstream: https://github.com/shellishack/infinite-pokemon/blob/main/skills/infinite-pokemon/SKILL.md

````text
---
name: infinite-pokemon
description: Set up and start Infinite Pokémon when a user asks to install, play, or launch the game with their AI assistant. Clone missing game files, install dependencies, build, and launch the local desktop or browser game; not for background map or NPC generation jobs.
license: MIT-0
metadata:
  author: Shellishack
  version: "0.3.0"
  homepage: https://github.com/Shellishack/infinite-pokemon
  repository: https://github.com/Shellishack/infinite-pokemon
---

# Set up and play Infinite Pokémon

When the user asks to play, carry out setup and launch using the available terminal tools. Installing this skill only installs instructions; it does not install or start the game by itself.

## 1. Locate or obtain the game

Use the user's selected checkout if available. A complete checkout contains `package.json` with name `infinite-pokemon`, `game/client/index.html`, `game/content/tutorial-world.json`, `desktop/main.cjs`, and the generation skills under `skills/`.

If the game or required project files are missing, first clone the complete [source repository](https://github.com/Shellishack/infinite-pokemon) into a new directory in the user's workspace:

```sh
git clone https://github.com/Shellishack/infinite-pokemon.git
cd infinite-pokemon
```

Do not clone over an existing directory or overwrite saves/uncommitted edits. Reuse a complete checkout without resetting or automatically pulling over local work. If an incomplete checkout exists, choose a distinct destination and tell the user which one you used. If cloning fails, report the concrete error rather than fabricating files.

Read the cloned `README.md`, or `README.zh-CN.md` for Chinese instructions, and any applicable repository instructions before proceeding. Use its current setup requirements if they differ from the baseline below.

## 2. Check requirements and build

Check `git --version`, `node --version`, and `npm --version`. The baseline requires Node.js 22.13 or newer. A missing prerequisite is a specific setup blocker: use the user's established installation method or explain what needs installing; do not silently replace an existing system runtime. Docker is optional and is not needed for local play.

From the checkout, install the locked dependencies and build:

```sh
npm ci
npm run build
```

Reuse a valid installed environment when restarting an unchanged checkout. If a command fails, inspect its error and fix the relevant setup issue before proceeding. Do not bypass failing checks or claim a successful launch merely because a process spawned.

Codex CLI is included in the project dependencies; a global installation is unnecessary. Do not copy provider credentials into the repository.

## 3. Launch the requested experience

For a local graphical desktop, launch:

```sh
npm run desktop
```

Use `npm run desktop:fullscreen` when the user requests fullscreen. Keep the launcher/server alive using the environment's supported background-process or persistent-terminal facility. On Windows, keep helper terminal windows hidden while allowing the requested Electron game window to appear.

If a desktop GUI is unavailable or the user prefers a browser, use `npm start` and open `http://127.0.0.1:8788`. Check the server's startup output and `/api/info` before reporting that it is ready. Electron chooses available ports by default; use its displayed address rather than assuming 8788. If another instance is already running, reuse it only after confirming it belongs to this game and the intended save directory. Do not kill unrelated processes to free ports.

No-install option: open the hosted browser demo at https://infinite-pokemon-blond.vercel.app/game/ (site: https://infinite-pokemon-blond.vercel.app/). It runs the five prepared tutorial maps entirely in the browser, autosaves locally, and can export progress as a portable save for import into the full game via the host-only import action in SAVES. The demo needs no Codex connection, account, or setup.

Keep default save locations unless the user specifies one. Do not reset the game, delete databases, or start extra servers against the same data directory. Explain the actual checkout and launch mode in the completion message.

## 4. Enter the game

The title offers Single player and Multiplayer. For generated exploration, the host connects Codex and accepts the game's token-use notice. Let the user complete provider sign-in if necessary; never bypass consent, change allowance settings, or enable a test harness to simulate a live connection. Remembered approvals are checked by the game itself.

Offer **Single player → Play tutorial preview** when the user wants to try it without Codex. Preview has five prepared maps and makes no model calls. Multiplayer guests join by the host's address and do not need their own Codex connection. Start a private single-player game by default; enable guest access only when requested.

Controls: hold WASD/arrows to move, face adjacent objects and press E/Space to interact, Escape opens/closes menus, and F11 toggles desktop fullscreen. The game includes its region, NPC and interior generation skills; users do not need to separately install those to play.

## Installation and provenance

Install this entry skill with:

```sh
npx skills add Shellishack/infinite-pokemon --skill infinite-pokemon
```

Then ask the AI: **“Use $infinite-pokemon to set up and start the game for me.”** The Skills CLI requires a repository source; the bare `npx skills add infinite-pokemon` is not a supported global alias.

- [Repository and getting started](https://github.com/Shellishack/infinite-pokemon#readme)
- [Website and browser demo](https://infinite-pokemon-blond.vercel.app/)
- [Chinese README](https://github.com/Shellishack/infinite-pokemon/blob/main/README.zh-CN.md)
- [Generation skills](https://github.com/Shellishack/infinite-pokemon/tree/main/skills)
- [Issues](https://github.com/Shellishack/infinite-pokemon/issues)
- [Project disclaimer](https://github.com/Shellishack/infinite-pokemon/blob/main/DISCLAIMER.md)

This instruction bundle uses [MIT-0](LICENSE). It excludes game code, artwork, saves and provider credentials. The game is an educational, non-commercial fan project created with Codex; third-party material retains its own ownership and terms.
````

## File: skills/infinite-pokemon/agents/openai.yaml
size: 200
sha: 52b0743959550cde437a30b40aaa9dea3b42e683
upstream: https://github.com/shellishack/infinite-pokemon/blob/main/skills/infinite-pokemon/agents/openai.yaml

```text
interface:
  display_name: "Infinite Pokémon"
  short_description: "Set up and launch your Infinite Pokémon adventure"
  default_prompt: "Use $infinite-pokemon to set up and start the game for me."
```

## File: skills/infinite-pokemon/LICENSE
size: 910
sha: 96f101b8e81b2691275dc6a06dde04c7a1244392
upstream: https://github.com/shellishack/infinite-pokemon/blob/main/skills/infinite-pokemon/LICENSE

```text
MIT No Attribution

Copyright (c) 2026 Ellis Shang

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
```

## File: README.md
upstream: https://github.com/shellishack/infinite-pokemon/blob/main/README.md

````text
# Infinite Pokémon

The [website and browser demo](https://infinite-pokemon-blond.vercel.app) are maintained in the separate `Shellishack/infinite-pokemon-website` repository. This repository builds the standalone local/Electron game with Vite; its entry is `/game/` (the root remains a compatibility entry). Website deployment is independent of game releases.

The game reports a small public progress summary to the website leaderboard: trainer name, tutorial milestone, map/species/capture/trainer counts, explored tiles, and steps. It does not upload saves, party details, journal text, credentials, or Codex data. Reports never block gameplay and the community leaderboard is not a cheat-proof competition.

**English** | [简体中文](README.zh-CN.md) · [Website & browser demo](https://infinite-pokemon-blond.vercel.app/) · [Discord](https://discord.gg/kKbY8xaVxG) · [GitHub repository](https://github.com/Shellishack/infinite-pokemon) · [Technical report v0.4 (PDF, provisional)](docs/technical-report/Infinite-Pokemon-Technical-Report-v0.4.pdf)

## Start here

```sh
npx skills add Shellishack/infinite-pokemon --skill infinite-pokemon
```

Then ask Codex (or your compatible AI assistant): **“Use $infinite-pokemon to set up and start the game for me.”** The entry skill clones any missing files, checks prerequisites, installs dependencies, builds, and launches the game.

Installing a skill does not launch software by itself. The Skills CLI requires a repository source; the bare `npx skills add infinite-pokemon` is not a supported global alias. [Entry skill](skills/infinite-pokemon/SKILL.md).

![Infinite Pokémon](game/assets/branding/infinite-pokemon-logo.svg)

**The adventure never ends.**

[Play the browser demo](https://infinite-pokemon-blond.vercel.app/game/) · [Run from source](#run-on-your-computer) · [Explore the skills](#download-the-skills)

![Infinite Pokémon intro: gameplay becomes context for Codex to create the next part of your adventure](docs/assets/infinite-pokemon-intro.gif)

*Watch the 35-second intro: play, build a shared history, and let Codex help create what comes next.*

Infinite Pokémon explores a simple idea: a game world can keep being written as you play. Walk toward a new horizon, and a local AI harness uses the history of your adventure to propose what comes next—places, characters, conversations, and story hooks. Return to a place you know, and it should remain part of the same world, with your progress and consequences intact.

This is a playable TypeScript prototype of that idea, presented as a Pokémon-style pixel-art creature-catching RPG powered by an AI harness. The goal is a continuing adventure shaped by play, with familiar controls and dependable game rules. Open-ended generation is the ambition; finite storage, generation time, provider limits, and the current engine's vocabulary still constrain every run.

## See the game

| Explore a persistent world | Battle and collect companions |
| --- | --- |
| ![Exploring the overworld in Infinite Pokémon](game/assets/showcase/exploration.png) | ![A turn-based battle in Infinite Pokémon](game/assets/showcase/battle.png) |

| Visit furnished interiors | Return to a world that remembers |
| --- | --- |
| ![Inside Professor Fern's laboratory](game/assets/showcase/interior.png) | ![Persistent places shown on the town map](game/assets/showcase/continuity.png) |

The no-install browser demo includes five prepared areas, battles, catching, interiors, and local autosave. Full play connects the local game to Codex so the world can keep growing. Multiplayer lets friends share the host's world while only the host supplies the generation allowance.

> **Educational and non-commercial use only.** This is an experimental fan project, not an official Pokémon product. It is not affiliated with or endorsed by Nintendo, Creatures, GAME FREAK, or The Pokémon Company.
>
> **Generated by Codex.** This repository was generated by OpenAI Codex from loosely sketched ideas supplied by a human. Third-party dependencies and reference assets were incorporated into the project; they were not created by Codex and retain their respective ownership and license terms. See [DISCLAIMER.md](DISCLAIMER.md) and [asset credits](game/assets/classic/CREDITS.md).

## Download the skills

The setup skill and all three generation skills are published in these registries:

| Source | Quick-start skill | All four skills |
| --- | --- | --- |
| **skills.sh** | [infinite-pokemon](https://skills.sh/shellishack/infinite-pokemon/infinite-pokemon) | [region](https://skills.sh/shellishack/infinite-pokemon/infinite-pokemon-region) · [NPC](https://skills.sh/shellishack/infinite-pokemon/infinite-pokemon-npc) · [interior](https://skills.sh/shellishack/infinite-pokemon/infinite-pokemon-interior) |
| **ClawHub** | [Infinite Pokémon Quick Start](https://clawhub.ai/shellishack/skills/infinite-pokemon) | [region](https://clawhub.ai/shellishack/skills/infinite-pokemon-region) · [NPC](https://clawhub.ai/shellishack/skills/infinite-pokemon-npc) · [interior](https://clawhub.ai/shellishack/skills/infinite-pokemon-interior) |
| **skills.re** | [infinite-pokemon](https://skills.re/skills/Shellishack/infinite-pokemon/infinite-pokemon) | [region](https://skills.re/skills/Shellishack/infinite-pokemon/infinite-pokemon-region) · [NPC](https://skills.re/skills/Shellishack/infinite-pokemon/infinite-pokemon-npc) · [interior](https://skills.re/skills/Shellishack/infinite-pokemon/infinite-pokemon-interior) |
| **GitHub** | [source folder](skills/infinite-pokemon/SKILL.md) | [v0.2.0 ZIP downloads](https://github.com/Shellishack/infinite-pokemon/releases/tag/skills-v0.2.0) |

[SkillsMP](https://skillsmp.com/search?q=infinite-pokemon) was also submitted through its documented GitHub-topic indexing route, but no listing is visible yet. It is not currently a download source. See the [publication status and license notes](docs/SKILL-DISTRIBUTION.md).

## How the adventure continues

1. **Play in an authoritative world.** The server handles movement, collision, battles, inventory, and progression. An AI suggestion cannot award itself a victory or move your trainer.
2. **Remember what actually happened.** Each run stores maps, choices, NPC memories, and an event history. The server exports an immutable local snapshot for the generation skill to read.
3. **Prepare the next places.** Your host's Codex proposes content from that snapshot. Schemas, map validation, and dependency checks decide what can enter the game. Visited places stay stable.
4. **Generate ahead, or wait deliberately.** A configurable depth of 0–3 controls map preparation. Depth 1 is the default. Generation batch size defaults to three simultaneous blocks and can be set to 1–8 in Session; choose one for sequential work. Cached maps are reused; unfinished destinations show real queue/generation status with retry and cancel controls.
5. **Choose another future.** Create a checkpoint, keep playing, or branch from an earlier one. A branch gets its own world database and generation context. Later events in the original run do not become memories in the new branch.

In multiplayer, friends explore the same run and share its world history. Only the host connects Codex and supplies the generation allowance. Other runs and checkpoint branches remain separate worlds.

## What exists today—and what comes next

| Area | Current prototype | Direction for future development |
| --- | --- | --- |
| World generation | Persistent template maps, generated stories, biome choices, greetings, hooks, and bounded terrain features | Richer terrain geometry and more varied environments |
| Continuity | Run-scoped history, NPC memory, neighboring edge/surface context, and stale-proposal checks | Measured long-term narrative coherence and enforced gradual terrain transitions |
| Characters | Persistent creature/NPC traits, generated species profiles, hybrid eggs, and bounded NPC intentions | More expressive agents with explicit, test
````
