skill-installer

Install skills into a Codex skills directory from GitHub repositories.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Estom/aiflex --skill skill-installer-estom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/Estom/aiflex/tree/main/skills-repo/openai-skills/skill-installer
Command: npx skills add https://github.com/Estom/aiflex --skill skill-installer-estom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Provides a simple, reliable way to discover and install Skill directories into a user's Codex skills folder, removing manual steps of fetching, validating, and copying skill repositories.

Core Features & Use Cases

  • List available skills: Fetches curated or experimental skill listings from a GitHub repo path and annotates which are already installed.
  • Install from GitHub: Downloads a skill directory via direct archive download or uses git sparse-checkout as a fallback, supporting public and private repos.
  • Safety and validation: Validates relative paths, ensures SKILL.md exists in the selected directory, prevents overwriting existing installations, and supports ref/dest/name/method options.
  • Use Case: Quickly add a new curated or experimental skill from openai/skills into your local Codex skills directory for immediate use by your agents.

Quick Start

Ask to install a curated skill by name and the installer will fetch it from openai/skills (or from a provided GitHub repo/path) into $CODEX_HOME/skills and then advise you to restart Codex.

Frequently Asked Questions about skill-installer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a curated GitHub skill into Codex?

To install a curated skill into Codex, you fetch a specific skill directory from a GitHub repository path directly into your $CODEX_HOME/skills folder. The installer validates SKILL.md presence and prevents overwriting existing destinations before advising a restart.

Can I install skills from private GitHub repositories into my Codex skills directory?

Yes, you can install skills from private GitHub repositories into your Codex skills directory. The installer supports both public and private repos by using direct archive downloads or git sparse-checkout fallbacks to fetch the directories.

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

Listing available experimental skills involves fetching curated listings from a specified GitHub repository path. The installer then annotates which skill directories are already installed in your local $CODEX_HOME/skills folder.

Does the Codex skill installer overwrite existing skill directories?

No, the Codex skill installer does not overwrite existing skill directories. It includes safety validations that explicitly prevent overwriting existing installations, ensuring your current skills remain intact during the download process.

Why does installing a GitHub skill require a SKILL.md file validation?

Installing a GitHub skill requires SKILL.md validation to ensure the selected directory contains a properly formatted skill definition. This safety check confirms the fetched directory is a valid skill before it is copied into your $CODEX_HOME/skills folder.

What happens if direct archive download fails when fetching a skill from GitHub?

If direct archive download fails when fetching a skill from GitHub, the installer automatically falls back to using git sparse-checkout. This ensures the skill directory is still retrieved and placed into your $CODEX_HOME/skills folder successfully.