# Fal Assets

Generate game assets with fal (fal.ai) through the fal MCP server, the `um fal` CLI...

- Repository: https://github.com/rehan-remade/universal-modder (9317 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rehan-remade/universal-modder --skill fal-assets -g -a claude-code -y`
Codex: `npx skills add rehan-remade/universal-modder --skill fal-assets -g -a codex -y`
Cursor: `npx skills add rehan-remade/universal-modder --skill fal-assets -g -a cursor -y`
Gemini CLI: `npx skills add rehan-remade/universal-modder --skill fal-assets -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rehan-remade/universal-modder`

## Description

Generate game assets with fal (fal.ai) through the fal MCP server, the `um fal` CLI (REST) or `fal api`. Covers sprites and icons with transparent backgrounds, consistent variants and animation frames, pixel art, seamless textures, PBR material maps, image-to-3D models, remeshing, auto-rigging, sound effects, music, voice lines, and trailer or cutscene video. Use whenever a mod needs new art, audio or 3D models, or the user mentions fal, generating sprites, textures, models, SFX or music for a game.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Game assets with fal

fal runs hundreds of generative models behind one API key. Use it whenever the mod needs something that
doesn't exist yet: a weapon sprite, a boss, a unit rendered from 16 angles, a tileable floor, a laser sound,
boss music, a voiced line.

## Setup (check once per session)
- **Key.** Create one at https://fal.ai/dashboard/keys. `um fal` takes `FAL_KEY` from the environment first,
  then the key the human stored with `um fal key set` (a hidden prompt: the desktop keyring on Linux, through
  libsecret's `secret-tool`; an owner-only `~/.secrets/fal-key` where there's no `secret-tool`), then
  `FAL_KEY=...` in a `.env` in the working folder. `um fal key status` shows which source is used, with keys
  masked. Never write the key into mod files or configs; `um publish check` flags leaked keys.
- **MCP.** fal's hosted MCP server is `https://mcp.fal.ai/mcp` with header `Authorization: Bearer $FAL_KEY`.
  The repo pre-configures it for each agent:
  - Claude Code: `.mcp.json`
  - Codex: `.codex/config.toml`
  - Cursor: `.cursor/mcp.json`
  - VS Code/Copilot: `.vscode/mcp.json`
  - Gemini CLI: `gemini-extension.json`
  - OpenCode: `opencode.json`

  They read `FAL_KEY` from the agent's environment, and without it the server doesn't connect. If the fal
  MCP tools are missing, use `um fal` meanwhile and tell the human. They can start the agent with `FAL_KEY`
  set (on Linux, from the keyring:
  `export FAL_KEY="$(secret-tool lookup service fal.ai key api)"`), or add fal's OAuth endpoint, which takes
  a browser sign-in instead of a key:
  - Claude Code: `claude mcp add --transport http fal-oauth https://mcp.fal.ai/mcp-relay`, then
    Authenticate it in `/mcp`
  - Codex: `codex mcp add fal-oauth --url https://mcp.fal.ai/mcp-relay`, then `codex mcp login fal-oauth`
  - anything else: a Streamable HTTP server at `https://mcp.fal.ai/mcp-relay` with OAuth and no header
    (https://fal.ai/docs/documentation/setting-up/mcp)

The rest: https://github.com/rehan-remade/universal-modder/blob/HEAD/.agents/skills/fal-assets/SKILL.md