vgc-coach-claude

VGC Coach

VGC Coach is an open-source AI coaching assistant for Pokemon VGC (Video Game Championships).

It gives you a set of coaching tools — called skills — that run inside AI assistants like Codex, Claude Code, or OpenCode. Ask them in plain English to help with team building, meta research, lead planning, replay review, and other prep work.

This is not a standalone app or ladder client. The shared coaching logic lives in this repo, and the easiest way to use it now is through generated plugin packages for Codex, Claude Code, and OpenCode. Developers and contributors can still work directly from source; see How The Repo Works.

Open Source Status

• License: Apache-2.0
• Contributions: CONTRIBUTING.md
• Security reporting: SECURITY.md

Install As Plugin

The default end-user path is now generated plugin packages, not repo-local symlink wrappers.

Codex

Build and install the generated Codex package into your local marketplace:

git clone https://github.com/NoahJenkins/vgc-coach.git
cd vgc-coach
python3 tools/build_plugins.py build
python3 tools/install_codex_plugin.py

Restart Codex after install.

Claude Code

Add the repo marketplace, then install the packaged Claude plugin:

claude plugin marketplace add NoahJenkins/vgc-coach --sparse .claude-plugin plugins
claude plugin install vgc-coach-claude@vgc-coach

OpenCode

Add the git-installed plugin in opencode.json:

{
  "plugin": ["vgc-coach-opencode@git+https://github.com/NoahJenkins/vgc-coach.git"]
}

Restart OpenCode after editing the config.

Once installed, ask the AI tool in plain English:

• "Build me a Pokemon Champions team around Mega Blastoise."
• "Audit this team for bad matchups and weak slots."
• "Plan my leads into common rain and Trick Room teams."
• "Review this replay and tell me what mistakes actually mattered."
• "Give me a current meta snapshot before I build."

Install, update, and verification details live here:

• Codex runtime
• Claude Code runtime
• OpenCode runtime

Contribute From Source

If you want to edit skills, docs, evals, or runtime adapters directly, clone the repository and work from source:

git clone https://github.com/NoahJenkins/vgc-coach.git
cd vgc-coach

Contributor/source mode still uses the repo-local discovery wrappers:

• Codex — .agents/skills/
• Claude Code — .claude/skills/
• OpenCode — opencode.json, .opencode/skills/, and .opencode/commands/

Web Site Deployment

The project website lives in site/ and is deployed on Vercel from that directory.

• Production host: Vercel
• Vercel Root Directory: site
• Vercel config: site/vercel.json

When importing to Vercel, set the Root Directory to site so the build runs against the Vite app.

Prerequisites

This repo does not have a root application package to install for contributor/source work. The main requirements are:

• git to clone the repository
• a supported AI tool such as Codex, Claude Code, or OpenCode
• python3 if you want to use the optional exact-calc helper at tools/browser_damage_calc.py

Install Core Dependencies

macOS (Homebrew)

brew install git python node

Windows (PowerShell with winget)

winget install --id Git.Git -e
winget install --id Python.Python.3.12 -e
winget install --id OpenJS.NodeJS.LTS -e

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install -y git python3 python3-venv python3-pip nodejs npm

For other Linux distributions, install the equivalent packages from your distro's package manager.

Optional Setup

Exact Calc Helper

vgc-calcs-assistant can use python3 tools/browser_damage_calc.py for exact damage, KO, and survival checks. This requires a local agent-browser install (not included in this repo).

How The Repo Works

For contributors and developers — this section covers internal architecture. VGC players can skip to Skill Catalog.

• skills/ is the source of truth for all coaching logic. This is what you edit.
• plugins/ contains generated installable packages for Codex, Claude Code, and OpenCode.
• .agents/skills/, .claude/skills/, and .opencode/skills/ are thin wrappers that point AI tools to the shared packages in skills/.
• docs/skills/ contains examples and references that support the shared skills.
• data/fixtures/evals/ and data/rubrics/ are how skill quality is judged — test cases and scoring rubrics that changes must pass.
• docs/runtime/ documents AI-tool-specific behavior without duplicating the underlying skill logic.
• .agents/plugins/marketplace.json, .claude-plugin/marketplace.json, and the repo-root package.json are generated distribution metadata.