Install Skills in OpenAI Codex

This guide covers installing skills in OpenAI Codex CLI. Looking for Claude? See Install Skills in Claude.

Step 1: Download from SkillHub

1. Browse skills on SkillHub
2. Click on a skill to view its details
3. Click the "Download" button to get the skill package

Step 2: Install the Skill

Extract the downloaded .zip file and copy it to one of these locations:

• your-project/.codex/skills/ — Available only in that project (recommended)
• ~/.codex/skills/ — Available globally across all projects
• /etc/codex/skills/ — System-level skills (requires admin access)

Precedence: Codex loads skills from project-level first, then user-level, then system-level. Project skills override global ones with the same name.

Using the Skill Installer

You can also use Codex's built-in skill installer for skills from the official OpenAI skills repository:

$skill-installer skill-name

Step 3: Restart Codex

After installing a skill, restart Codex to load the new skill. Codex will automatically detect and use installed skills when relevant to your task.

Skill Package Structure

SkillHub packages follow the open Agent Skills specification:

• SKILL.md — Instructions and metadata (required)
• scripts/ — Executable code (optional)
• references/ — Documentation (optional)
• assets/ — Templates and resources (optional)

Next Steps

• Browse more skills

Official Documentation

• OpenAI Developer Docs: Skills
• Agent Skills Specification