skill-installer

Install Codex skills from OpenAI registries or GitHub repos into CODEX_HOME/skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires urllib.request, urllib.error, zipfile, subprocess, tempfile, shutil, argparse, dataclasses, os, sys, and includes scripts (resource) components.

What problem does it solve?

This Skill removes the friction of manually locating, downloading, and installing Codex skills, so you can quickly expand what Codex can do without hand-managed setup steps.

Core Features & Use Cases

  • Curated skill listing and selection: List installable skills from OpenAI’s curated registry and identify which ones are already installed.
  • Curated skill installation: Install a chosen skill from the curated list into Codex’s skills directory.
  • GitHub-based skill installation: Install one or more skills from any GitHub repo path (including private repos) and place them into the user’s Codex skills directory.
  • Operational validation and safety checks: Ensures the target skill directory contains a SKILL.md, prevents overwriting existing installed skills, and rejects invalid destination paths.

Quick Start

Install a curated skill named "my-skill" by having Codex run the installer with that skill name as the request.

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, you can use an installer that fetches repo archives or performs a sparse-checkout to place them directly into your CODEX_HOME/skills directory.

Can I install skills from private GitHub repositories into Codex?

Yes, you can install skills from private GitHub repositories by providing the necessary credentials, allowing the installer to fetch and download archives from credentialed private sources.

What is the best way to list available Codex skills before installing?

The best way to list available Codex skills is using a curated registry fetcher that queries the GitHub API to display installable skills and identifies which ones are already installed.

Does Codex skill installation require a SKILL.md file?

Yes, Codex skill installation requires a SKILL.md file in the target directory, as the installer validates each skill to ensure it contains this file before writing it to the destination.

Why does the skill installer prevent overwriting existing directories?

The skill installer prevents overwriting existing directories as an operational safety check to ensure previously installed skills in your CODEX_HOME/skills directory are not lost during new installations.

How do I install multiple skills from OpenAI's curated registry at once?

You can install multiple skills from OpenAI's curated registry in a single run by passing the desired skill names to the installer, which handles fetching and writing them to your skills directory.