skill-installer

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

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dungle-scrubs/agent-config --skill skill-installer-dungle-scrubs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/dungle-scrubs/agent-config/tree/main/stow/shared/skills/.system/skill-installer
Command: npx skills add https://github.com/dungle-scrubs/agent-config --skill skill-installer-dungle-scrubs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, and includes scripts (resource) components.

What problem does it solve?

This Skill helps teams install Codex skills from curated sources or remote GitHub repositories, enabling quick access to a growing library of reusable capabilities.

Core Features & Use Cases

  • List curated skills from a known source and show installed status.
  • Install a curated skill from a centralized collection or from a specified GitHub repo path.
  • Install a skill from another repo using a GitHub URL or owner/repo path, including private repositories.

Quick Start

Use the helper scripts to manage skills:

  • List curated skills: python3 scripts/list-curated-skills.py
  • Install a curated skill: python3 scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill>
  • Install from another repo: python3 scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<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 a GitHub repository?

You can install Codex skills from a GitHub repository by running the install-skill-from-github.py script with a repo path or URL, which validates input and copies the skill into your $CODEX_HOME/skills directory.

Can I install skills from private GitHub repositories?

Yes, the skill installer supports fetching skills from private GitHub repositories using either a direct download or sparse-checkout method, ensuring unique destination paths in $CODEX_HOME/skills.

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

To list available curated skills, run the list-curated-skills.py script. It queries a known centralized collection and displays the installed status of each skill in your local environment.

Do I need git installed to fetch skills from curated lists or GitHub repos?

Yes, git is a required dependency. The installer uses git for sparse-checkout operations when fetching skills from curated lists or remote GitHub repositories into your local Codex environment.

How does the skill installer handle existing files in the Codex skills directory?

The installer ensures unique destination paths within the $CODEX_HOME/skills directory. It validates input parameters before copying files, preventing overwrites and maintaining directory integrity.