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

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 and 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, which describes the available commands and points to the generated style data. The actual style library data lives in 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.

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.

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.

gpt-image-2-style-library install all

This command writes SKILL.md and 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.

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:

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 and 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 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 and style-library.json). The skill files refer to the actual 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.

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