skill-installer

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

Updated May 15, 2026
One-click install
npx skills add https://github.com/lth0/codexSkill --skill skill-installer-lth0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/lth0/codexSkill/tree/main/skills/codex/.system/skill-installer
Command: npx skills add https://github.com/lth0/codexSkill --skill skill-installer-lth0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires urllib, argparse, subprocess, zipfile, shutil, tempfile, json, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of quickly getting new Codex/Agents skills onto your machine without manually copying files, especially when skills come from curated lists or arbitrary GitHub repo paths.

Core Features & Use Cases

  • Curated skill listing and installation: Lists available skills from curated OpenAI skill sources (and optionally experimental ones) and installs the one you choose.
  • GitHub repo/path installation: Installs a skill from a specified GitHub repo and path (including non-curated locations, and potentially private repos via existing credentials or tokens).
  • Robust installation workflow: Validates that the target contains a root-level SKILL.md, prevents overwriting existing destinations, and uses network download or sparse git checkout depending on availability.

Quick Start

Use the skill-installer to install a named skill from the curated OpenAI list by telling Codex which skill you want installed.

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 a GitHub repository?

To install Codex skills from a GitHub repository, the skill-installer fetches content via the GitHub API or sparse checkout fallback, validates the presence of a root-level SKILL.md, and copies the selected skill directory into your $CODEX_HOME/skills folder.

Can I install skills from private GitHub repositories using existing credentials?

Yes, you can install skills from private GitHub repositories using existing credentials or tokens. The installation workflow supports fetching content from arbitrary public or credentialed private GitHub locations seamlessly.

What is the best way to list and install curated OpenAI skills?

The best way to list and install curated OpenAI skills is using the skill-installer, which lists available skills from curated OpenAI directories and optionally includes experimental ones, letting you choose and install the desired skill automatically.

How does the skill installation process prevent overwriting existing skill directories?

The skill installation process prevents overwriting existing destinations by validating the target directory before copying. It ensures that your current Codex skills in $CODEX_HOME/skills are not accidentally replaced during a new installation.

Do I need a root-level SKILL.md file to install a skill from an arbitrary path?

Yes, you need a root-level SKILL.md file to install a skill from an arbitrary path. The installation workflow requires validating SKILL.md presence to properly derive skill names and execute the installation.

Why does sparse git checkout fallback occur during skill installation?

Sparse git checkout fallback occurs during skill installation when the standard network download method is unavailable. It serves as a robust alternative mechanism to fetch and copy the selected skill directory from GitHub into your Codex skills home.