Skill Installer

Helps install skills. By default these are from 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 curated skills when the user asks what is available, or if the user uses this skill without specifying what to do.
• 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

• Start by confirming the task and running the appropriate command.
• If something fails, report the exact error and ask what to do next.
• Say only what is necessary.

Scripts

List Curated Skills

Show available skills from the curated list:

scripts/list-curated-skills.py

Optional: specify a different repo or path:

scripts/list-curated-skills.py --repo owner/repo --path skills/path --ref branch

Output formats:

• Default: numbered list with installation status
• JSON: --format json for programmatic use

Install from Curated List

Install a skill by name from the curated list:

scripts/install-skill-from-github.py <skill-name>

The skill will be installed to ~/.agents/skills/<skill-name>/.

Install from Any GitHub Repo

Install skills from any GitHub repository:

scripts/install-skill-from-github.py owner/repo path/to/skill

For private repos, ensure gh CLI is authenticated or GITHUB_TOKEN is set.

Install multiple skills from the same repo:

scripts/install-skill-from-github.py owner/repo path/to/skill1 path/to/skill2

Behavior and Options

Installation Location

Skills are installed to ~/.agents/skills/ by default.

Private Repositories

For private repositories:

1. Ensure GitHub CLI (gh) is installed and authenticated: gh auth login
2. Or set the GITHUB_TOKEN environment variable