# How to Install the GPT-Image2 Skill Using GitHub Packages: Step-by-Step Guide

> Install the GPT-Image2 skill from GitHub Packages with our step-by-step guide. Authenticate, install the NPM module, and copy skill files to your agent directories easily.

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

---

**To install the GPT-Image2 skill, authenticate to GitHub Packages, install the `@freestylefly/gpt-image-2-style-library` NPM module globally, and run `gpt-image-2-style-library install all` to copy the skill files into your local agent directories.**

The GPT-Image2 style-library skill is distributed as an NPM package through GitHub Packages in the `freestylefly/awesome-gpt-image-2` repository. When installed, the package deploys [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md) and [`style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/style-library.json) containing over 500 reverse-engineered prompt templates to the skill directories used by Claude Code, Codex, and other compatible agents.

## Architecture of the GPT-Image2 Skill Package

The skill distribution consists of three core components that work together to provide style-library functionality to your local agents.

### Skill Metadata and Data Files

The **skill metadata** is defined in [`agents/skills/gpt-image-2-style-library/SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/agents/skills/gpt-image-2-style-library/SKILL.md), which describes the available commands and points to the generated style data. The actual **style library data** lives in [`data/style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/data/style-library.json) at the repository root, containing over 500 reverse-engineered prompt cases organized into more than 20 template categories. Both the website and the skill consume this single source of truth.

### NPM Package Structure

The `@freestylefly/gpt-image-2-style-library` package on GitHub Packages bundles the SKILL file, the JSON data, and a small CLI utility. The `gpt-image-2-style-library` command-line interface handles copying these assets into the appropriate local agent directories when you run the install command.

## Step-by-Step Installation from GitHub Packages

Installing the skill requires authenticating to the GitHub Packages registry, installing the module, and deploying it to your agents.

### 1. Authenticate to GitHub Packages

Before downloading the private scoped package, you must log in to the GitHub NPM registry using a personal access token with `read:packages` permissions.

```bash
npm login --scope=@freestylefly --registry=https://npm.pkg.github.com

```

When prompted, enter your GitHub username, password (use your PAT), and email address. This stores an authentication token that permits downloading packages from the `@freestylefly` scope.

### 2. Install the Skill Globally

Install the package with the global flag to make the CLI available system-wide.

```bash
npm install -g @freestylefly/gpt-image-2-style-library --registry=https://npm.pkg.github.com

```

The `-g` flag ensures the `gpt-image-2-style-library` binary is added to your PATH, allowing you to invoke it from any directory.

### 3. Deploy the Skill to Your Agents

Run the install command to copy the skill files into the default skill folders used by supported agents.

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

```

This command writes [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md) and [`style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/style-library.json) into `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills`. After the files are copied, you must **restart** your agent or reload skills to activate the new commands.

## Alternative Installation Methods

If you prefer not to install the package globally, you have two additional options that execute the same deployment logic.

### Install via npx Without Global Installation

You can run the CLI directly without installing the package permanently using npx.

```bash
npx gpt-image-2-style-library install all

```

This approach downloads the package temporarily, executes the install command, and cleans up afterward, leaving the skill files in your agent directories while avoiding global package clutter.

### Using the Skills Wrapper

For users of the `skills` NPM package, you can install the skill using the wrapper command:

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

```

All three methods ultimately invoke the same underlying logic to copy files from the NPM package into your local agent skill directories.

## Summary

- **Authentication is required**: You must run `npm login` with the `@freestylefly` scope against `https://npm.pkg.github.com` using a GitHub Personal Access Token before installing.
- **Global installation**: Run `npm install -g @freestylefly/gpt-image-2-style-library --registry=https://npm.pkg.github.com` to get the CLI.
- **Deployment**: Execute `gpt-image-2-style-library install all` to copy [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md) and [`style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/style-library.json) into `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills`.
- **Agent restart required**: After installation, restart Claude Code, Codex, or your chosen agent to load the new skill commands.
- **Alternative methods**: Use `npx gpt-image-2-style-library install all` or the `skills` wrapper for temporary or managed installations.

## Frequently Asked Questions

### Do I need a GitHub Personal Access Token to install the GPT-Image2 skill?

Yes, because the package is hosted on GitHub Packages under the `@freestylefly` scope, you must authenticate with a Personal Access Token that has the `read:packages` permission. Run `npm login --scope=@freestylefly --registry=https://npm.pkg.github.com` and provide your PAT when prompted for the password.

### Where are the skill files installed on my local machine?

The `gpt-image-2-style-library install all` command copies the skill metadata and data files to three default locations: `~/.codex/skills`, `~/.claude/skills`, and `~/.agents/skills`. This ensures compatibility with Claude Code, Codex, and other agents that follow the standard skill directory convention.

### Can I use this skill with agents other than Claude Code and Codex?

Yes, any agent that supports the standard skill directory structure and can read [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md) files can utilize this installation. The CLI deploys to `~/.agents/skills` specifically for other compatible agents, though you should verify your specific agent's documentation for skill loading mechanisms.

### What is the difference between the NPM package and the skill files?

The NPM package (`@freestylefly/gpt-image-2-style-library`) is the distribution mechanism hosted on GitHub Packages. It contains the CLI tool and the source files ([`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md) and [`style-library.json`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/style-library.json)). The **skill files** refer to the actual [`SKILL.md`](https://github.com/freestylefly/awesome-gpt-image-2/blob/main/SKILL.md) and JSON data that get copied into your local agent directories, which the agent reads to understand the available commands and style templates.