# How to Install the Awesome-GPT-Image-2 Agent Skill: Complete Guide > Install the awesome-gpt-image-2 agent skill easily with our complete guide. Learn multiple installation methods including CLI, npm, npx, GitHub Packages, and Node.js scripts. - Repository: [苍何/awesome-gpt-image-2](https://github.com/freestylefly/awesome-gpt-image-2) - Tags: how-to-guide - Published: 2026-09-01 --- **You can install the awesome-gpt-image-2 agent skill using the `skills` CLI, npm global package, npx installer, GitHub Packages, or a local Node.js script—all of which copy the skill from `agents/skills/gpt-image-2-style-library/` into your agent's skill directory.** The **awesome-gpt-image-2** repository provides a ready-to-use agent skill called **gpt-image-2-style-library**. This skill enables AI coding agents like Claude Code, Codex, and Cursor to generate GPT-Image2 prompts using a comprehensive style library. According to the freestylefly/awesome-gpt-image-2 source code, the installation process involves copying skill files from `agents/skills/gpt-image-2-style-library/` into the appropriate local agent directories. ## Installation Methods for the Awesome-GPT-Image-2 Skill ### Method 1: Skills CLI (Recommended for Claude Code, Codex, Cursor) The `skills` CLI is the fastest way to install the awesome-gpt-image-2 agent skill for specific agents. This command pulls the repository, extracts the skill, and copies it to global skill folders. ```bash npx skills add freestylefly/awesome-gpt-image-2 \ --skill gpt-image-2-style-library \ --agent claude-code codex \ --global --yes --copy ``` **Flags explained:** - `--skill gpt-image-2-style-library` — targets the specific skill directory - `--agent claude-code codex` — installs for both Claude Code and Codex - `--global` — places skills in global (`~/.`) rather than project-local directories - `--yes` — skips confirmation prompts - `--copy` — physically copies files instead of symlinking ### Method 2: Bulk Install for All Supported Agents Install the awesome-gpt-image-2 skill for every supported agent in one command: ```bash npx skills add freestylefly/awesome-gpt-image-2 \ --global --all --copy ``` This covers Codex, Claude Code, and the shared agents folder simultaneously. ### Method 3: npm Global Package Install via the published npm package `gpt-image-2-style-library`: ```bash npm install -g gpt-image-2-style-library gpt-image-2-style-library install all ``` The `install all` command executes the same copying logic as the local script, writing to `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills`. ### Method 4: npx Without Global Installation Avoid permanent package installation by running directly via npx: ```bash npx gpt-image-2-style-library install all ``` This executes the installer once without adding the package to your global npm registry. ### Method 5: GitHub Packages (Private Registry) For private installations or prerelease versions: ```bash npm login --scope=@freestylefly --registry=https://npm.pkg.github.com npm install -g @freestylefly/gpt-image-2-style-library --registry=https://npm.pkg.github.com gpt-image-2-style-library install all ``` ### Method 6: Local Repository Script Clone the repository and run the included installation script: ```bash git clone https://github.com/freestylefly/awesome-gpt-image-2.git cd awesome-gpt-image-2 npm run install:skill ``` This executes `scripts/install-style-skill.mjs`, which handles the directory detection and copying logic directly. ## What the Installation Script Does All methods ultimately invoke the same core logic in `scripts/install-style-skill.mjs`. The script performs three operations: 1. **Locates source files** — Reads from `agents/skills/gpt-image-2-style-library/` (generated from [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json)) 2. **Determines target directories** — Checks environment variables (`CODEX_HOME`, `CLAUDE_HOME`, `AGENTS_HOME`) or defaults to: - `~/.codex/skills/gpt-image-2-style-library` - `~/.claude/skills/gpt-image-2-style-library` - `~/.agents/skills/gpt-image-2-style-library` 3. **Copies and overwrites** — Recursively copies the skill directory, replacing any existing version After installation, restart your agent or refresh its skill cache to load the new capability. ## Key Files in the Awesome-GPT-Image-2 Repository | File | Purpose | |------|---------| | [`agents/skills/gpt-image-2-style-library/SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/SKILL.md) | Skill manifest with usage instructions | | [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json) | Master data file containing 100+ style definitions and templates | | `scripts/install-style-skill.mjs` | Node.js installer script (the core installation engine) | | [`package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/package.json) | Declares npm package metadata and CLI scripts (`generate:style-skill`, `install:skill`) | ## Verifying Your Awesome-GPT-Image-2 Installation Test the installation by requesting a styled image prompt from your agent: ```text Use gpt-image-2-style-library to create an infographic prompt about Codex. ``` If installed correctly, the agent will reference the skill's style definitions from [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json) to construct a detailed GPT-Image2 prompt. ## Summary - The **awesome-gpt-image-2 agent skill** is installed by copying `agents/skills/gpt-image-2-style-library/` into agent-specific skill directories - **Five installation paths** exist: `skills` CLI (recommended), npm global, npx direct, GitHub Packages, and local script execution - **All methods use `scripts/install-style-skill.mjs`** to detect target folders via environment variables or home directory defaults - **Restart your agent** after installation to activate the skill - The skill sources its content from [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json), which defines styles, templates, and metadata for GPT-Image2 prompt generation ## Frequently Asked Questions ### Where does the awesome-gpt-image-2 skill get installed? The installation script writes to `~/.codex/skills/`, `~/.claude/skills/`, or `~/.agents/skills/` depending on which agents you target. You can override these paths by setting `CODEX_HOME`, `CLAUDE_HOME`, or `AGENTS_HOME` environment variables before running any installation command. ### Can I install the skill for multiple agents at once? Yes. Use `npx skills add freestylefly/awesome-gpt-image-2 --global --all --copy` to install across all supported agents simultaneously, or list multiple agents with `--agent claude-code codex cursor`. ### What if I already have an older version installed? The installation process overwrites existing files in the target directory. The script in `scripts/install-style-skill.mjs` performs a recursive copy that replaces previous versions without prompting, ensuring you always have the latest skill definitions from [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json). ### Do I need to restart Claude Code or Codex after installing? Yes. Agents cache their skill manifests at startup. After the awesome-gpt-image-2 skill is copied to your skill directory, restart the agent or trigger a skill cache refresh to make the `gpt-image-2-style-library` capability available in your sessions.