skill-installer

Install Codex skills from curated lists or GitHub repositories into the local skills directory.

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/pchemguy/AISandbox --skill skill-installer-pchemguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/pchemguy/AISandbox/tree/main/docs/AgentSkills/openai/skills/skills/.system/skill-installer
Command: npx skills add https://github.com/pchemguy/AISandbox --skill skill-installer-pchemguy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding and installing new 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 with a single request. ## Core Features & Use Cases - List Available Skills: Fetch and display skills from the openai/skills curated or experimental collections, annotated with which ones are already installed. - Install from GitHub: Install one or more skills from any GitHub repository path or URL, including private repos via git credentials or GITHUB_TOKEN. - Fallback Download Methods: Defaults to direct zip download and automatically falls back to git sparse checkout over HTTPS or SSH when downloads fail. - Use Case: A user asks what skills are available, picks two from the curated list, and has them installed into ~/.codex/skills, then restarts Codex to activate them. ## 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 scripts/install-skill-from-github.py with --repo owner/repo and --path pointing to the skill directory, or pass a full GitHub URL with --url. The script downloads the repo, validates that SKILL.md exists, and copies the skill into $CODEX_HOME/skills.

How do I list available Codex skills to install?▼

Run scripts/list-skills.py to fetch the curated list from the openai/skills repository. Use --path skills/.experimental for experimental skills and --format json for machine-readable output with installed annotations.

Can I install skills from a private GitHub repository?▼

Yes. Private repos are accessed through existing git credentials or by setting the GITHUB_TOKEN or GH_TOKEN environment variable for download requests. If direct download fails with auth errors, the installer falls back to git sparse checkout over HTTPS or SSH.

Where are installed Codex skills stored?▼

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

What happens if the skill destination directory already exists?▼

The installer aborts with an error stating the destination already exists, so it never overwrites an installed skill. Remove or rename the existing directory first if you want to reinstall.