skill-installer

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

Updated Sep 1, 2025
One-click install
npx skills add https://github.com/mathur-exe/annotation-notes --skill skill-installer-mathur-exe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-installer
Source: https://github.com/mathur-exe/annotation-notes/tree/main/PaperNotes/dotfiles/codex/skills/.system/skill-installer
Command: npx skills add https://github.com/mathur-exe/annotation-notes --skill skill-installer-mathur-exe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Installing Codex skills into CODEX_HOME/skills from curated sources or GitHub repos can be error-prone and time-consuming without a unified installer.

Core Features & Use Cases

  • Discover installable skills from curated lists or from a GitHub path
  • Install a curated skill by name or install directly from a repo URL/path
  • Validate skill directories via SKILL.md and place them under CODEX_HOME/skills

Quick Start

Install a skill by name from the curated list, or provide a GitHub URL or owner/repo path to install a new skill.

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 providing a repo URL or owner/repo path. The installer uses direct download or Git sparse-checkout to fetch skills and places them into CODEX_HOME/skills.

What is a curated skill list and how do I use it?

A curated skill list is a pre-validated collection of installable skills. You can use it to discover available skills and install a specific skill by name directly into your CODEX_HOME/skills directory.

Can I install skills from private GitHub repositories?

Yes, you can install skills from private GitHub repositories. The installer supports fetching skills from private repos using either direct download or Git sparse-checkout, placing them under CODEX_HOME/skills.

Does the installer validate the skill directory structure before installation?

Yes, the installer relies on local validation of SKILL.md at the skill root. This ensures the skill directory is valid before placing it into CODEX_HOME/skills.

What components are supported when installing a skill from a curated list or repo?

When installing a skill, the installer supports optional scripts, references, and assets. These components are fetched from the curated list or GitHub repo and placed under CODEX_HOME/skills.

Why use Git sparse-checkout to install skills instead of cloning the whole repository?

Git sparse-checkout is used to fetch only the necessary skill directories from a repository, reducing download time and storage. This method populates CODEX_HOME/skills efficiently without cloning the entire repo.