# Using SkillMD Skills with OpenAI Codex

> skillmd.com is an open registry of Agent Skills (SKILL.md files). Every listed skill passes a safety review before it is publicly visible. This guide covers OpenAI Codex.

## Where OpenAI Codex looks for skills
- Project scope: ./.codex/skills/<skill-name>/SKILL.md
- Global scope: ~/.codex/skills/<skill-name>/SKILL.md

## Install a skill (CLI)
npm i -g skillmds
skillmd add <owner>/<name> -a codex        # project scope
skillmd add <owner>/<name> -a codex -g     # global scope

## Install a skill (manual)
Copy the SKILL.md from https://skillmd.com/skills/<owner>/<name> into .codex/skills/<skill-name>/SKILL.md.

## Find skills
- https://skillmd.com/search?q=<query>
- JSON API: https://api.skillmd.com/v1/search?q=<query>
- Human guide: https://skillmd.com/agents/codex
- All agent guides: https://skillmd.com/agents.txt