# Where Are GPT-Image2 Agent Skills Installed Locally?

> Discover where GPT-Image2 agent skills install locally. Find skill directories in ~/.codex/skills, ~/.claude/skills, or ~/.agents/skills. Learn more from freestylefly/awesome-gpt-image-2.

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

---

**TLDR:** GPT-Image2 agent skills are installed into local `skills` subdirectories at `~/.codex/skills`, `~/.claude/skills`, or `~/.agents/skills`, depending on your target agent, with paths resolved by the `scripts/install-style-skill.mjs` script in the freestylefly/awesome-gpt-image-2 repository.

When you deploy the freestylefly/awesome-gpt-image-2 repository, the GPT-Image2 style-library skill is copied to specific local directories on your machine. Understanding exactly where these agent skills are installed locally enables you to verify deployments, troubleshoot path issues, and manage permissions across multiple AI agent environments.

## Default Installation Paths for GPT-Image2 Agent Skills

The installation logic in `scripts/install-style-skill.mjs` defines three distinct target locations. Each path is constructed by joining an environment variable (or default home directory path) with the `skills` subdirectory.

### Codex Agent Skills Directory

For the **Codex** agent, the script resolves the installation path using:

```js
root: join(process.env.CODEX_HOME || join(homedir(), '.codex'), 'skills')

```

This places the skill at:

- `~/.codex/skills/gpt-image-2-style-library` (when `CODEX_HOME` is unset)

### Claude Code Agent Skills Directory

For **Claude Code**, the path resolution follows:

```js
root: join(process.env.CLAUDE_HOME || join(homedir(), '.claude'), 'skills')

```

This results in:

- `~/.claude/skills/gpt-image-2-style-library` (when `CLAUDE_HOME` is unset)

### Shared Agents Directory

For **shared agents**, the script uses:

```js
root: join(process.env.AGENTS_HOME || join(homedir(), '.agents'), 'skills')

```

This installs to:

- `~/.agents/skills/gpt-image-2-style-library` (when `AGENTS_HOME` is unset)

## How the Installation Script Works

The `scripts/install-style-skill.mjs` file handles the copy operation when you run the install command. The script:

1. Checks for `CODEX_HOME`, `CLAUDE_HOME`, and `AGENTS_HOME` environment variables
2. Falls back to `~/.codex`, `~/.claude`, or `~/.agents` if variables are undefined
3. Appends `skills` to create the final target directory
4. Copies the `gpt-image-2-style-library` folder into each selected location

## Installing the GPT-Image2 Style Library Skill

Execute the npm script defined in [`package.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/package.json) to trigger installation:

```bash
npm run install:skill

```

Alternatively, install via the skills CLI with specific agent targets:

```bash
npx skills add freestylefly/awesome-gpt-image-2 \
  --skill gpt-image-2-style-library \
  --agent claude-code codex \
  --global --yes --copy

```

To install only to specific agents, pass the target name as an argument:

```bash
npm run install:skill agents

```

## Verifying Your Local Installation

Confirm where the GPT-Image2 agent skills are installed locally by listing the directory contents:

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

```

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

```

```bash
ls ~/.agents/skills/gpt-image-2-style-library

```

Each directory should contain the skill files, including [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md), which documents the style library capabilities according to the repository structure at [`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).

## Customizing Installation Paths

Override default locations by setting environment variables before running the install script:

```bash
export CODEX_HOME=/custom/codex/path
export CLAUDE_HOME=/custom/claude/path
export AGENTS_HOME=/custom/agents/path
npm run install:skill

```

The `scripts/install-style-skill.mjs` file will use these values instead of the home directory defaults.

## Summary

- GPT-Image2 agent skills are installed locally into `~/.codex/skills`, `~/.claude/skills`, or `~/.agents/skills` by default
- The `scripts/install-style-skill.mjs` script resolves paths using `CODEX_HOME`, `CLAUDE_HOME`, and `AGENTS_HOME` environment variables
- Run `npm run install:skill` to copy the `gpt-image-2-style-library` folder to your selected agent directories
- Verify installation by checking for the `gpt-image-2-style-library` directory inside each agent's `skills` folder

## Frequently Asked Questions

### What is the default location for GPT-Image2 agent skills on macOS and Linux?

By default, the skills install into your home directory at `~/.codex/skills/gpt-image-2-style-library` for Codex, `~/.claude/skills/gpt-image-2-style-library` for Claude Code, and `~/.agents/skills/gpt-image-2-style-library` for shared agents. The `scripts/install-style-skill.mjs` script determines these paths using `homedir()` from Node.js when environment variables are not configured.

### Can I change where GPT-Image2 agent skills are installed locally?

Yes. Set the `CODEX_HOME`, `CLAUDE_HOME`, or `AGENTS_HOME` environment variables to your preferred base directories before executing `npm run install:skill`. The installation script joins these paths with the `skills` subdirectory to determine the final destination for the `gpt-image-2-style-library` files.

### How do I verify that the GPT-Image2 skill installed correctly?

List the contents of the specific agent skill directory using commands like `ls ~/.claude/skills/gpt-image-2-style-library`. If the directory exists and contains files including [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md), the installation succeeded. You can compare these files against the source in [`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) within the freestylefly/awesome-gpt-image-2 repository.

### Does the install script support installing to only one agent at a time?

Yes. You can pass specific target names as arguments to limit installation. For example, run `npm run install:skill agents` to install only to the shared agents directory, or specify `codex` or `claude` individually to deploy the GPT-Image2 style-library skill to a single agent environment.