skill-installer

Install Codex skills from GitHub repositories into the $CODEX_HOME/skills directory.

Updated May 9, 2026
One-click install
npx skills add https://github.com/kk20300113-png/my-claude-skills --skill skill-installer-kk20300113-png
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/kk20300113-png/my-claude-skills/tree/main/vibe/bundled/skills/.system/skill-installer
Command: npx skills add https://github.com/kk20300113-png/my-claude-skills --skill skill-installer-kk20300113-png

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill eliminates the tedious manual work of locating, downloading, and configuring Codex skills from various sources, saving you time and preventing configuration errors from manual setup.

Core Features & Use Cases

  • List Available Skills: View curated or experimental skills from the official OpenAI skills repository, with markers for skills already installed on your system.
  • Install from Any Source: Add skills directly from public GitHub repos, private repos (with authentication), or custom GitHub URLs.
  • Reliable Installation: Automatically falls back to git sparse checkout if direct download fails, and validates skill structure and destination paths to prevent overwrites or corrupted installs.
  • Use Case: If your team hosts custom Codex skills for internal developer tools in a private GitHub repository, use this Skill to quickly install the latest version of any skill to your local Codex setup without manual cloning or file management.

Quick Start

Use the skill-installer to install the 'internal-api-tester' skill from your team's private GitHub repo 'your-org/codex-skills' to your local Codex skills directory.

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

To install Codex skills from a private GitHub repository, you can use the skill-installer to handle authentication and fallback download methods. It automatically manages access-restricted repos and deploys validated skills to your $CODEX_HOME/skills directory.

What is the best way to list available curated Codex skills?

The best way to list available curated Codex skills is to use the skill-installer's listing feature. It displays official or experimental skills from the OpenAI repository and automatically marks skills already installed on your local system.

Can I install custom Codex skills from arbitrary GitHub URLs?

Yes, you can install custom Codex skills from arbitrary public or private GitHub URLs. The skill-installer validates the skill structure and destination paths to prevent corrupted installs or accidental overwrites of existing configurations.

Does installing Codex skills overwrite existing configurations in the skills directory?

No, installing Codex skills does not overwrite existing configurations. The skill-installer performs checks for existing installations in the $CODEX_HOME/skills directory and validates required SKILL.md files before deploying.

Why does my Codex skill installation fail when downloading from GitHub?

Your Codex skill installation might fail due to access restrictions or download errors. The skill-installer automatically falls back to git sparse checkout if direct download fails, ensuring reliable installation from public or private GitHub repositories.