skill-installer

When listing curated skills, output approximately as follows, depending on the context of the user's request:

"""

Skills from {repo}:

1. skill-1
2. skill-2 (already installed)
3. ...

Which ones would you like installed?

"""

After installing a skill, tell the user: "Restart Codex to pick up new skills."

All of these scripts use network, so when running in the sandbox, request escalation when running them.

• scripts/list-curated-skills.py (prints curated list with installed annotations)
• scripts/list-curated-skills.py --format json
• scripts/install-skill-from-github.py --repo / --path [ ...]
• scripts/install-skill-from-github.py --url https://github.com///tree//

• Defaults to direct download for public GitHub repos.
• If download fails with auth/permission errors, falls back to git sparse checkout.
• Aborts if the destination skill directory already exists.
• Installs into $CODEX_HOME/skills/ (defaults to ~/.codex/skills).
• Multiple --path values install multiple skills in one run, each named from the path basename unless --name is supplied.
• Options: --ref (default main), --dest , --method auto|download|git.

• Curated listing is fetched from https://github.com/openai/skills/tree/main/skills/.curated via the GitHub API. If it is unavailable, explain the error and exit.
• Private GitHub repos can be accessed via existing git credentials or optional GITHUB_TOKEN/GH_TOKEN for download.
• Git fallback tries HTTPS first, then SSH.
• The skills at https://github.com/openai/skills/tree/main/skills/.system are preinstalled, so no need to help users install those. If they ask, just explain this. If they insist, you can download and overwrite.
• Installed annotations come from $CODEX_HOME/skills.