# How to Install the gpt-image-2-style-library Skill for Claude Code

> Easily install the gpt-image-2-style-library skill for Claude Code using marketplace commands or the Node install script. Add new capabilities to your Claude Code environment now.

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

---

**Use Claude Code's built-in marketplace commands or run the Node install script to copy the skill folder into `~/.claude/skills` and make it available immediately.**

The **gpt-image-2-style-library** skill transforms natural language requests into production-ready GPT-Image-2 prompts using curated templates, style tags, and example cases. This installation guide walks through four ways to add the skill to Claude Code, from the fastest marketplace method to manual deployment using the repository's install script.

## What the gpt-image-2-style-library Skill Does

The skill lives in `agents/skills/gpt-image-2-style-library` within the freestylefly/awesome-gpt-image-2 repository. At runtime, Claude Code reads the **SKILL.md** definition to register the skill, then consults [`references/style-library.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/references/style-library.md) — generated from [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json) — to select appropriate templates and tags for each user request.

Key files the skill relies on:
- **SKILL.md** — skill metadata and workflow description
- **references/style-library.md** — human-readable reference for template selection
- **assets/** — visual assets embedded in skill outputs
- **data/style-library.json** — master data source for templates and style tags

## Method 1: Claude Code Marketplace (Fastest)

The built-in marketplace pulls the skill directly from GitHub without leaving your Claude Code session.

1. Open Claude Code and register the repository:

```

/plugin marketplace add freestylefly/awesome-gpt-image-2

```

2. Install the specific skill:

```

/plugin install gpt-image-2-style-library@awesome-gpt-image-2

```

3. Restart your Claude Code session or reload plugins.

4. Test with a prompt:

```

Use gpt-image-2-style-library to create an infographic prompt about Codex.

```

Claude Code will read the skill definition, load the style library reference, and return a complete GPT-Image-2 prompt.

## Method 2: skills CLI (Recommended for Multiple Agents)

The `skills` CLI installs the skill across Claude Code and other agents in one command.

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

```

This downloads the skill package, copies it to `~/.claude/skills/gpt-image-2-style-library`, and registers it for your user account. The `--global` flag ensures availability across all Claude Code workspaces.

## Method 3: Repository Install Script

For developers who have cloned the repository, the Node script `scripts/install-style-skill.mjs` handles path resolution and copying automatically.

```bash

# From the repository root

node scripts/install-style-skill.mjs claude-code

```

The script resolves the source path (`agents/skills/gpt-image-2-style-library`), determines the target location via the `CLAUDE_HOME` environment variable (defaulting to the user's home directory), and copies the entire skill folder to `~/.claude/skills/gpt-image-2-style-library`. It also supports an `all` target that installs the skill for Codex, Claude Code, and the shared agents folder simultaneously.

## Method 4: npm Global Install

Install the skill as a global CLI tool, then deploy to all supported agents:

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

```

The `install all` subcommand copies the skill to every local agent folder found, including Claude Code's default location.

## Verifying Your Installation

Confirm the skill files are in place:

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

```

Expected output includes:

```

SKILL.md
package.json
assets/
references/

```

In Claude Code, trigger the skill with any natural-language request:

```

Use gpt-image-2-style-library to generate a poster prompt for a new coffee brand.

```

The agent will invoke the skill, parse [`references/style-library.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/references/style-library.md), and assemble a complete prompt with template structure, style tags, and example references.

## How Claude Code Loads the Skill

The Claude Code agent runtime expects skill folders in `~/.claude/skills`. Each folder must contain a **SKILL.md** file that declares:

- Skill name and description
- Trigger patterns for natural-language invocation
- Workflow steps the agent should execute

When gpt-image-2-style-library is installed, Claude Code registers these declarations at startup. User messages matching the trigger patterns route to the skill's workflow, which reads the generated reference file to select appropriate templates from the underlying JSON data.

## Summary

- The **marketplace method** (`/plugin install`) is fastest for Claude Code-only use
- The **skills CLI** works best when managing multiple agents
- The **Node script** (`install-style-skill.mjs`) gives precise control for developers
- The **npm global method** deploys to all agents with one command
- All methods ultimately copy `agents/skills/gpt-image-2-style-library` to `~/.claude/skills`
- The skill activates after session restart and responds to natural-language template requests

## Frequently Asked Questions

### Where does Claude Code look for installed skills?

Claude Code reads skills from `~/.claude/skills` by default. This path can be overridden by setting the `CLAUDE_HOME` environment variable before running the install script.

### What file does the skill actually read at runtime?

During execution, the skill loads [`references/style-library.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/references/style-library.md) — a human-readable reference generated from [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json). This file contains the template catalog, style tag definitions, and example cases used to construct prompts.

### Can I install this skill for other agents besides Claude Code?

Yes. The `install-style-skill.mjs` script supports `claude-code`, `codex`, and `all` targets. The skills CLI also accepts multiple `--agent` flags. The skill structure in `agents/skills/gpt-image-2-style-library` is compatible with the multi-agent skill framework.

### Do I need to restart Claude Code after installing?

Yes. Claude Code discovers skills at session startup. After installation, either start a new session or use your client's plugin reload command to register the newly installed gpt-image-2-style-library skill.