skill-installer

Install Codex skills from curated lists or GitHub repositories into the workspace.

3|1|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/j5ik2o/cqrs-es-spec-kit-js --skill skill-installer-j5ik2o
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/j5ik2o/cqrs-es-spec-kit-js/tree/main/.codex/skills/.system/skill-installer
Command: npx skills add https://github.com/j5ik2o/cqrs-es-spec-kit-js --skill skill-installer-j5ik2o

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill Installer makes it easy to provision Codex skills by pulling them from curated lists or directly from GitHub repositories, reducing manual setup and ensuring consistent environments.

Core Features & Use Cases

  • List available curated skills: Quickly discover skills you can install from the central curated catalog.
  • Install from curated list or repo path: Add new skills to your Codex workspace from trusted sources.
  • Install from private repos: Retrieve skills from private GitHub repositories when you provide credentials.
  • Use Case: A developer wants to add a new capability to Codex by installing a skill from the curated catalog or a private project, then restart Codex to load it.

Quick Start

Run the installer to list, fetch, and deploy skills. For example:

  • List curated skills: run scripts/list-curated-skills.py
  • Install a curated skill: run scripts/install-skill-from-github.py --repo owner/repo --path path/to/skill
  • Install from a GitHub URL: run 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?

To install Codex skills from a GitHub repository, run the installer script with the repository path or GitHub URL. It downloads ZIP archives or performs sparse git checkouts, writing each skill to a separate directory under $CODEX_HOME/skills.

Can I install Codex skills from private GitHub repositories?

Yes, you can install Codex skills from private GitHub repositories by providing the necessary credentials. The installer validates skill paths and retrieves skill data into the Codex workspace.

How do I list available curated skills for Codex?

You can list available curated skills for Codex by running the list-curated-skills script. This displays skills from the central curated catalog, allowing you to discover and select capabilities to install.

What is the best way to provision Codex skills from trusted sources?

The best way to provision Codex skills from trusted sources is using a Skill Installer that pulls from curated lists or GitHub repositories. This reduces manual setup and ensures consistent environments by validating paths and deploying directly to the workspace.

Does the Codex skill installer work with sparse git checkouts?

Yes, the Codex skill installer works with sparse git checkouts to retrieve skills efficiently. It validates skill paths and writes each installed skill to a separate directory under the destination.

Why should I validate skill paths before installing Codex skills?

Validating skill paths before installing Codex skills ensures that the downloaded ZIP archives or sparse git checkouts are written correctly to separate directories under $CODEX_HOME/skills, preventing deployment errors.