@genex-ai/cli-demo 1.32.3 → 1.33.0-dev.684

package/README.md

@@ -1,6 +1,6 @@
 # @genex-ai/cli-demo
 
-Set up your `~/.claude` workspace, authorize, create a game project, and publish.
+Install the Genex skills into your project's agent workspaces, authorize, create a game project, and publish.
 This is the `cli` app of the [genex monorepo](../../README.md).
 
 ```bash
@@ -55,9 +55,11 @@ as the latest available snapshot.
 `genex init` does four things:
 
 1. **Installs the skills for your coding agents** — copies the bundled templates
-   into every agent it detects: Claude Code (`~/.claude`, full set incl.
-   agents/ + commands/), Codex (`~/.codex/skills`), and Cursor
-   (`~/.cursor/skills`). genex-owned skills (`genex-*`) are **always refreshed**
+   PROJECT-LOCALLY into every agent workspace it detects: Claude Code
+   (`<project>/.claude`, full set incl. agents/ + commands/), Codex
+   (`<project>/.codex/skills`), and Cursor (`<project>/.cursor/skills`). The
+   CLI never writes agent state into your home directory — only the token and
+   caches live in `~/.genex`. genex-owned skills (`genex-*`) are **always refreshed**
    to the package version so a stale copy can't linger; your own files are never
    overwritten. After init, **every** `genex` command re-syncs them to the
    installed CLI version automatically (printing `🔄 Genex skills updated to
@@ -113,15 +115,19 @@ downloaded or committed:
 | Command | Provider | Prints (role) |
 | --- | --- | --- |
 | `genex model "<prompt>"` | Tripo | `…/generations/<id>/model-glb` |
+| `genex character "<direction>"` | Meshy | a concept sheet, then a rigged character |
+| `genex character import <file.glb>` | Uthana | a rigged character from your own mesh |
 | `genex sfx "<prompt>" [--duration <s>]` | ElevenLabs | `…/generations/<id>/audio-sfx` |
-| `genex texture "<prompt>" [--terrain]` | Gemini | `…/generations/<id>/texture-basecolor` |
-| `genex image "<prompt>" [--transparent] [--aspect <ratio>]` | fal.ai | `…/generations/<id>/image-main` |
-| `genex video "<prompt>" [--duration <s>] [--loop]` | fal.ai | `…/generations/<id>/video-mp4` |
+| `genex music "<prompt>" [--duration <s>]` | ElevenLabs | `…/generations/<id>/audio-music` |
+| `genex voice "<line>" [--voice <cast>]` | ElevenLabs | `…/generations/<id>/audio-voice` |
+| `genex texture "<prompt>" [--terrain]` | Gemini (Nano Banana 2) | `…/generations/<id>/texture-basecolor` |
+| `genex image "<prompt>" [--transparent] [--aspect <ratio>]` | fal.ai (GPT Image 2.5) | `…/generations/<id>/image-main` |
+| `genex video "<prompt>" [--duration <s>] [--loop]` | fal.ai (MiniMax H3 family; Luma for `--loop`) | `…/generations/<id>/video-mp4` |
 
 `genex image` and `genex video` also power the game-UI pipeline (menus + HUD
 sprite sets — see the `genex-ai-menu` / `genex-ai-hud` skills):
 
