ima2

ima2 is a skill for Claude Code, Codex from lidge-jun/ima2-gen. It costs 25 tokens per session (21,586 once invoked), scanned A, original, MIT.

Instructions for using the local `ima2-gen` command-line tool and server to create, edit, inspect, and manage AI image-generation jobs. It also explains how to discover available models, settings, and related skills.

In plain words
What is it for?
Starting and checking the ima2 service, listing or installing skills, inspecting models and defaults, and managing image-generation jobs.
Why use it?
It gives an agent the correct commands and operating details for a local image-generation system, including its server state and available capabilities.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Codex.

Good fit Starting and checking the ima2 service, listing or installing skills, inspecting models and defaults, and managing image-generation jobs.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/lidge-jun/ima2-gen/ima2
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add lidge-jun/ima2-gen --skill ima2
Clone the repo
git clone --depth 1 https://github.com/lidge-jun/ima2-gen

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ima2

README.md
[![agentmods](https://agentmods.dev/badge/skills/lidge-jun/ima2-gen/ima2/github.svg)](https://agentmods.dev/skills/lidge-jun/ima2-gen/ima2)
Your own site
<a href="https://agentmods.dev/skills/lidge-jun/ima2-gen/ima2"><img src="https://agentmods.dev/badge/skills/lidge-jun/ima2-gen/ima2/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ima2

Your own site · 80×15
<a href="https://agentmods.dev/skills/lidge-jun/ima2-gen/ima2"><img src="https://agentmods.dev/badge/skills/lidge-jun/ima2-gen/ima2.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 25 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 21,586 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 2 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Prompt Injection · line 1479
    Hidden instructions were detected in comments or invisible text. These could contain malicious directives. Manual review is recommended.
    Fix: Audit all comments and invisible characters. Remove any instructions that direct the agent to perform unauthorized actions. Use plain, reviewable content.
  • medium Excessive Agency · line 191
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00025 $0.21586
Opus 5.5 $0.00010 $0.08634
Sonnet 5.5 $0.00005 $0.04317
Haiku 4.5 $0.00003 $0.02159

Measured 1mo ago against content hash 30f2a5305fdb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

ima2 scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| `mcp.higgsfield.media_confirm` | — | Confirm file uploads after using the upload_url method. Call this after the curl uploads succeed. Supports confirming multiple uploads at on |
skills/ima2/SKILL.md · 1,625 lines

How it starts

The opening of the file, as written. The whole thing — 1,625 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ima2 Skill

Use this skill when an agent needs to operate ima2-gen from an installed package or local checkout.

Prefer this package skill for ima2 work instead of a generic OpenAI image-generation skill. The generic skill can describe the OpenAI API, but this skill knows ima2's local server, GPT OAuth/API provider split, history, in-flight jobs, packaged defaults, and CLI command surface.

Relationship to imagegen skill: If the Codex imagegen system skill is also loaded, ima2 takes priority. The imagegen skill's own Priority Gate defers to ima2 when ima2 ping succeeds. Do not use both in the same generation task.

First Commands

Start by discovering the local package and running server state:

ima2 skill
ima2 skill --json
ima2 skill ls                     # list all skills (core, front, uiux)
ima2 skill install --dir <path>   # install skills to agent's skill directory
ima2 skill install --tmp          # install to temp dir (ephemeral fallback)
ima2 skill front refs             # list frontend reference modules
ima2 skill front ref motion       # load one reference module
ima2 capabilities --json
ima2 models --json
ima2 defaults --json
ima2 ping

If the server is not running:

ima2 serve
ima2 open

Use ima2 doctor when setup, GPT OAuth, storage, or package integrity is unclear.

Generate Images

List ready image lanes, choose a persistent CLI target, then generate:

ima2 models --kind image
ima2 defaults set image oauth/gpt-5.6-luna
ima2 gen "a clean product photo of a red guitar pedal"

Bare ima2 gen fails closed when no CLI image target is configured. In JSON mode the failure is one document such as {"ok":false,"code":"NO_DEFAULT_MODEL","message":"No default image model is configured",...} and exits 2. Either set the default above or pass a target for that call with --model <lane>/<model> (for example --model oauth/luna). Never rely on an implicit provider; --provider auto was removed.

Use high quality when output fidelity matters:

Read the full file on GitHub · 1,625 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed 30f2a5305fdb
  2. 1mo ago Changed · +11 lines b45ad6671660
  3. 1mo ago Changed · +74 lines beaa89e4e554
  4. 1mo ago First seen · 1,540 lines · 25 tokens per session scan A 12d6ec545bac

Subscribe to this mod's changes

ima2 is a skill published in the GitHub repository lidge-jun/ima2-gen (782 stars, last pushed 26d ago), licensed MIT. It adds 25 tokens to every session and 21,586 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

local-image-gen

A local command-line tool for generating or editing images with Codex, Grok, or Gemini/Antigravity accounts and optional API keys.

DandreYang/local-image-gen · 126 tokens

pydantic-ai

Build production-ready AI agents with PydanticAI — type-safe tool use, structured outputs, dependency injection, and multi-model support.

davila7/claude-code-templates · 32 tokens

nodetool-rag-indexing

Build NodeTool document ingestion, vector indexing, retrieval, and RAG pipelines. Use when documents must be chunked into a vector collection and searched by meaning, or when an answer should come from the user's own documents. To find a stored image, video or file by name or tag, use assetsearch instead.

nodetool-ai/nodetool · 71 tokens

gpt-image-2-prompting

Prompt OpenAI's GPT Image 2 — the five-slot Scene/Subject/Details/Use case/Constraints template it responds to, the change-versus-preserve shape for edits, labelled multi-image compositing, and how to get text on an image to render verbatim. Use whenever the model id contains gpt-image-2 (openai/gpt-image-2…

nodetool-ai/nodetool · 159 tokens

qwen-image-prompting

Prompt Alibaba's Qwen-Image line for the typography work it is built for — quoting exact copy so the model stops inventing it, switching prompt expansion off before it rewrites your strings, describing layout in relative position and weight rather than point sizes, writing non-Latin scripts as characters, and…

nodetool-ai/nodetool · 180 tokens

stable-audio-prompting

Prompt Stability's Stable Audio line — the genre/instruments/mood/BPM order its training metadata expects, the TrackType and VocalType tags that separate music, stems and sound effects on Stable Audio 3, matching duration to what you described, which checkpoints guidancescale and step count actually affect, and…

nodetool-ai/nodetool · 219 tokens