README

Skills, tools and a shared knowledge base that let any AI coding agent mod almost any PC game you own.
  The agent finds the game, works out the engine and the route, reads the real code, builds the mod, makes art, 3D and sound
  with fal, tests it in the running game, cuts the video, and writes down what it learned for the next agent.



  
  
  
  
  



  


Coming next: the mod hub at universalmodder.com. Publish your mods, remix other people's, and make new ones.
  Share what you make, get help, and follow along:

  


 Install

Pick your agent. Each gets the same skills (Agent Skills format), the fal MCP server, and the um CLI.

| Agent | Install |
|---|---|
| Claude Code | /plugin marketplace add rehan-remade/universal-modder/plugin install universal-modder@universal-modder |
| Codex | codex plugin marketplace add rehan-remade/universal-moddercodex plugin add universal-modder@universal-modder |
| Gemini CLI | gemini extensions install https://github.com/rehan-remade/universal-modder |
| VS Code / Copilot | Enable chat.plugins.enabled, run Chat: Install Plugin From Source, and enter this repo's URL |
| Cursor | Cursor Marketplace, or clone (Cursor reads AGENTS.md and .cursor/mcp.json) |
| OpenCode | Clone and run opencode inside it (opencode.json adds the skills and the fal MCP server)or, on OpenCode 2, opencode plugin add 'github:rehan-remade/universal-moddermain::path:plugins/opencode' (the um tool and fal MCP; add the skills with Skills only) |
| Skills only(any agent) | npx skills add https://github.com/rehan-remade/universal-modder |
| Anything else | git clone https://github.com/rehan-remade/universal-modder and start your agent inside it |

Inside a clone, each agent finds the skills where it looks for them: .agents/skills (Codex, Gemini CLI,
Copilot, Cursor, OpenCode) and .claude/skills (Claude Code) are copies of skills/. Instructions are in
AGENTS.md, which CLAUDE.md and GEMINI.md point to. MCP config is in .mcp.json, .codex/config.toml,
.cursor/mcp.json, .vscode/mcp.json and opencode.json (which also points OpenCode at skills/).

Without a clone, OpenCode 2 installs the plugin in plugins/opencode/ with opencode plugin add: one
um_run tool that passes its arguments straight to the CLI and runs um from PATH (see below), plus the
fal MCP server when FAL_KEY is set and none is configured. A clone doesn't need it. See
plugins/opencode/README.md.

The um CLI. The Claude Code plugin puts it on PATH (its SessionStart hook), and so does a clone opened in
Claude Code (.claude/settings.json); in a clone with another agent, export PATH="$PWD/bin:$PATH". Other
agents' plugin installs (Codex, Cursor, Gemini CLI, OpenCode) don't, so install it once:
bash
uv tool install git+https://github.com/rehan-remade/universal-modder      or: pipx install git+...

For assets, get a fal API key. It powers both the fal MCP server and
um fal. Rather than exporting it from a shell profile or a .env, store it once with um fal key set: on
Linux it goes into the 

Top issues