skill-installer

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

1|Updated Jul 6, 2015
One-click install
npx skills add https://github.com/ksolomon/dotfiles --skill skill-installer-ksolomon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/ksolomon/dotfiles/tree/main/AI/.codex/skills/.system/skill-installer
Command: npx skills add https://github.com/ksolomon/dotfiles --skill skill-installer-ksolomon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding and installing Codex skills from GitHub repositories requires manual cloning, path navigation, and file copying. This Skill automates listing available skills and installing them into $CODEX_HOME/skills with a single command. ## 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 repo path or URL, including private repos via git credentials or GITHUB_TOKEN. - Fallback Download Methods: Defaults to direct zip download and falls back to git sparse checkout over HTTPS or SSH when authentication errors occur. - Use Case: A user asks what skills are available, picks one from the curated list, and installs it into ~/.codex/skills, then restarts Codex to activate it. ## 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 copies the skill into $CODEX_HOME/skills and you restart Codex to activate it.

How do I list available Codex skills?▼

Run scripts/list-skills.py to fetch the curated list from openai/skills via the GitHub API. Add --path skills/.experimental for experimental skills or --format json for machine-readable output with installed annotations.

Can I install skills from private GitHub repositories?▼

Yes, private repos are supported through existing git credentials or by setting the GITHUB_TOKEN or GH_TOKEN environment variable. 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.

Why does skill installation fail with HTTP 404?▼

HTTP 404 means the repository, ref, or skill path was not found on GitHub, or the repo is private without valid credentials. Verify the owner/repo and path, and provide a token or git credentials for private repositories.