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

> Learn to install the awesome-gpt-image-2 skill globally with npm. Follow our simple steps to add the CLI and integrate the skill into your local agent directories for immediate use.

- Repository: [苍何/awesome-gpt-image-2](https://github.com/freestylefly/awesome-gpt-image-2)
- Tags: how-to-guide
- Published: 2026-09-10

---

**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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/package.json). This file declares the CLI entry point in the `"bin"` field:

```json
"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:

```bash
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:

```bash
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:

```bash
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:

```bash
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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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.