How to Install the awesome-gpt-image-2 Skill Globally Using npm

Run npm install -g gpt-image-2-style-library to add the CLI to your global npm bin directory, then execute gpt-image-2-style-library install all to copy the skill into local agent directories such as ~/.codex/skills and ~/.claude/skills.

The freestylefly/awesome-gpt-image-2 repository distributes an npm-publishable agent skill called gpt-image-2-style-library. Installing the awesome-gpt-image-2 skill globally makes the CLI binary available system-wide while enabling rapid deployment to Claude Code, Codex, and other supported AI agents.

Understanding the npm Package Structure

Inside the repository, the package definition resides at agents/skills/gpt-image-2-style-library/package.json. This file declares the CLI entry point in the "bin" field:

"bin": {
  "gpt-image-2-style-library": "bin/install.mjs"
}

The bin/install.mjs script implements the installation logic that copies skill files into local agent folders.

Step-by-Step Global Installation

1. Install the Package Globally

Run the following command to install the skill globally:

npm install -g gpt-image-2-style-library

This adds the gpt-image-2-style-library command to your global npm bin directory, making it accessible from any terminal session.

2. Deploy to Local Agent Folders

After global installation, deploy the skill to all supported agents:

gpt-image-2-style-library install all

According to the source code in bin/install.mjs, this command writes the skill's files to ~/.codex/skills, ~/.claude/skills, and ~/.agents/skills. Restart your agent to activate the skill.

Alternative: Running Without Global Installation

If you prefer not to install globally, use npx to run the CLI temporarily:

npx gpt-image-2-style-library install all

This executes the install all command without persisting the binary to your global npm directory.

Verifying the Installation

To confirm the skill is properly installed, check for the presence of files in your local agent directories:

ls ~/.codex/skills/gpt-image-2-style-library
ls ~/.claude/skills/gpt-image-2-style-library

The README.md "npm CLI" section documents this verification workflow and recommends restarting the agent after installation.

Summary

• The gpt-image-2-style-library package provides a global CLI for deploying the awesome-gpt-image-2 skill.
• Global installation requires npm install -g gpt-image-2-style-library, which registers the binary defined in agents/skills/gpt-image-2-style-library/package.json.
• The gpt-image-2-style-library install all command copies the skill into ~/.codex/skills, ~/.claude/skills, and ~/.agents/skills.
• Use npx gpt-image-2-style-library install all to avoid global installation.

Frequently Asked Questions

What is the exact npm package name for awesome-gpt-image-2?

The npm package is named gpt-image-2-style-library, defined in agents/skills/gpt-image-2-style-library/package.json. This package contains the installable agent skill and CLI tools.

Where does the global install place the skill files?

The global install adds the CLI binary to your npm global bin directory. Running gpt-image-2-style-library install all then copies the skill files into local directories at ~/.codex/skills, ~/.claude/skills, and ~/.agents/skills according to the bin/install.mjs implementation.

Can I install the skill without using npm install -g?

Yes. Use npx gpt-image-2-style-library install all to execute the installation command without permanently installing the package globally. This is useful for one-time deployments or restricted environments.

Why do I need to restart my agent after installation?

The skill files must be present in the local agent directories before the agent initializes. Restarting Claude Code, Codex, or your preferred agent ensures it discovers and loads the newly installed awesome-gpt-image-2 skill from ~/.claude/skills or the respective directory.

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