skill-installer

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

1|Updated Aug 1, 2026
One-click install
npx skills add https://github.com/xlnn/modelmux-vscode --skill skill-installer-xlnn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/xlnn/modelmux-vscode/tree/main/.tmp-codex-home4/skills/.system/skill-installer
Command: npx skills add https://github.com/xlnn/modelmux-vscode --skill skill-installer-xlnn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Manually downloading and placing skill directories into the Codex skills folder is error-prone, especially when sourcing from curated lists, experimental collections, or private GitHub repositories. ## Core Features & Use Cases - Curated Skill Listing: Lists available skills from the openai/skills repository with annotations showing which are already installed, in text or JSON format. - GitHub Installation: Installs one or more skills from any GitHub repo path or URL, with automatic fallback from direct zip download to git sparse checkout for private repos. - Use Case: A user asks what skills are available, picks one from the curated list, and the skill is downloaded, validated for a SKILL.md file, and copied into $CODEX_HOME/skills ready for the next session. ## Quick Start Ask the assistant to list the available curated skills and install the one you want by name.

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 downloaded, validated for a SKILL.md file, and copied into $CODEX_HOME/skills.

How do I list available curated skills?

Run the list-skills.py script, which fetches the curated list from the openai/skills repository via the GitHub API. It prints a numbered list marking skills that are already installed, and supports --format json for machine-readable output.

Can I install skills from a private GitHub repository?

Yes, private repos are supported through existing git credentials or a GITHUB_TOKEN/GH_TOKEN environment variable for downloads. If the 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 the existing directory. You must remove or rename the existing skill folder in $CODEX_HOME/skills before installing again.

Where are installed skills placed and when do they become active?

Skills are installed into $CODEX_HOME/skills, defaulting to ~/.codex/skills, with each skill named from its path basename unless --name is given. An installed skill becomes available on the user's next turn.