Access all Premium Skills for US$8.99/month. Cancel anytime.See plans

Codex Skills: add and use Agent Skills in OpenAI Codex

Codex reads Skills from ~/.agents/skills/, still reads the older ~/.codex/skills/, and runs one when you type $ and its name. This guide shows how to install one, check it loaded, and decide what belongs in a Skill versus AGENTS.md.

For
Codex users
Time
8 min to complete

SKILL LIBRARY GUIDE

Install and use a Skill

Browse the Skill Library library, sign in, and open a published Skill. Select Download to get its ZIP package. Your account must have access to the selected Skill.

Install from a ZIP

  1. Extract the downloaded ZIP into a separate folder.
  2. Read SKILL.md and check the required tools and dependencies.
  3. Ask your AI agent to install the extracted folder into the workspace you choose.
  4. Run a small example and review the result before using it for your project.

Updates

Download the newly published version from the Skill page. Back up your local changes before replacing an existing installation.

Skill Library currently supports website downloads. CLI installation and automatic updates are not available.

Browse Skills →

Read next

All guides
Skills vs instructionsCLAUDE.md, AGENTS.md, and Cursor rules load every time; Skills load only when needed.How to use SkillsWhat to give a Skill, how to check the files it makes, and how to get a better second draft.TroubleshootingMissing from the list, never runs, fails partway? Find the fix by what you see.Compare agentsClaude Code vs Codex vs Cursor for Skills: folders, commands, name rules, and cloud use.