skillshop
Codex guide

Use Claude skills in Codex and Cursor

4 min readUpdated Skillshop operator and creator of the Maker Evan YouTube channel

Translated from Korean. View original. Some screenshots are available in Korean only.

A skill used in Claude Code can also be useful in Codex or Cursor. All three support the SKILL.md format, but paths and tool-specific features differ. After moving the folder, check that the skill appears, prepare required programs and MCP connections, and try a small task.

Browse relevant skills and examples on Skillshop.

View original Korean screenshot
스킬샵 스킬 상세 화면. 썸네일 아래 제목과 별점, 사용자 수, 크리에이터 정보가 나온다.
스킬샵에서 관련 작업의 스킬과 사용 예시를 살펴볼 수 있어요.

Other tools can read the same SKILL.md

A skill is a folder containing SKILL.md and any references or scripts it needs. Several AI tools support a common format with a name, description and work instructions.

Basic procedures can be reused, but Claude Code-specific commands or settings do not necessarily work unchanged. Check supported tools, executables and connections before moving one.

A skill folderSKILL.md is human-readable text.
Put it where the tool looksUse a folder the tool scans when starting.
Check the new environmentReview format, tool-specific features and dependencies.
A skill folder contains SKILL.md and needed references or scripts.
Cursor official skills guide →

Check the skill folder for each tool

Claude Code supports project .claude/skills and personal ~/.claude/skills. Codex uses project .agents/skills and personal ~/.agents/skills.

Cursor supports .cursor/skills and compatibility locations. Paths and priority differ; check the current official documentation for each tool. After moving a folder, inspect the skill list in a new session.

ToolProject skill folderPersonal path and checks
Claude Code.claude/skillsAlso supports personal ~/.claude/skills.
Codex.agents/skillsAlso uses personal ~/.agents/skills.
Cursor.cursor/skillsCheck current official documentation for compatibility paths and priority.
Check the skill list in a new session; paths and tool-specific features differ.
Claude Code.claude/skillsCheck project and home-folder locations.
Codex.agents/skillsCheck project and personal skill paths.
Cursor.cursor/skillsConsult current Cursor docs for additional compatibility paths.
Claude Code supports project and personal skill paths.
Choose where skills load in Anthropic's English documentation
An example from the official documentation. Check the current linked setup guide.Source: Claude Code documentation
Open full-size image (opens in a new tab)
View original Korean screenshot
클로드 코드 공식 문서의 Skills 위치 표. 위치·경로·적용 대상 세 열에 Enterprise·Personal·Project·Plugin 네 행이 있고, Personal 경로는 ~/.claude/skills/ 다.
공식 문서의 화면 예시예요. 현재 설정은 연결된 공식 안내에서 확인해 주세요.출처: 클로드 코드 공식 문서: Skills

Choose a source of truth for multiple tools

Copies of a skill in multiple folders can drift apart. Agree on a team source location and record how it is made available to other tools.

You can use a symbolic link to point at a source. Check operating-system and tool support first, and inspect any existing folder before applying it. Keeping team skills in a repository and personal ones in a personal folder helps distinguish them.

  • .agents/skills/One source copy
  • my-skill/One folder per skill
  • SKILL.mdEdit this source file
  • .claude/skillsA link to the source folder
Copies in multiple folders can drift apart.
Detailed installation guide →

Put shared project rules in AGENTS.md

Use AGENTS.md for recurring project rules such as edit boundaries, commands and validation. Put a specific procedure such as report writing or code review in a skill.

CLAUDE.md can serve a similar purpose in Claude Code. To manage common content in one place, use a supported document-reference method and check that files do not contain conflicting rules.

Rules filesAGENTS.md and CLAUDE.md contain recurring project instructions.
SkillA specific task procedure loaded when needed.
ReferencesMaterial selected from a skill when needed.
AGENTS.md can hold edit boundaries, commands and checks.

If the result differs, check whether the skill ran

First check whether the AI read the relevant SKILL.md. If it is absent from the list, check location and format; if listed but not selected, check the description and invocation.

If it was read but failed, check executables, MCP connections, permissions and project instructions. The model can also affect results. Describe the difference between expected and actual results when revising.

Not selectedDescriptionOpen the beginning of SKILL.md.
Called but differentRules filesCompare AGENTS.md and CLAUDE.md.
Keeps changingAmbiguityFind instructions that can be read two ways.
First check whether the AI read the relevant SKILL.md.

Avoid duplicate skills with the same name

The selected version can be hard to determine when different folders contain skills with the same name. Check each tool’s priority and remove unnecessary copies.

Inspect both folder names and the SKILL.md name setting. Naming rules differ between tools, so do not assume changing a folder name resolves every conflict.

Separate copies
  • The same skill exists in two folders
  • AGENTS.md and CLAUDE.md disagree
  • It is hard to know which tool has the latest version
A shared source
  • The source files live in one place
  • One rules file references the other
  • There is one place to update
Duplicate skill names make the selected version hard to identify.

Compare results using a small input

Save the input and output from a simple task in the original tool. Load the same skill and input in the new tool, then compare output format and missing steps.

Even after one success, retest if the model or connected service changes. Record the tools and settings used in the skill description for the next migration.

Get a free skillStart with one downloaded folder.
Run it in the original toolTry it with your usual agent.
Open it in another toolUse the supported path and compare results.
Keep a simple input and output from the original tool.

Try the same skill folder in both tools with a low-cost example.

View original Korean screenshot
스킬샵 카탈로그에서 무료 필터를 켠 목록 화면. 카드마다 썸네일과 별점, 사용자 수가 붙어 있다.
한 폴더를 두 도구에서 돌려 보는 실험은 값이 가장 낮은 스킬로 하면 된다.
Browse all skills →Browse coding and agent skills →What are Claude skills? →

Frequently asked questions

Can Codex or Cursor use skills from Claude Code unchanged?

All three support SKILL.md, so basic procedures can be reused. Tool-specific commands, settings, programs and MCP connections may differ. Put the skill in a supported path and check recognition and results.

How do AGENTS.md and skills differ?

AGENTS.md holds recurring project rules such as edit boundaries, commands and validation. A skill holds a particular procedure such as reporting or code review. Consult each tool’s guidance on instruction scope and invocation.

Must I copy a skill for each tool?

You can copy it, but manage version drift. Another option is a common source connected through paths each tool supports. For symbolic links, verify OS and tool support and inspect existing folders first.

Sources