skill-installer

Installs Codex skills from curated GitHub lists or arbitrary repo paths into $CODEX_HOME/skills.

Updated Aug 4, 2026
One-click install
npx skills add https://github.com/sjc786526-coder/RONDO --skill skill-installer-sjc786526-coder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/sjc786526-coder/RONDO/tree/main/multidev/codex-rs/skills/src/assets/samples/skill-installer
Command: npx skills add https://github.com/sjc786526-coder/RONDO --skill skill-installer-sjc786526-coder

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manually finding, downloading, and placing Codex skills into the correct local directory is tedious and error-prone. This Skill automates listing available skills and installing them from the openai/skills repository or any other GitHub repo, including private ones. ## Core Features & Use Cases - List Available Skills: Fetch the curated or experimental skill catalog from GitHub with annotations showing which skills are already installed locally. - Install from Curated List or Any Repo: Install one or multiple skills by name, by owner/repo plus path, or by pasting a full GitHub URL, with support for private repositories via git credentials or GITHUB_TOKEN. - Resilient Download with Fallback: Uses direct zip download by default and automatically falls back to git sparse checkout (HTTPS then SSH) when downloads fail with auth or permission errors. - Use Case: A user asks what skills are available, sees a numbered list with installed markers, picks one, and the skill is downloaded, validated for a SKILL.md file, and copied into $CODEX_HOME/skills ready for the next turn. ## Quick Start List the available curated skills and then 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 script with --repo owner/repo and --path pointing to the skill directory, or pass a full GitHub URL with --url. The skill is downloaded, validated for a SKILL.md file, and copied into $CODEX_HOME/skills.

How do I list available curated Codex skills?▼

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

Can I install skills from private GitHub repositories?▼

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.

Where are installed Codex skills stored?▼

Skills are installed into $CODEX_HOME/skills/<skill-name>, defaulting to ~/.codex/skills when CODEX_HOME is unset. You can override the destination with the --dest option.

Why does skill installation fail with destination already exists?▼

The installer aborts if the target skill directory already exists to avoid overwriting installed skills. Remove or rename the existing directory first, or choose a different name with the --name option.

What happens if the GitHub download fails?▼

On HTTP 401, 403, or 404 errors in auto mode, the installer falls back to git sparse checkout with blob filtering. It tries HTTPS first and then SSH, so most network or permission issues are handled automatically.