skill-installer

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/caicai557/windsurf-project --skill skill-installer-caicai557
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/caicai557/windsurf-project/tree/main/.codex/skills/.system/skill-installer
Command: npx skills add https://github.com/caicai557/windsurf-project --skill skill-installer-caicai557

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps install Codex skills from curated lists or external GitHub repos, enabling quick setup of new capabilities.

Core Features & Use Cases

  • Curated listing & installation: List and install skills from curated sources.
  • GitHub-based installation: Install directly from GitHub paths or repos.
  • Quick Start: After installation, restart Codex to pick up new skills.

Quick Start

Use the install-skill-from-github.py script to install a skill from a GitHub path, or use the curated scripts to list and install.

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 GitHub repositories?

Install Codex skills from GitHub repos using the skill-installer, which downloads skill content, validates the SKILL.md file, and places it in CODEX_HOME/skills. Support includes curated lists, direct GitHub paths, and private repositories.

What's the quickest way to add new skills to my Codex setup?

Use curated skill listings or point the installer to a GitHub repository. The skill-installer fetches content, validates structure, and installs to CODEX_HOME/skills, then prompts you to restart Codex to activate the new skills.

Can I install Codex skills from private GitHub repositories?

Yes, the skill-installer supports installation from private GitHub repos alongside public repositories and curated lists, enabling flexible skill sourcing for team or organizational use.

Does skill-installer validate skills before installation?

Yes, skill-installer verifies that SKILL.md exists in the downloaded content before installation, ensuring only valid skills are placed in CODEX_HOME/skills.

What do I need before installing skills with this tool?

Ensure CODEX_HOME environment variable is set and PyYAML is installed. The skill-installer handles GitHub authentication and sparse-checkout to fetch and validate skill content.

Related Skills