AIPM
Theme

Skills by tool

Skills for Codex

Codex is OpenAI's coding agent. It can follow a skill in the repo when a task matches that skill's description.

Short answer

Codex reads project skills from .agents/skills/<name>/SKILL.md. It does not read Claude's .claude/skills folder. Install the same SKILL.md with aipm add @scope/name@version --target codex, then review the files.

Claude Code vs Cursor vs Codex

This page is the Codex column. The other columns are here so you can see the path and the install flag before you pick a tool.

Claude Code vs Cursor vs Codex: where skills go, and how AIPM installs them.
Claude CodeCursorCodex
What it isAnthropic's coding agent in the terminal or an IDEA code editor with a built-in coding agentOpenAI's coding agent
Skills path.claude/skills/<name>/SKILL.md.cursor/skills/<name>/SKILL.md.agents/skills/<name>/SKILL.md
How skills loadName and description first. Full file when the task matches.Name and description first. Full file when the task matches, or when you type /skill-name.Name and description first. Full file when the task matches.
AIPM target flag--target claude--target cursor--target codex
Install commandaipm add @scope/name@version --target claudeaipm add @scope/name@version --target cursoraipm add @scope/name@version --target codex
Good forClaude Code sessions in a repoDay-to-day editing in CursorCodex sessions in a repo

Install into Codex

AIPM writes .agents/skills/<name>/SKILL.md. Run this from the project folder, then read the files it adds.

aipm add @scope/name@version --target codex

What AIPM does differently

  • You install a named version, such as @scope/name@1.2.0. The project file aipm.package.json remembers it, so the next person gets the same skill.
  • AIPM writes the skill files into the repo. You can read them before anyone relies on them.
  • The same skill can be installed for Claude Code, Cursor, or Codex. Change the --target flag and the folder changes with it.

Keep going

FAQ

Can Codex use a skill written for Claude?

Yes, if that SKILL.md is installed into .agents/skills/<name>/SKILL.md. Codex does not read .claude/skills. Use aipm add @scope/name@version --target codex.

How do I install a Codex skill with AIPM?

Run aipm add @scope/name@version --target codex. AIPM writes .agents/skills/<name>/SKILL.md and records the version in the project.

Does this page replace OpenAI's Codex docs?

No. OpenAI's docs are the full reference. This page is a short summary, a comparison with Claude Code and Cursor, and the AIPM install path.

Can one package serve Claude Code and Codex?

Yes. Install the same package once with --target claude and once with --target codex. Each command writes the folder that tool reads.