install / plain-skills
How to install Universal Modder skills with npx
Quick answer
Install the universal-modder skills using a single npx command, set up the CLI tools, and start modding PC games with any compatible AI agent in about five minutes. The skill files and um CLI are free; AI agent execution depends on your agent’s model costs, and fal asset generation is a separate paid service.
Prerequisites
- A single-player PC game you legally own, within the usage boundary below.
- An environment with npx available to run the skills installation command.
- An AI coding agent that supports the Agent Skills standard or reads local skills.
- Python 3.10+ and ffmpeg installed; uv is recommended.
- A separate mod working folder on your system.
- A fal account and API key if you want generated sprites, 3D models, or audio.
- Blender if you need to render 3D models into game-ready sprites.
Steps: how to install Universal Modder skills with npx
-
Check environment prerequisites
What to do
Open a terminal in your mod working folder. Check that Python, uv, and ffmpeg are installed and accessible on PATH. To run
npx, ensure a working Node.js runtime is present on your system.Command
Command python --version uv --version ffmpeg -versionWhat you should see
Each command outputs its installed version number.
If something goes wrong
If Python, uv, or ffmpeg are missing on Windows, install them using winget and open a new terminal. If npx is not recognized on Windows, install Node.js using your operating system’s standard package manager.
Command winget install Python.Python.3.12 winget install astral-sh.uv winget install Gyan.FFmpeg -
Add the skills using npx
What to do
Run the
skills addcommand via npx pointing directly to the universal-modder repository URL.Command
Command npx skills add https://github.com/rehan-remade/universal-modderWhat you should see
The command installs the universal-modder skills into your agent’s recognized skills location (such as
.agents/skills).If something goes wrong
If npx reports an error or cannot connect, verify your internet connection and confirm Node.js and Git are installed.
-
Install the um CLI toolkit
What to do
When installing skills standalone without a full agent plugin, install the
umPython CLI globally using uv or pipx so your agent can execute modding subcommands.Command
Using uv:
Command uv tool install git+https://github.com/rehan-remade/universal-modderUsing pipx:
Command pipx install git+https://github.com/rehan-remade/universal-modderWhat you should see
The
umCLI is installed on your PATH. Runum --helpto verify installed command groups.If something goes wrong
If
uv tool installfails, verify Python 3.10+ is installed and try the pipx alternative. -
Configure the fal API key for asset generation
What to do
If you want the agent or
um falto generate 2D sprites, textures, 3D models, or audio, set your fal API key in your environment.Command
Windows terminal:
Command setx FAL_KEY your_keymacOS or Linux terminal:
Command export FAL_KEY=...What you should see
fal displays your new key once upon creation, so save it securely.
If something goes wrong
On Windows, restart your terminal after running
setxso new processes receive the updated variable. You can use the skills without a fal key; asset generation will be skipped. -
Invoke mod-any-game in your agent
What to do
Invoke the
mod-any-gameskill in your agent. Because different agents discover skills through different mechanisms (.agents/skills, local skill folders, or system prompts), follow your agent’s skill invocation method or instruct it to followskills/mod-any-game/SKILL.md:Command
Command Follow skills/mod-any-game/SKILL.md to mod this gameWhat you should see
The agent reads
skills/mod-any-game/SKILL.mdand begins the reconnaissance loop, queries the internal knowledge base, checks for anti-cheat, backs up saves, and createsMODLOG.mdin your mod folder.If something goes wrong
The agent asks before driving mouse and keyboard input, installing loaders into game folders, changing the registry, or publishing. It explicitly refuses to bypass anti-cheat, DRM, or game ownership checks.
Verify it worked
- Confirm that
python --version,uv --version, andffmpeg -versionreturn valid outputs. - Verify that
um --helplists the toolkit CLI command groups. - Confirm that the skill files are present in your agent’s skills directory.
- Instruct your agent to follow
skills/mod-any-game/SKILL.mdand verify thatMODLOG.mdis created in your working folder. - Test the resulting mod directly in the real game client yourself.
FAQ
How do I install Universal Modder skills for any agent?
Run npx skills add https://github.com/rehan-remade/universal-modder, in your terminal to install the skills directly into your agent’s compatible skills folder.
Can I use Universal Modder skills without a fal API key?
Yes. You can inspect game engines, reverse engineer files, back up saves, and edit code without fal. An API key is only required if you want the agent or um fal to generate 2D/3D assets or audio.
Do I need a paid tool or subscription to use the skills?
The skill files and the um CLI are completely free and open source under the MIT license. Inference costs depend on whichever AI agent model you use, and fal asset generation requires paid credits.
What should I do if the npx skills command fails with network timeout?
Ensure Node.js and npm are functioning properly, and check if your corporate or local proxy blocks GitHub API calls. You can retry npx skills add https://github.com/rehan-remade/universal-modder with a stable network connection.
How do I direct my AI agent to use specific modding skill files?
In agents that do not auto-discover skills from manifests, point the agent directly to the path of the skill entrypoint. For instance, instruct the agent to read and follow skills/mod-any-game/SKILL.md before asking it to analyze game code.