Codex Agent Skills: Reusable Task Bundles

Codex now supports agent skills—reusable instruction bundles you can invoke explicitly or let Codex auto-select. Install per-user or per-repo, with built-in and curated skills available.

Codex Agent Skills: Reusable Task Bundles

TL;DR

  • Codex now supports agent skills — reusable instruction bundles that help complete specific tasks reliably
  • Invoke skills explicitly with $skill-name or let Codex auto-select based on your prompt
  • Install per-user (~/.codex/skills) or per-repo (.codex/skills); built-in skills included

New

  • Agent skills — Reusable bundles of instructions, scripts, and resources that Codex can invoke automatically or on-demand to complete specific tasks reliably.
  • Explicit skill invocation — Type $skill-name (e.g., $skill-installer) to trigger a skill directly in CLI and IDE extensions.
  • Auto-selection — Codex can detect which skill to use based on your prompt without explicit invocation.
  • Folder-based standard — Skills follow the open agent skills specification with SKILL.md (required) plus optional scripts/, references/, and assets/ directories.
  • Flexible installation — Install skills per-user in ~/.codex/skills or per-repo in .codex/skills for team sharing.
  • Curated skills directory — Codex ships with built-in skills like $skill-creator and $skill-installer; a curated set is available on GitHub, with more coming.
  • Experimental $create-plan skill — Available for install via $skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan.

To get started, check the skills documentation. Update Codex to the latest version to access agent skills.

Source: Codex