skill-installer

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

3|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/JoaquinCampo/codex-skills --skill skill-installer-joaquincampo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/JoaquinCampo/codex-skills/tree/main/.system/skill-installer
Command: npx skills add https://github.com/JoaquinCampo/codex-skills --skill skill-installer-joaquincampo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the chore of discovering, fetching, and installing Codex skills from a curated OpenAI list or a GitHub repository path, enabling quick expansion of capabilities.

Core Features & Use Cases

  • Discover available skills from curated lists and see which are installed.
  • Install a skill from the curated list or from a GitHub repository path.
  • Validate each skill by requiring a SKILL.md at its root and install under CODEX_HOME/skills with a deterministic name.
  • Use Case: You want to add a new capability to Codex without manual file copying.

Quick Start

List curated skills:

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

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?

You can discover available Codex skills by running the curated list script. This script lists available skills from curated OpenAI lists and shows which ones are currently installed in your local environment.

Can I install skills from private GitHub repositories?

Yes, you can install skills from private GitHub repositories. The installer supports fetching skills from private repos using either a direct download method or a sparse-checkout approach to place the skill into the CODEX_HOME/skills directory.

What are the requirements for a valid Codex skill installation?

A valid Codex skill requires a SKILL.md file at its root directory. The installer validates this structure before placing the skill under CODEX_HOME/skills with a deterministic name to ensure proper integration.

Does the Codex skill installer support sparse-checkout for GitHub repos?

Yes, the Codex skill installer supports sparse-checkout for GitHub repositories. This allows you to pull specific skill directories from a repository without downloading the entire codebase into your local environment.