How to add skills in Codex

Start from Codex Build skills.

Read developers.openai.com/codex/skills. A skill is a directory with SKILL.md plus optional scripts and references. ChatGPT and Codex activate a skill when you mention it or when the task matches the description.

In Codex CLI or the IDE extension, run /skills or type $ to mention a skill. In ChatGPT, type @ to select a skill.

Where Codex loads local skills.

From that page:

• Repo: .agents/skills from the current working directory up to the repository root
• User: $HOME/.agents/skills
• Admin: /etc/codex/skills

That doc does not list a ~/.codex/skills folder as a Codex load path. Use .agents/skills (or the user home .agents/skills) as written. Plugins distribute reusable skills beyond one repo. $skill-installer installs curated skills for local use.

Add a Tiny Design Shop skill.

Get the folder from a companion or GitHub and place it under .agents/skills/<pack>/ in the repo or under $HOME/.agents/skills/. Codex detects changes automatically; restart Codex if an update does not appear.

Confirm it loaded.

Run /skills or mention the skill with $. To disable without deleting, the doc shows [[skills.config]] in ~/.codex/config.toml with enabled = false and a path to that SKILL.md.