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

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 — generated from 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.

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.

# 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:

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:

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, 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 — a human-readable reference generated from 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.

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