skill-installer

Install Codex skills from curated GitHub lists or repo paths.

4|1|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/yoyooyooo/logix --skill skill-installer-yoyooyooo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/yoyooyooo/logix/tree/main/.codex/skills/.system/skill-installer
Command: npx skills add https://github.com/yoyooyooo/logix --skill skill-installer-yoyooyooo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires urllib, zipfile, subprocess, shutil, argparse, tempfile, os, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the problem of installing new Codex skills on demand, whether the user wants a curated skill from a known list or a skill from a specific GitHub repo path.

Core Features & Use Cases

  • Curated skill discovery: Lists available skills from a curated GitHub directory and marks which ones are already installed.
  • Curated installation by name: Installs a selected skill from the curated list into Codex’s local skills directory.
  • GitHub repo/path installation: Installs one or multiple skills from an arbitrary GitHub repo path (including private repos when credentials are available).
  • Robust install strategies: Uses download-by-archive by default and falls back to git sparse checkout when needed, while validating that the target contains a root SKILL.md.
  • Guardrails: Refuses to overwrite an existing destination skill directory and exits with clear errors when paths or SKILL.md are missing.

Quick Start

Ask to install a specific skill by name from the curated list using the skill-installer flow.

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 downloading an archive or using git sparse checkout to place them in $CODEX_HOME/skills. The installer validates that the target path contains a SKILL.md file before completing the installation safely.

What is a curated Codex skill directory?

A curated Codex skill directory is a predefined GitHub list of available skills retrieved via the GitHub API. It allows users to discover available skills, mark already installed ones, and install new skills by name directly into the local skills directory.

Can I install skills from private GitHub repositories?

Yes, you can install skills from private GitHub repositories by providing optional authentication via GITHUB_TOKEN or GH_TOKEN environment variables. This allows the installation logic to securely access and extract skills from private repo paths.

Does the Codex skill installer overwrite existing skill directories?

No, the Codex skill installer refuses to overwrite an existing destination skill directory. It includes guardrails that exit with clear errors when the destination already exists or when the required SKILL.md file is missing from the target root.

What happens if a downloaded skill is missing SKILL.md?

If a downloaded skill is missing SKILL.md, the installation fails with a clear error. The installer validates the target root contains SKILL.md during the download or sparse-checkout process to ensure only valid skills are installed into the local directory.