skill-installer

Install Codex skills from curated lists or GitHub repos into CODEX_HOME/skills.

Updated Jan 24, 2026
One-click install
npx skills add https://github.com/ElwinLiu/agents --skill skill-installer-elwinliu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/ElwinLiu/agents/tree/main/skills/.system/skill-installer
Command: npx skills add https://github.com/ElwinLiu/agents --skill skill-installer-elwinliu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill Installer simplifies acquiring Codex skills by enabling installation from curated lists or GitHub repositories, reducing manual setup and integration work.

Core Features & Use Cases

  • Curated skill discovery: List and compare skills available from curated sources, helping users choose what to install.
  • One-shot installation: Install a chosen skill from the curated catalog or from any GitHub repo path (including private repos) directly into CODEX_HOME/skills.
  • Flexible sourcing: Fetch from a curated list, a specific repository, or a URL, with guidance on how to specify paths and refs.
  • Post-install guidance: After installation, restart Codex to load new skills and verify availability.

Quick Start

Use the skill-installer to view available skills or install a skill with a path. For example:

  • List curated skills: python3 scripts/list-curated-skills.py
  • Install from curated list: python3 scripts/install-skill-from-github.py --repo openai/skills --path skills/<skill-name>
  • Install from another repo: python3 scripts/install-skill-from-github.py --url https://github.com/owner/repo/tree/main/path/to/skill

Frequently Asked Questions about skill-installer

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

FAQPage Schema
How do I install Codex skills from GitHub repositories?

Install Codex skills by running the skill-installer with a GitHub repo path. Specify the repository URL, branch, and skill path, and the installer downloads via zip or git sparse-checkout and copies the skill to CODEX_HOME/skills automatically.

Can I install skills from private GitHub repositories?

Yes, skill-installer supports private repositories. Provide the full GitHub repo path and ref, and the tool fetches and installs the skill while preventing overwrites of existing skills.

How do I discover available skills before installing?

List curated skills using the list-curated-skills script to view and compare available skills from curated sources, helping you choose which skill to install into your CODEX_HOME environment.

What happens after I install a skill with this tool?

After installation, restart Codex to load the newly installed skill. The skill-installer validates skill paths and copies them to CODEX_HOME/skills, and Codex picks them up on the next startup.

Does skill-installer prevent me from overwriting existing skills?

Yes, the installer includes built-in protection against overwrites. It validates skill paths and refuses to replace skills already present in CODEX_HOME/skills, ensuring your existing configuration stays intact.

Can I install skills from custom GitHub repos outside curated lists?

Yes, skill-installer fetches from any GitHub repo path, including custom repositories. Specify the repo URL and the path within it where your skill is located, and the tool installs it directly.