skill-installer

Install Codex skills from curated GitHub lists or arbitrary repository paths.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chhpt/skills --skill skill-installer-chhpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/chhpt/skills/tree/main/skills/skill-installer
Command: npx skills add https://github.com/chhpt/skills --skill skill-installer-chhpt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding and installing Codex skills manually requires browsing GitHub repositories, downloading files, and placing them in the correct directory. This Skill automates listing available skills and installing them into $CODEX_HOME/skills, including from private repositories. ## Core Features & Use Cases - List Available Skills: Fetch and display skills from the openai/skills curated or experimental directories, annotated with which ones are already installed. - Install from GitHub: Install one or more skills from any GitHub repo path or URL, with automatic fallback from direct download to git sparse checkout for private repos. - Use Case: A user asks what skills are available, picks two from the curated list, and has them installed into ~/.codex/skills in a single run, ready for their next turn. ## Quick Start List the available curated skills and install the one I choose into my Codex skills directory.

Frequently Asked Questions about skill-installer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a Codex skill from GitHub?

Run the install-skill-from-github.py script with --repo owner/repo and --path pointing to the skill directory, or pass a full GitHub URL with --url. The skill is copied into $CODEX_HOME/skills and becomes available on your next turn.

How do I list available curated skills?

Run scripts/list-skills.py to fetch the curated list from the openai/skills repository via the GitHub API. It prints a numbered list with already-installed skills annotated, and supports --format json or --path skills/.experimental for experimental skills.

Can I install skills from a private GitHub repository?

Yes. Private repos are accessed using existing git credentials or a GITHUB_TOKEN/GH_TOKEN environment variable for downloads. If direct download fails with auth errors, the installer falls back to git sparse checkout over HTTPS, then SSH.

What happens if the skill is already installed?

The installer aborts with an error if the destination skill directory already exists in $CODEX_HOME/skills. It does not overwrite existing installations, so you must remove the existing directory first if you want to reinstall.

Where are installed skills stored?

Skills are installed into $CODEX_HOME/skills, which defaults to ~/.codex/skills if the CODEX_HOME environment variable is not set. You can override the destination with the --dest option.