# How to Install the GPT-Image2 Agent Skill Using the Claude Code Plugin Marketplace > Easily install the GPT-Image2 agent skill in Claude Code using the plugin marketplace. Follow our simple command-line guide for quick setup and start generating images now. - Repository: [苍何/awesome-gpt-image-2](https://github.com/freestylefly/awesome-gpt-image-2) - Tags: how-to-guide - Published: 2026-08-28 --- **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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/.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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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: ```text /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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/.claude-plugin/marketplace.json) and make the skill available for installation. ### Install the Skill Once the plugin is registered, install the specific skill version: ```text /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: ```text 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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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: ```bash npm run generate:style-skill ``` This command rebuilds [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json) and updates the skill assets. To copy the updated skill into your local agent folders, run: ```bash 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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/.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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/style-library.json) data. ### What version of the plugin is currently available? According to the [`.claude-plugin/marketplace.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/.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`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/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.