How to Install the GPT-Image2 Agent Skill Using the Claude Code Plugin Marketplace

You can install the GPT-Image2 agent skill by running /plugin marketplace add freestylefly/awesome-gpt-image-2 followed by /plugin install gpt-image-2-style-library@awesome-gpt-image-2 inside Claude Code.

The freestylefly/awesome-gpt-image-2 repository packages its style-library intelligence as a Claude Code plugin, allowing you to install the GPT-Image2 agent skill directly through the Claude Code Plugin Marketplace. This installation method copies the skill files into your local Claude directories and registers the gpt-image-2-style-library skill for immediate use in prompts.

Understanding the Plugin Structure

Before installing, it helps to understand how Claude Code identifies and loads this skill. The repository's .claude-plugin/marketplace.json file declares the plugin metadata that Claude reads during installation:

• Plugin name: awesome-gpt-image-2
• Owner: freestylefly
• Version: 1.0.4
• Skill location: agents/skills/gpt-image-2-style-library

When you execute the marketplace commands, Claude pulls the skill source from agents/skills/gpt-image-2-style-library and writes the files to your local skill directories (~/.claude/skills, ~/.codex/skills, etc.). The skill then reads the canonical style-library data from data/style-library.json to provide up-to-date style tags, template categories, and example cases.

Step-by-Step Installation Guide

Add the Plugin to the Marketplace

First, register the plugin metadata in your Claude Code environment. Open any Claude Code chat window and run:

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

This command tells Claude to fetch the plugin definition from the repository's .claude-plugin/marketplace.json and make the skill available for installation.

Install the Skill

Once the plugin is registered, install the specific skill version:

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

Claude copies the skill files from agents/skills/gpt-image-2-style-library into your local skill folder and registers the skill name gpt-image-2-style-library. The skill manifest located at agents/skills/gpt-image-2-style-library/SKILL defines the workflow, prompts, and output rules that govern how the skill builds GPT-Image2 requests.

Verify the Installation

Test the installation by invoking the skill in a prompt:

Use gpt-image-2-style-library to create a cinematic portrait prompt.

Claude will invoke the skill, select an appropriate template from the style library, and return a ready-to-run GPT-Image2 prompt based on the data in data/style-library.json.

How the Skill Works

The installed skill functions as a bridge between Claude's reasoning capabilities and the repository's curated prompt database. The SKILL.md file in agents/skills/gpt-image-2-style-library describes the exact workflow for building requests, while the style-library.json file (containing 500+ prompt templates, style tags, and categories) serves as the knowledge base.

Because the skill reads from the generated style-library.json, every agent run uses the same canonical data that powers the web UI. This ensures consistency between your local Claude sessions and the latest repository updates.

Updating and Maintaining the Skill

When the repository updates its curated cases, you can regenerate the skill assets to reflect the latest styles:

npm run generate:style-skill

This command rebuilds data/style-library.json and updates the skill assets. To copy the updated skill into your local agent folders, run:

npm run install:skill

After updating, restart your Claude session or reinstall the skill using the marketplace commands to ensure Claude loads the latest version from ~/.claude/skills.

Summary

• The GPT-Image2 agent skill is packaged as a Claude Code plugin defined in .claude-plugin/marketplace.json.
• Install using two commands: /plugin marketplace add freestylefly/awesome-gpt-image-2 followed by /plugin install gpt-image-2-style-library@awesome-gpt-image-2.
• The skill reads from data/style-library.json to provide 500+ style templates and categories.
• Local skill files are stored in ~/.claude/skills and ~/.codex/skills.
• Regenerate the skill after repository updates using npm run generate:style-skill.

Frequently Asked Questions

Where does Claude Code store the installed skill files?

Claude writes the skill files to your local skill directories, typically located at ~/.claude/skills and ~/.codex/skills on your system. These directories mirror the structure found in the repository's agents/skills/gpt-image-2-style-library folder.

Can I use the skill immediately after installation without restarting Claude?

Yes. Once you run the install command, the gpt-image-2-style-library skill becomes immediately callable from any Claude prompt. However, if you regenerate the skill assets using npm run generate:style-skill, you should reinstall the skill or restart the session to load the updated style-library.json data.

What version of the plugin is currently available?

According to the .claude-plugin/marketplace.json file in the freestylefly/awesome-gpt-image-2 repository, the current version is 1.0.4. This version exposes the gpt-image-2-style-library skill located at agents/skills/gpt-image-2-style-library.

How do I update the skill when the repository adds new style templates?

Run npm run generate:style-skill from the repository root to rebuild the data/style-library.json file with new templates, then execute npm run install:skill to copy the updated assets into your local Claude directories. Finally, reinstall the skill via the Claude Code Plugin Marketplace to ensure Claude loads the latest version.

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