# How `install:skill` Distributes GPT‑Image‑2 Skills to Codex, Claude Code, and Agents Local Folders

> Learn how the install:skill script efficiently distributes GPT-Image-2 skills to Codex, Claude Code, and Agents local folders. Master skill management for your AI projects.

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

---

**The `install:skill` script copies the gpt‑image‑2 style‑library skill into `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills` based on the target you specify.**

The `awesome‑gpt‑image‑2` repository provides a lightweight CLI that synchronizes skill definitions across the three dominant agent platforms. When you run `npm run install:skill`, the underlying `install‑style‑skill.mjs` script determines which directories to populate and performs a direct filesystem copy.

## How the Distribution Works

The script operates through a simple target‑based dispatch system. It accepts one of four values: `all`, `codex`, `claude‑code`, or `agents`. Unknown targets trigger an explicit error.

In `scripts/install-style-skill.mjs`, the validation logic appears around line 44:

```javascript
throw new Error(`Unknown install target: ${name}. Must be one of: all, codex, claude-code, agents`);

```

Once validated, the script copies the entire `agents/skills/gpt-image‑2‑style‑library` folder into the corresponding local directory under your home folder.

### Target Directories

| Target | Destination Path |
|--------|------------------|
| `codex` | `~/.codex/skills` |
| `claude-code` | `~/.claude/skills` |
| `agents` | `~/.agents/skills` |
| `all` | All three directories above |

The README confirms this behavior at line 292, stating that `install all` writes the skill to "the common local folders used by Codex and Claude Code, including `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills`."

## Running the Install Script

You can invoke the distribution logic through multiple entry points, all converging on the same core copy mechanism.

### Via npm script (recommended for contributors)

```bash

# Clone the repository

git clone https://github.com/freestylefly/awesome-gpt-image-2.git
cd awesome-gpt-image-2

# Install to all supported agent directories

npm run install:skill

```

The [`package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/package.json) script alias typically defaults to `all`, executing the equivalent of `node scripts/install-style-skill.mjs install all`.

### Via npx (no clone required)

```bash

# Install globally once, then copy to every location

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

```

### Via the skill's bundled CLI

```bash

# Target only Codex

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

# Target only Claude Code

npx gpt-image-2-style-library install claude-code

# Target the generic Agents folder

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

```

### Direct node execution

```bash
cd agents/skills/gpt-image-2-style-library
node bin/install.mjs install claude-code

```

The binary at `agents/skills/gpt-image-2-style-library/bin/install.mjs` wraps the same validation and copy logic, adding usage help and argument parsing for standalone operation.

## Post‑Install Requirements

After distribution completes, you **must restart your agent session** for the skill to become available. Neither Codex, Claude Code, nor the generic Agents runtime monitors local skill directories for runtime changes.

The README notes this explicitly: "Restart the agent session after installing." This applies regardless of whether you used `all` or a single target.

## Key Source Files

Understanding the distribution mechanism requires familiarity with three files:

- **`scripts/install-style-skill.mjs`** — The primary npm script implementation. Handles argument parsing, target validation, and directory copying.
- **`agents/skills/gpt-image-2-style-library/bin/install.mjs`** — The skill's own CLI binary. Re‑exports the install logic for npx and global installation scenarios.
- **[`README.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/README.md) (line 292)** — Documents the three target directories and the restart requirement.

## Summary

- The **`install:skill` script** distributes skills by copying files into standard local agent directories.
- Supported targets are **`codex`**, **`claude-code`**, **`agents`**, and **`all`**.
- Destination paths are **`~/.codex/skills`**, **`~/.claude/skills`**, and **`~/.agents/skills`**.
- The script validates targets strictly and throws on unknown names.
- A **session restart** is required after installation for agents to recognize the new skill.

## Frequently Asked Questions

### What happens if I specify an invalid target name?

The script throws a descriptive error: `Unknown install target: ${name}. Must be one of: all, codex, claude-code, agents`. This validation occurs in `scripts/install-style-skill.mjs` before any filesystem operations begin.

### Can I install to only one agent instead of all three?

Yes. Use `npx gpt-image-2-style-library install codex` (or `claude-code`, or `agents`) to target a single directory. The `all` target is merely a convenience that runs the copy operation three times.

### Do I need to reinstall after updating the skill?

Yes. The script performs a static copy, not a symbolic link or live sync. When you pull a new version of `awesome-gpt-image-2`, rerun `npm run install:skill` to overwrite the previous skill files in your local agent directories.

### Why must I restart the agent session?

Codex, Claude Code, and the generic Agents runtime load skill manifests at startup. None of these platforms watch local directories for changes during execution. Restarting ensures the updated skill definition is parsed and registered.