Codex

Install a skill in Codex

Codex reads skills from a folder on your machine. Put yours in the right one and you can call it with a dollar sign from any session.

Four stepsWorks per repo tooNo account needed
Step 1 of 4
Codex looks here
~/.agents/
skills/
sponsor-outreach/
SKILL.md
~/.codex/skills/config lives here, not skills

Make a folder in the agents directory

Codex reads skills from a folder called .agents, not from the .codex folder where its config lives. This trips up almost everyone the first time.

mkdir -p ~/.agents/skills/sponsor-outreach

The one that catches people out. It is ~/.agents/skills/, not ~/.codex/skills/. The dot-codex folder holds your config, so people put skills there and then wonder why nothing shows up.

If it does not appear

Codex usually spots new skills on its own. If yours is missing, restart Codex and check again.

Not the same as AGENTS.md

AGENTS.md is always-on context for a repo, loaded every run. A skill loads only when it is picked. Useful together, but AGENTS.md is not how you install one.

Using something else?