skill-installer

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.

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

Yes. Set the GITHUB_TOKEN or GH_TOKEN environment variable for authenticated downloads, or rely on existing git credentials. If direct download fails with auth errors, the installer falls back to git sparse checkout over HTTPS, then SSH.

The installer aborts with an error if the destination directory already exists in $CODEX_HOME/skills. It does not overwrite existing skills, so you must remove the existing directory first if you want to reinstall.

HTTP 404 means the repo path or ref does not exist, while 401 or 403 indicate authentication or permission problems. In auto mode, these errors trigger a fallback to git sparse checkout; other errors abort the installation.