How to Install the Awesome-GPT-Image-2 Agent Skill: Complete Guide

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.

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:

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:

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:

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:

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:

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)

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	Skill manifest with usage instructions
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	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:

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

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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}