What problem does it solve?
Installs and manages Codex/agentic skills by automating listing, downloading, validating, and placing skill directories so users do not have to manually fetch archives, run git operations, or copy files into their local skills directory.
Core Features & Use Cases
- List Available Skills: Fetch and present skills from a curated path or an experimental path in a GitHub repo with annotations for already installed skills.
- Install from Curated or Arbitrary Repo Paths: Download repository archives or use git sparse-checkout to extract one or more skill directories and copy them into $CODEX_HOME/skills.
- Robust Fallbacks and Validation: Handles public downloads and authentication fallbacks, validates relative paths and skill names, requires SKILL.md in the target directory, prevents overwriting existing installations, and supports options for ref, dest, method, and explicit naming.
- Use Case: When a user requests installation of a named curated skill or provides a GitHub repo/path, run the appropriate helper script to retrieve and install the skill and then inform the user to restart Codex.
Quick Start
Install the curated skill example-skill from the default curated list by asking the assistant to install example-skill.
