skill-installer

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Install and manage Codex skills into $CODEX_HOME/skills without manual copying or complex git commands, simplifying discovery and installation of curated or repo-hosted skills.

Core Features & Use Cases

  • List available skills: Fetches curated or experimental listings from a GitHub repo and annotates which skills are already installed.
  • Install curated or repo skills: Install by name from the curated list or by providing a GitHub repo/path or URL; supports installing multiple skills at once.
  • Robust download strategies: Defaults to direct download for public repos, falls back to git sparse-checkout for authenticated or restricted repos, validates SKILL.md, and prevents overwriting existing installations.
  • Use Case: A developer can list installable skills from openai/skills and install a chosen curated skill or add a skill from a private repo using their existing GitHub credentials.

Quick Start

Install a named skill from the curated list or provide a GitHub repo/path to add the skill to your Codex skills directory.

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?

To install Codex skills from a GitHub repository, provide a repo path or URL and the tool downloads them into $CODEX_HOME/skills. It validates SKILL.md presence and aborts on destination conflicts to prevent overwriting.

Can I install skills from private GitHub repos?

Yes, you can install skills from private GitHub repos. The tool falls back to authenticated git sparse-checkout over HTTPS or SSH using your existing GITHUB_TOKEN or GH_TOKEN credentials for access.

How can I list available skills before installing them?

You can list available skills by fetching curated or experimental listings from a GitHub repo. The tool annotates which skills are already installed in your local environment to help you track your current setup.

Does the skill installer validate files before completing the installation?

Yes, the skill installer validates SKILL.md presence before completing the installation. It defaults to public direct downloads and aborts the process if it detects destination conflicts to protect existing files.

What happens if I try to install a skill that already exists locally?

If you try to install a skill that already exists locally, the installation aborts to prevent overwriting your existing files. You must manually resolve the destination conflict before attempting the installation again.