Where Are GPT-Image2 Agent Skills Installed Locally?

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:

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:

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:

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 to trigger installation:

npm run install:skill

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

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:

npm run install:skill agents

Verifying Your Local Installation

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

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

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

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

Each directory should contain the skill files, including SKILL.md, which documents the style library capabilities according to the repository structure at agents/skills/gpt-image-2-style-library/SKILL.md.

Customizing Installation Paths

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

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, the installation succeeded. You can compare these files against the source in 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.

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