---
id: sm-skill-installer
name: "skill-installer"
url: https://skills.yangsir.net/skill/sm-skill-installer
author: openai
domain: ai-skill-platform-ecosystem
tags: ["software-installation", "package-management", "deployment-automation", "devops-tools", "cli"]
install_count: 1400
rating: 4.30 (59 reviews)
github: https://github.com/openai/skills
---

# skill-installer

> 帮助安装技能，支持从默认仓库或用户指定位置获取技能，简化技能部署流程。

**Stats**: 1,400 installs · 4.3/5 (59 reviews)

## Before / After 对比

### 技能安装与管理效率

| Metric | Before | After | Change |
|---|---|---|---|
| - | - | - | - |
| - | - | - | - |
| - | - | - | - |

## Readme

# skill-installer

# Skill Installer

Helps install skills. By default these are from [https://github.com/openai/skills/tree/main/skills/.curated](https://github.com/openai/skills/tree/main/skills/.curated), but users can also provide other locations.

Use the helper scripts based on the task:

- List skills when the user asks what is available, or if the user uses this skill without specifying what to do. Default listing is `.curated`, but you can pass `--path skills/.experimental` when they ask about experimental skills.

- Install from the curated list when the user provides a skill name.

- Install from another repo when the user provides a GitHub repo/path (including private repos).

Install skills with the helper scripts.

## Communication

When listing skills, output approximately as follows, depending on the context of the user's request. If they ask about experimental skills, list from `.experimental` instead of `.curated` and label the source accordingly:
"""
Skills from {repo}:

- skill-1

- skill-2 (already installed)

- ...
Which ones would you like installed?
"""

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

## Scripts

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

- `scripts/list-skills.py` (prints skills list with installed annotations)

- `scripts/list-skills.py --format json`

- Example (experimental list): `scripts/list-skills.py --path skills/.experimental`

- `scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]`

- `scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>`

- Example (experimental skill): `scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>`

## Behavior and Options

- 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/<skill-name>` (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 <ref>` (default `main`), `--dest <path>`, `--method auto|download|git`.

## Notes

- 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](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`.

Weekly Installs356Repository[openai/skills](https://github.com/openai/skills)GitHub Stars14.5KFirst SeenJan 20, 2026Security Audits[Gen Agent Trust HubPass](/openai/skills/skill-installer/security/agent-trust-hub)[SocketPass](/openai/skills/skill-installer/security/socket)[SnykWarn](/openai/skills/skill-installer/security/snyk)Installed oncodex313opencode292gemini-cli280github-copilot272cursor266amp252

---
*Source: https://skills.yangsir.net/skill/sm-skill-installer*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-skill-installer/markdown*