🎯

skill-installer

🎯Skill

from yuanxiao0115/agent-skills

What it does

Installs Codex skills from curated lists or GitHub repos, supporting public and private skill sources with flexible installation options.

📦

Part of

yuanxiao0115/agent-skills(22 items)

skill-installer

Installation

Quick InstallInstall with npx

npx skills add yuanxiao0115/agent-skills/skills --all

Quick InstallInstall with npx

npx skills add yuanxiao0115/agent-skills/skills/read-github

Quick InstallInstall with npx

npx skills add yuanxiao0115/agent-skills/skills --skill read-github planner

Quick InstallInstall with npx

npx skills add yuanxiao0115/agent-skills/skills /path/to/your/project

npm installInstall npm package

npm install -g skills

+ 22 more commands

📖 Extracted from docs: yuanxiao0115/agent-skills

Need more details? View full documentation on GitHub →

4Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

Overview

# Skill Installer

Helps install skills. By default these are from https://github.com/openai/skills/tree/main/skills/.curated, but users can also provide other locations.

Use the helper scripts based on the task:

List curated skills when the user asks what is available, or if the user uses this skill without specifying what to do.
Install from the curated list when the user provides a skill name.
Install from another repo when the user provides a GitHub repo/path (including private repos).

Install skills with the helper scripts.

Communication

When listing curated skills, output approximately as follows, depending on the context of the user's request:

"""

Skills from {repo}:

skill-1
skill-2 (already installed)
...

Which ones would you like installed?

"""

After installing a skill, tell the user: "Restart Codex to pick up new skills."

Scripts

All of these scripts use network, so when running in the sandbox, request escalation when running them.

scripts/list-curated-skills.py (prints curated list with installed annotations)
scripts/list-curated-skills.py --format json
scripts/install-skill-from-github.py --repo / --path [ ...]
scripts/install-skill-from-github.py --url https://github.com///tree//

Behavior and Options

Defaults to direct download for public GitHub repos.
If download fails with auth/permission errors, falls back to git sparse checkout.
Aborts if the destination skill directory already exists.
Installs into $CODEX_HOME/skills/ (defaults to ~/.codex/skills).
Multiple --path values install multiple skills in one run, each named from the path basename unless --name is supplied.
Options: --ref (default main), --dest , --method auto|download|git.

Notes

Curated listing is fetched from https://github.com/openai/skills/tree/main/skills/.curated via the GitHub API. If it is unavailable, explain the error and exit.
Private GitHub repos can be accessed via existing git credentials or optional GITHUB_TOKEN/GH_TOKEN for download.
Git fallback tries HTTPS first, then SSH.
The skills at https://github.com/openai/skills/tree/main/skills/.system are preinstalled, so no need to help users install those. If they ask, just explain this. If they insist, you can download and overwrite.
Installed annotations come from $CODEX_HOME/skills.

More from this repository10

🎯

read-github🎯Skill

Retrieves and searches GitHub repository documentation and code via gitmcp.io, enabling easy exploration of project contents and details.

🎯

agent browser🎯Skill

Enables AI-powered browser automation using a fast Rust-based CLI with Node.js fallback, allowing programmatic web interaction and control.

🎯

frontend-design🎯Skill

Crafts distinctive, production-grade frontend interfaces with exceptional design quality, avoiding generic AI aesthetics.

🎯

planner🎯Skill

Generates comprehensive, phased implementation plans with detailed sprints, atomic tasks, and clear requirements clarification across multiple project stages.

🎯

context7🎯Skill

Retrieves up-to-date library documentation via Context7 API, ensuring access to current technical references beyond training data limitations.

🎯

parallel-task🎯Skill

Launches parallel subagents to simultaneously execute tasks from a markdown plan file, triggered by "/parallel-task" command.

🎯

plan-harder🎯Skill

Generates comprehensive, phased implementation plans with atomic tasks, sprints, and detailed requirements analysis for complex development requests.

🎯

web-design-guidelines🎯Skill

Provides comprehensive web design guidelines and best practices for creating user-friendly, accessible, and visually appealing websites.

🎯

vue-best-practices🎯Skill

Enforces Vue 3 TypeScript best practices by providing comprehensive type-safe rules for component props, templates, modules, and performance optimization.

🎯

skill-creator🎯Skill

Scaffolds, validates, and packages Codex skills using helper scripts for efficient skill development and management.