Skip to content
Universal Modder Guides

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

  1. 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 -version

    What 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
  2. Add the skills using npx

    What to do

    Run the skills add command via npx pointing directly to the universal-modder repository URL.

    Command

    Command
    npx skills add https://github.com/rehan-remade/universal-modder

    What 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.

  3. Install the um CLI toolkit

    What to do

    When installing skills standalone without a full agent plugin, install the um Python 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-modder

    Using pipx:

    Command
    pipx install git+https://github.com/rehan-remade/universal-modder

    What you should see

    The um CLI is installed on your PATH. Run um --help to verify installed command groups.

    If something goes wrong

    If uv tool install fails, verify Python 3.10+ is installed and try the pipx alternative.

  4. Configure the fal API key for asset generation

    What to do

    If you want the agent or um fal to generate 2D sprites, textures, 3D models, or audio, set your fal API key in your environment.

    Command

    Windows terminal:

    Command
    setx FAL_KEY your_key

    macOS 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 setx so new processes receive the updated variable. You can use the skills without a fal key; asset generation will be skipped.

  5. Invoke mod-any-game in your agent

    What to do

    Invoke the mod-any-game skill 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 follow skills/mod-any-game/SKILL.md:

    Command

    Command
    Follow skills/mod-any-game/SKILL.md to mod this game

    What you should see

    The agent reads skills/mod-any-game/SKILL.md and begins the reconnaissance loop, queries the internal knowledge base, checks for anti-cheat, backs up saves, and creates MODLOG.md in 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, and ffmpeg -version return valid outputs.
  • Verify that um --help lists 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.md and verify that MODLOG.md is 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.