skill-installer

Install Codex skills from curated GitHub lists or arbitrary repo paths.

Updated Dec 20, 2025
One-click install
npx skills add https://github.com/koala-man-64/helpful-scripts --skill skill-installer-koala-man-64
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/koala-man-64/helpful-scripts/tree/main/exports/codex-skills/home-shared/.system/skill-installer
Command: npx skills add https://github.com/koala-man-64/helpful-scripts --skill skill-installer-koala-man-64

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Finding and installing Codex skills manually requires browsing GitHub repos, downloading files, and placing them in the correct directory. This Skill automates listing available skills and installing them into $CODEX_HOME/skills, including from private repositories. ## Core Features & Use Cases - List Available Skills: Fetch the curated or experimental skill catalog from openai/skills via the GitHub API, annotated with which ones are already installed. - Install from GitHub: Install one or more skills from any GitHub repo path or URL, with automatic fallback from direct zip download to git sparse checkout for private repos. - Use Case: A user asks what skills are available, picks two from the curated list, and installs both into ~/.codex/skills in a single run, then restarts Codex to activate them. ## Quick Start List the available curated skills and install the ones I choose into my Codex skills directory.

Frequently Asked Questions about skill-installer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a Codex skill from GitHub?▼

Run scripts/install-skill-from-github.py with --repo owner/repo and --path pointing to the skill directory, or pass a full GitHub URL with --url. The script downloads the repo, validates that SKILL.md exists, and copies the skill into $CODEX_HOME/skills.

How do I list available Codex skills?▼

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

Can I install skills from private GitHub repositories?▼

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

What happens if the skill destination directory already exists?▼

The installer aborts with an error rather than overwriting. It checks whether the destination path under $CODEX_HOME/skills already exists before copying, so you must remove or rename the existing skill first.

Why does skill installation fail with a download error?▼

Download failures usually come from HTTP 401, 403, or 404 responses, indicating missing auth or a wrong path. In auto mode the installer retries with git sparse checkout; otherwise verify the repo, path, ref, and your token permissions.