-- **image** — `--quality <low|medium|high>` (provider quality preset),
+- **image** — `--quality <low|medium|high|xhigh|max>` (GPT Image 2.5 quality tiers),
   `--size <WxH>` (exact pixel size, e.g. `2560x1440`), `--edit <url|file>`
   (edit an existing image with the prompt — a generated-asset URL or a LOCAL
   image file, inlined as a data URI up to ~4 MB: a user's reference
@@ -169,7 +175,7 @@ genex character finalize <preview-id> --user-approved --approve-remesh 10000
 
 The first command produces exactly three full-body neutral-A-pose concept
 images and a contact sheet, then stops. The second converts only the selected
-image into an unremeshed, textured Meshy 6 high-detail GLB, preserves it in R2,
+image into an unremeshed, textured Meshy 7 high-detail GLB, preserves it in R2,
 and returns front/back/left/right views plus its measured face count. The final
 command requires another explicit approval, creates a separate 10,000-face
 triangle remesh, rigs that exact remesh, and installs the immutable
@@ -403,7 +409,7 @@ src/
     env.ts              read/modify/write .env safely
     auth.ts             loopback server + browser opener
   utils/                logger + colors (zero runtime deps)
-templates/              copied into ~/.claude by `genex init`
+templates/              copied into the project's agent workspaces (.claude, .codex/skills, .cursor/skills) by `genex init`
 ```
 
 ## Publishing

package/dist/{blender-mcp-X66ZZ4TN.js → blender-mcp-Q6PSFYSE.js}

@@ -7,10 +7,10 @@ import {
   isRenderMode,
   sceneSummary,
   sheetOf
-} from "./chunk-OJAXYQ5L.js";
+} from "./chunk-2COG4P3T.js";
 import {
   getCliVersion
-} from "./chunk-5FA2WLM7.js";
+} from "./chunk-HYCSNWYX.js";
 
 // src/commands/blender-mcp.ts
 import fs from "fs/promises";

package/dist/{blender-serve-PVVCH3S6.js → blender-serve-BF4FZ55Z.js}

@@ -1,7 +1,7 @@
 import {
   c,
   getTemplatesDir
-} from "./chunk-5FA2WLM7.js";
+} from "./chunk-HYCSNWYX.js";
 
 // src/lib/blender-serve.ts
 import { spawn } from "child_process";

package/dist/{chunk-OJAXYQ5L.js → chunk-2COG4P3T.js}

@@ -7,7 +7,7 @@ import {
   getAuthUrl,
   getCliVersion,
   getGenexEnvPath
-} from "./chunk-5FA2WLM7.js";
+} from "./chunk-HYCSNWYX.js";
 
 // src/lib/terms.ts
 import readline from "readline";

package/dist/{chunk-5FA2WLM7.js → chunk-HYCSNWYX.js}

@@ -3,7 +3,7 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var RAW_CHANNEL = "latest";
+var RAW_CHANNEL = "dev";
 var CLI_CHANNEL = RAW_CHANNEL === "dev" ? "dev" : "latest";
 var STANDS = {
   prod: { api: "https://api.genex.games", dashboard: "https://genex.games" },

package/dist/index.js

@@ -42,7 +42,7 @@ import {
   writeProject,
   writeUserToken,
   writeWorkspace
-} from "./chunk-OJAXYQ5L.js";
+} from "./chunk-2COG4P3T.js";
 import {
   CLI_CHANNEL,
   DEFAULT_API_URL,
@@ -59,7 +59,7 @@ import {
   getGenexEnvPath,
   getTemplatesDir,
   resolveAgentTargets
-} from "./chunk-5FA2WLM7.js";
+} from "./chunk-HYCSNWYX.js";
 
 // src/instrument.ts
 import * as Sentry from "@sentry/node";
@@ -8489,6 +8489,7 @@ function buildGenOptions(kind, opts) {
   }
   if (kind === "texture" && opts.terrain) options.terrain = true;
   if ((kind === "sfx" || kind === "music") && opts.duration) options.durationSeconds = opts.duration;
+  if (kind === "sfx" && opts.loop) options.loop = true;
   if (kind === "voice") {
     if (opts.voice) options.voice = opts.voice;
     if (opts.voiceId) options.voiceId = opts.voiceId;
@@ -22296,7 +22297,7 @@ async function runBlender(opts) {
     return 1;
   }
   if (sub === "serve") {
-    const { serveLocalBlender } = await import("./blender-serve-PVVCH3S6.js");
+    const { serveLocalBlender } = await import("./blender-serve-BF4FZ55Z.js");
     const port = Number(process.env.GENEX_BLENDER_PORT ?? 8088);
     log.step(`Starting a local Blender service on port ${port}`);
     log.plain(
@@ -22305,7 +22306,7 @@ async function runBlender(opts) {
     return serveLocalBlender({ port, log });
   }
   if (sub === "mcp") {
-    const { runBlenderMcp } = await import("./blender-mcp-X66ZZ4TN.js");
+    const { runBlenderMcp } = await import("./blender-mcp-Q6PSFYSE.js");
     return runBlenderMcp();
   }
   if (sub === "seat") {
@@ -23203,7 +23204,7 @@ import path34 from "path";
 var BUDGET_SOURCE_LINE = "Live from your account; prices can change without a deploy.";
 var BUDGET_APPROVAL_REQUIRED = "STOP: raising the asset allowance requires the player's explicit approval. Re-run with --user-approved only after they agreed to the number.";
 function internalKind(kind) {
-  return kind === "agent_session" || kind === "blender_seat" || kind === "avatar_look" || kind.startsWith("outfit") || kind.startsWith("cover_");
+  return kind === "agent_session" || kind === "blender_seat" || kind === "avatar_look" || kind.startsWith("cover_");
 }
 async function isGenexProject(cwd) {
   try {
@@ -23359,9 +23360,10 @@ async function runBudget(opts = {}) {
 var TYPICAL_CREDITS = {
   model: 35,
   // 46 from a reference image; --texture standard 23, --no-texture 12, --geometry detailed 58, --quad 41, --low-poly 46, --parts 58 quote off the estimate
-  image: 4,
-  // gpt-image-2 tiers (--transparent, --quality high, --edit, 4K) quote higher
-  texture: 5,
+  image: 7,
+  // GPT Image 2.5 at high, the default; --quality xhigh/max, --candidates, --edit and 4K quote higher, --quality low/medium and --transparent quote lower
+  texture: 9,
+  // gemini-3.1-flash-image, 1K square
   sfx: 2,
   music: 27,
   // 90 s; up to 87 for a 300 s track
@@ -23635,7 +23637,8 @@ ${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `i
   --open               (image/video) open the finished asset in the user's browser +
                        print a link \u2014 show them the concept frame / anything they approve.
   --aspect <ratio>     (image) aspect preset (e.g. square, landscape, portrait).
-  --quality <q>        (image) quality preset: low | medium | high.
+  --quality <q>        (image) quality preset: low | medium | high | xhigh | max
+                       (xhigh and max: hero art \u2014 slower and dearer).
   --candidates <n>     (image) generate 2-4 variants in ONE call and print every
                        URL \u2014 pick the best instead of re-rolling. Needs
                        --quality or --size; not with --remove-bg/--transparent.
@@ -23655,7 +23658,8 @@ ${c.bold("Options for the generators (`model` `sfx` `music` `voice` `texture` `i
   --remove-bg          (image) chain ML background removal after the gen/edit.
   --bg-mode <mode>     (image) background-removal model: sprite | glyph | sheet |
                        matte (BiRefNet soft alpha \u2014 hair/glow/smoke edges).
-  --loop               (video) generate a seamless loop.
+  --loop               (video) generate a seamless loop; (sfx) an ambient bed
+                       generated to close on itself, for setLoop(true).
   --resolution <r>     (video) 480p | 768p | 2k | 4k (default 768p \u2014 the top
                        native mode; 2k/4k are upscales of the same base and
                        cost more; 480p is the cost opt-down; loop clips ignore
@@ -23984,7 +23988,7 @@ resumes it without creating another project. Existing source credits/licenses re
 Use the dev CLI channel for dev.genex.games links. After setup, work in the returned
 folder and follow the user's request to decide what to reuse, change or replace.
 `,
-  video: `${c.bold("genex video")} \u2014 generate a video clip (mp4, MiniMax H3 Max \u2014 the flagship; plain H3 for seamless loops and 2k/4k; native stereo audio on every non-loop clip).
+  video: `${c.bold("genex video")} \u2014 generate a video clip (mp4, MiniMax H3 Max Turbo by default; H3 Max for --ref; plain H3 for seamless loops and 2k/4k; native stereo audio on every non-loop clip).
 
 ${c.bold("Modes")}
   genex video "<prompt>"                          text-to-video (16:9).
@@ -24595,8 +24599,8 @@ function applyValueFlag(options, flag, value) {
       options.aspect = value;
       break;
     case "--quality":
-      if (!["low", "medium", "high"].includes(value)) {
-        throw new Error(`Invalid --quality value: ${value} (expected low|medium|high)`);
+      if (!["low", "medium", "high", "xhigh", "max"].includes(value)) {
+        throw new Error(`Invalid --quality value: ${value} (expected low|medium|high|xhigh|max)`);
       }
       options.quality = value;
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "1.32.3",
+  "version": "1.33.0-dev.684",
   "description": "Set up your project's agent workspace (.claude/.codex/.cursor in the game folder), authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-ai-hud/SKILL.md

@@ -272,8 +272,8 @@ to the same standard.
 # Stage 1 — the HUD mockup: this game's full HUD over its own scene.
 # TEXT-described; add `--edit <url-or-local-file>` to anchor it to an
 # existing reference image so the HUD inherits its exact style.
-# ONE mockup; save its URL:
-npx genex image "<filled stage-1 prompt>" --size 2560x1440 --quality high
+# ONE mockup; save its URL (xhigh: the mockup is the reference every sprite is cut from):
+npx genex image "<filled stage-1 prompt>" --size 2560x1440 --quality xhigh
 
 # Stage 2 — deconstruct the mockup into an asset sheet on white:
 npx genex image "<filled stage-2 prompt>" --edit <mockup-url> --quality high
@@ -311,7 +311,7 @@ you verify the final HUD against.
 To fix ONE sprite, don't re-run the pipeline:
 
 - **Regenerate it** in the house style:
-  `npx genex image "<style brief + sprite subject>" --quality medium --remove-bg`
+  `npx genex image "<style brief + sprite subject>" --quality high --remove-bg`
   — add `--bg-mode glyph` for digits and closed shapes (an `8` or `$` otherwise
   comes back with its loops hollowed out). Use the mandatory cutout sentence.
 - **Or region-edit the sheet**: `npx genex image "<targeted change>" --edit <sheet-url>`
@@ -336,7 +336,7 @@ To fix ONE sprite, don't re-run the pipeline:
   whitespace between the STACKED meter cells specifically (measured on a
   live run: the tools hard-refuse the resulting neighbor-in-crop defect, so
   spacing up front saves a sheet re-roll).
-- **gpt-image-2 silently squashes past 3:1** — never request a canvas with
+- **GPT Image 2.5 silently squashes past 3:1** — never request a canvas with
   aspect beyond 3:1. For thin strips (a wide bar frame), generate inside a
   ≤3:1 canvas with margins, then `genex ui trim` down to the art.
 - **Fix-up recrop, never a Stage-2 re-run for one sprite.** One bad crop:
@@ -654,8 +654,9 @@ stages land, and never sit in a foreground wait.
 ## Options
 
 - `npx genex image` — `--size <WxH>` exact pixels (multiples of 16, each side
-  ≤ 3840, aspect at most 3:1); `--quality <low|medium|high>` (high for the
-  mockup/sheet, medium for single sprites); `--candidates <2|3|4>` several
+  ≤ 3840, aspect at most 3:1); `--quality <low|medium|high|xhigh|max>` (xhigh for
+  the stage-1 mockup, high for the stage-2 sheet and for single sprites; max is
+  a hero-art tier the HUD pipeline does not need); `--candidates <2|3|4>` several
   variants in ONE call (one mockup is the default; use candidates when the
   player asks for variants or you genuinely want options to judge); `--edit <url|file>` image-to-image edit of an
   R2 URL or a local image file (≤4 MB, inlined); `--clean <url>`

package/templates/skills/genex-ai-hud/references/stage1-prompt-template.md

@@ -1,7 +1,7 @@
 # Stage 1 prompt template — the full-HUD mockup
 
 Fill the placeholders, then pass the whole text as the prompt to
-`npx genex image "<filled prompt>" --size 2560x1440 --quality high`.
+`npx genex image "<filled prompt>" --size 2560x1440 --quality xhigh`.
 One mockup is the default; generate candidate variants when the player asks
 for them or you genuinely want options to judge. Every
 sprite the HUD ships is cut out of this frame, so the scene half deserves the

package/templates/skills/genex-ai-image/SKILL.md

@@ -209,7 +209,9 @@ See `$genex-threejs-multiplayer` for the `shared` channel rules and the room API
   generation and that is billed per image, so generate candidates with
   `--quality`/`--size`, pick one, then cut it with `--clean <url>`.
 - `--aspect <ratio>` — image shape (e.g. `square`, `16:9`, `9:16`); default is square.
-- `--quality <low|medium|high>` — quality preset; higher costs more and takes longer.
+- `--quality <low|medium|high|xhigh|max>` — GPT Image 2.5 quality preset; higher
+  costs more and takes longer. `xhigh` and `max` are for hero art (a title
+  wordmark, a key-art backdrop), not for sprites and icons.
 - `--size <WxH>` — exact pixel size (multiples of 16, each side ≤ 3840, aspect ≤ 3:1).
 - `--edit <url>` — edit THAT generated image with the prompt (image-to-image).
 - `--inpaint <mask.png|url>` — with `--edit`: a region mask (local PNG or

package/templates/skills/genex-ai-menu/SKILL.md

@@ -37,7 +37,9 @@ hard rules for the frame prompt:
 
 - **Full-bleed cinematic 16:9.** The frame is a filmic establishing shot,
   edge to edge. End the prompt with: `Edge-to-edge cinematic composition.
-  Full-bleed 16:9 frame. No UI elements, no text, no buttons in the frame.`
+  Full-bleed 16:9 frame. The frame is pure scenery: no UI elements, no text,
+  no buttons in the frame.` Ask for `--quality xhigh`: a still the player
+  stares at every time the menu opens earns the top tier.
 - **NO UI in the frame — ever.** No buttons, no title text, no logos, no
   menus baked into the image. All of that is DOM on top. If the image model
   draws UI into the frame, the prompt was wrong — rewrite and regenerate.
@@ -123,7 +125,7 @@ references/style-capsules.md) — a lean, not a rule.
 # If the menu should match an image that already exists, add --edit <url> so
 # the two share one palette and light. The still stays UI-free — an image
 # with interface in it is never the video frame:
-npx genex image "windswept alpine meadow at golden hour, wildflowers leaning in the gusts, painterly light, cinematic wide shot. Edge-to-edge cinematic composition. Full-bleed 16:9 frame. No UI elements, no text, no buttons in the frame." --aspect 16:9 --quality high
+npx genex image "windswept alpine meadow at golden hour, wildflowers leaning in the gusts, painterly light, cinematic wide shot. Edge-to-edge cinematic composition. Full-bleed 16:9 frame. The frame is pure scenery: no UI elements, no text, no buttons in the frame." --aspect 16:9 --quality xhigh
 # -> https://assets.genex.technology/generations/<id>/image-main
 
 # 2. Animate it into a seamless loop (same image as first AND last frame).

package/templates/skills/genex-ai-music/SKILL.md

@@ -42,14 +42,19 @@ dev, published game, and remixes alike).
 
 ## Prompt recipe for loopable game music
 
-Mood + instrumentation + energy + loop wording:
+Genre + mood + instrumentation + tempo + loop wording:
 
 - Name the game's emotional register and 2–3 instruments ("brooding synthwave,
   analog pads and arpeggio", "cozy acoustic folk, fingerpicked guitar and soft
   strings").
+- Give it a tempo, and a key when the mood needs one ("96 BPM, in D minor"):
+  the model reads musical terms as exactly as words, and a stated tempo holds
+  every bar of a loop at the same pace. Keep the whole prompt short; more
+  adjectives do not buy a better track.
 - Always end with: **"seamless loop, consistent energy, no intro, no outro"** —
-  there is no API loop flag; consistent energy at both ends is what makes
-  `setLoop(true)` inaudible. A track with a big intro pops every cycle.
+  the music API has no loop flag (the sfx lane does; music is prompt-shaped);
+  consistent energy at both ends is what makes `setLoop(true)` inaudible. A
+  track with a big intro pops every cycle.
 - Don't ask for vocals — the lane forces instrumental regardless.
 
 ## Wire it in Three.js

package/templates/skills/genex-ai-sfx/SKILL.md

@@ -15,6 +15,13 @@ npx genex sfx "punchy laser zap, short and dry" --duration 2
 ```
 
 `--duration <sec>` (0.5–22) sets a target length; omit it to let the model pick.
+Describe ONE sound, concretely, in the vendor's own vocabulary where it fits:
+"impact" for a hit, "whoosh" for movement through air, "ambience" for a room
+or weather bed, "drone" for a continuous suspense texture. A sequence is
+written in order: "footsteps on gravel, then a metal door opens".
+For an ambient bed the game will play on repeat (rain, a crowd, a machine
+hum), pass `--loop`: the clip is generated to close on itself, so
+`setLoop(true)` has no pop at the wrap. Never on a one-shot.
 Blocks until ready, then prints its public URL:
 
 ```

package/templates/skills/genex-ai-texture/SKILL.md

@@ -225,7 +225,7 @@ first one is the one a screenshot of the whole arena will not show you.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx genex init` first (in the project — it resolves this project's own CLI; it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -203,7 +203,7 @@ evidence detective game, a video-book. The pattern that makes it hold together:
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx genex init` first (in the project — it resolves this project's own CLI; it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
   The measured false-positive class is anatomy being pierced or entered

package/templates/skills/genex-ai-voice/SKILL.md

@@ -58,8 +58,11 @@ voice id (overrides `--voice`) — for when the user has a specific voice in
 mind. The cast covers the normal cases; don't browse ids speculatively.
 
 Pick ONE voice per character and stay with it — a guard who changes voice
-between barks breaks the character. The model is multilingual: text in the
-game's language comes back spoken in that language.
+between barks breaks the character. The model (ElevenLabs v3) is multilingual:
+text in the game's language comes back spoken in that language. It also reads
+stage directions in square brackets and punctuation for pacing: `[whispers]
+Stay close.`, `[sighs] Not again...`, an ellipsis for a pause, CAPITALS for
+emphasis. Use them sparingly; a bark rarely needs more than one.
 
 ## Limits
 

package/templates/skills/genex-getting-started/SKILL.md

@@ -161,7 +161,7 @@ downloads the game too, binary assets and all:
 
 ```bash
 mkdir my-game && cd my-game
-npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 npm install
 ```
 
@@ -225,7 +225,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

package/templates/skills/genex-tool-audio/SKILL.md

@@ -15,7 +15,11 @@ npx genex sfx "heavy wooden door creaking open" --duration 3
 ```
 
 `--duration <sec>` targets a clip length; leave it off and the model decides.
-Generate each sound separately — one prompt, one sound.
+Generate each sound separately — one prompt, one sound, in the vendor's own
+vocabulary where it fits ("impact", "whoosh", "ambience", "drone"); a sequence
+is written in order ("footsteps on gravel, then a metal door opens"). For an
+ambient bed the game plays on repeat, add `--loop`: the clip is generated to
+close on itself, so it wraps without a pop.
 
 ## Music
 

package/templates/skills/genex-tool-image/SKILL.md

@@ -34,7 +34,7 @@ Wire the **local path**. The URL is provenance — never fetch it at runtime.
 - `--bg-mode <sprite|glyph|sheet|matte>` — which removal model. `matte` gives soft alpha for hair, glow and smoke edges.
 - `--clean <url>` — remove the background of an existing image, no generation.
 - `--upscale <url>` — 2× an existing image.
-- `--aspect <ratio>` · `--size <WxH>` · `--quality <low|medium|high>` — framing and fidelity.
+- `--aspect <ratio>` · `--size <WxH>` · `--quality <low|medium|high|xhigh|max>` — framing and fidelity (GPT Image 2.5 tiers; `xhigh` and `max` are for hero art and cost the most).
 - `--candidates <2-4>` — several variants in ONE call, so you pick instead of re-rolling. Needs `--quality` or `--size`.
 - `--open` — also open it in a browser, for something the user must look at and approve.
 - `--out-dir <dir>` — where the file lands (default `./assets`).
@@ -43,10 +43,11 @@ Wire the **local path**. The URL is provenance — never fetch it at runtime.
 
 ## Cost
 
-From **4 credits** per image at default quality (1 credit = $0.01);
-`--transparent`, `--quality high`, `--edit` and 4K canvases cost more, and
-`--candidates` bills per variant - the command prints the exact quote. Live
-prices and your balance: `npx genex doctor`.
+From **7 credits** per image at the default high quality (1 credit = $0.01);
+`--quality xhigh`, `--quality max` and 4K canvases cost more, `--quality low`,
+`--quality medium` and `--transparent` cost less, and `--candidates` bills per
+variant - the command prints the exact quote. Live prices and your balance:
+`npx genex doctor`.
 
 ## Waiting
 
@@ -59,4 +60,4 @@ prices and your balance: `npx genex doctor`.
 - **Out of credits** — the error prints your balance, the price, and when credits refill. Say that plainly to the user; don't retry.
 - **"Email not verified"** — the printed link unlocks the free credits; generation works right after.
 - **Anything else** — `npx genex doctor` reports sign-in, credits, and whether the image lane is live on this account.
-- A prompt that keeps producing the wrong thing is a prompt problem, not a lane problem — name the subject, the medium and the framing concretely ("vintage travel poster, screen-printed, three flat colours"), rather than adding adjectives.
+- A prompt that keeps producing the wrong thing is a prompt problem, not a lane problem — name the subject, the medium and the framing concretely ("vintage travel poster, screen-printed, three flat colours"), rather than adding adjectives. Put the subject first and say what you want, never what to leave out: the image model reads the opening words hardest and does not take negative prompts.

package/templates/skills/genex-tool-texture/SKILL.md

@@ -39,7 +39,7 @@ repeat — the file names carry the role, so the mapping is unambiguous.
 
 ## Cost
 
-From **5 credits** for the whole set (1 credit = $0.01). Live prices and
+From **9 credits** for the whole set (1 credit = $0.01). Live prices and
 your balance: `npx genex doctor`.
 
 ## Waiting

package/templates/skills/genex-updates/SKILL.md

@@ -38,7 +38,7 @@ update, so update immediately.)
 Run exactly the command the nudge printed, from the game project root:
 
 ```bash
-npm i -D @genex-ai/cli-demo@latest   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@dev   # the genex CLI (a dev dependency)
 npm i @genex-ai/embed-sdk@latest     # identity/saves SDK (ships inside the game)
 npm i @genex-ai/multiplayer@latest   # multiplayer SDK (only if the game uses it)
 ```