Codex에서 Claude Skills을 이용하는 방법
2025.11.06

Claude Skills는 Claude Code뿐 만 아니라, OpenAI의 Codex에서도 사용할 수 있습니다. Robert Glaser가 공유한 방법을 정리해보았습니다.

우선 Anthropic이 공개한 SKILLS를 Codex 프로젝트에 복제했습니다. 이건 Codex에서 사용하고 싶은 SKILLS를 임의로 추가해서 사용하시면 됩니다.

그런 다음 아래와 같은 list-skills 라는 파일을 추가해줍니다. list-skills는, 앞서 추가한 skills 파일에 있는 SKILL.md 를 읽는 방식입니다.
#!/usr/bin/env -S uv run -s
# /// script
# requires-python = ">=3.8"
# dependencies = ["python-frontmatter","pyyaml"]
# ///
import os, sys, json
from pathlib import Path
import frontmatter
root = (
Path(sys.argv[1])
if len(sys.argv) > 1
else Path(
os.environ.get("CODEX_SKILLS_DIR", str(Path.home() / ".config/codex/skills"))
)
)
if not root.exists():
print(f"missing skills dir: {root}", file=sys.stderr)
sys.exit(1)
skills = []
for f in sorted(root.rglob("SKILL.md")):
meta = (frontmatter.load(f).metadata) or {}
n, d = meta.get("name"), meta.get("description")
if isinstance(n, str) and isinstance(d, str):
item = {"name": n, "description": d, "path": str(f)}
if "allowed-tools" in meta:
item["allowed-tools"] = meta["allowed-tools"]
skills.append(item)
skills.sort(key=lambda s: s["name"])
json.dump(skills, sys.stdout, ensure_ascii=False, indent=2)
마지막으로 AGENTS.md에, Codex가 Skills을 가지고 있고 list-skills에 있는 내용을 읽어 어떤 스킬이 있는지 확인하라는 내용을 추가해줍니다.
# Agent Instructions
## Skills
You've got skills.
- List your skills directly after reading this via `scripts/list-skills skills/`. Remember them.
- If a skill matches a certain task at hand, only then read its full documentation (`SKILL.md`) and use it.이러면 Codex가 작동할 때, list-skills을 통해 어떤 skills이 있는지 파악하고 상황에 맞게 사용할 수 있습니다.
Anthropic의 SKILLS에는 알고리즘 아트를 만드는 SKILL이 있어 “알고리즘으로 예술을 표현해주세요”라고 요청했습니다.

그랬더니 OpenAI의 Codex가 list-skills를 통해 어떤 SKILL이 있는지 파악했고, 적절한 SKILL.md를 찾은 것을 확인할 수 있습니다.

그리고 해당 SKILL을 이용해 알고리즘 아트를 구현한 것을 확인할 수 있습니다.
이처럼 ClaudeCode 뿐 만 아니라 OpenAI의 Codex에서도 Claude Skills를 사용할 수 있습니다.
만약, 다른 사람들의 사례를 보면서, Claude Skill을 더 깊게 활용하고 싶다면 지피터스 AI 스터디에 참여해보세요. 다른 사람의 사례를 보고 정말 많이 배우게 됩니다.


좋은정보 감사해요!
2번의 실패 끝에 성공했습니다.
실패원인은 AGENTS.md 를 글에서 주어진 것으로 복사붙여 넣기 안하고 codex 명령어 /init 를 이용했더니 ~ 배가 산으로 갔다 오네요.
따라하면서 파이썬 스크립트 list-skills 가 왜 필요한걸까 궁금해서 그냥 물어봤습니다.
"지정된 디렉토리에서 스킬(Skill) 관련 정보를 수집하고, 그 메타데이터를 추출하여 정렬된 JSON 형식으로 표준 출력(stdout)에 내보내는 것"
YAML 형식으로 해서, 경로를 알려주는 용도로 list-skills가 필요한 것으로 알고 있습니다!