Skip to content
Codex DesignBETA

Skill Installer for Codex.

Skill Installer is the skill behind $skill-installer. It lists the curated skills in OpenAI’s skills repo and installs them, or any skill folder from another GitHub repo, including private ones. It comes built into Codex.

Updated November 12, 2026 · 3 min read

At a glance

Skill nameskill-installer
Comes withCodex itself, as a system skill
InstallBuilt into Codex (a system skill); nothing to install
Codex uses itWhen you ask which skills you can install, or to install one by name or from a GitHub repo path
Sourceopenai/skills on GitHub

What it does

The skill runs two helper scripts. list-skills.py shows the skills in skills/.curated and marks the ones you already have; ask for experimental skills and it lists skills/.experimental instead. install-skill-from-github.py installs a skill from a repo and path, or from a full GitHub tree URL.

How the install works:

  • Destination: $CODEX_HOME/skills/<skill-name>, which defaults to ~/.codex/skills. It stops if that folder already exists.
  • Download: direct download for public repos. On an auth error it falls back to a git sparse checkout, HTTPS first, then SSH.
  • Private repos: your existing git credentials, or a GITHUB_TOKEN or GH_TOKEN.
  • Options: several --path values in one run, --name, --ref (default main), --dest, and --method auto|download|git.

The scripts need network access, so in the sandbox Codex asks to escalate. After an install it tells you the skill is ready on your next turn. System skills are already installed, so it won’t reinstall those unless you insist.

When to use it

Use it whenever you find a skill on GitHub and want it in Codex without copying folders by hand, or to browse what OpenAI publishes.

Try it

Install a skill from GitHub
$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui

Does it work in Claude Code?

Not as is. The skill is written for Codex and installs into $CODEX_HOME/skills. Its install script takes a --dest option, so you could point it at ~/.claude/skills, but it’s simpler to copy the skill folder there yourself.

Keep reading

An independent plugin for Codex. Not affiliated with or endorsed by OpenAI.