skill-installer

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

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill skill-installer-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/.system/skill-installer
Command: npx skills add https://github.com/Chau165/local_skill --skill skill-installer-chau165

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 from curated collections or any GitHub repo, including private ones. ## 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 multiple skills from any GitHub repository 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 three from the curated list, and installs them all in one command so they are ready on the next turn. ## Quick Start List the available curated skills and install the ones 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 Codex skills?

Run the list-skills.py script, which fetches the openai/skills curated directory via the GitHub API and prints each skill with an already-installed annotation. Use --path skills/.experimental to list experimental skills or --format json for machine-readable output.

Can I install skills from private GitHub repositories?

Yes, private repos are supported through 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 destination directory already exists?

The installer aborts with an error rather than overwriting an existing skill directory. You must remove or rename the existing directory in $CODEX_HOME/skills before reinstalling that skill.

Do I need to install the .system skills manually?

No, the skills under the .system path in openai/skills are preinstalled with Codex, so no installation is needed. If you insist, the installer can download and overwrite them, but it is unnecessary.