본문으로 건너뛰기

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

김욱영

2025.11.06

Codex에서 Claude Skills을 이용하는 방법 본문 이미지

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이 있어 “알고리즘으로 예술을 표현해주세요”라고 요청했습니다.

Python 스크립트의 스크린샷

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

그리고 해당 SKILL을 이용해 알고리즘 아트를 구현한 것을 확인할 수 있습니다.

이처럼 ClaudeCode 뿐 만 아니라 OpenAI의 Codex에서도 Claude Skills를 사용할 수 있습니다.

만약, 다른 사람들의 사례를 보면서, Claude Skill을 더 깊게 활용하고 싶다면 지피터스 AI 스터디에 참여해보세요. 다른 사람의 사례를 보고 정말 많이 배우게 됩니다.

지피터스 스터디 살펴보기 →

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

이지영 프로필 이미지
이지영2025.11.06

좋은정보 감사해요!

2번의 실패 끝에 성공했습니다.
실패원인은 AGENTS.md 를 글에서 주어진 것으로 복사붙여 넣기 안하고 codex 명령어 /init 를 이용했더니 ~ 배가 산으로 갔다 오네요.

따라하면서 파이썬 스크립트 list-skills 가 왜 필요한걸까 궁금해서 그냥 물어봤습니다.

"지정된 디렉토리에서 스킬(Skill) 관련 정보를 수집하고, 그 메타데이터를 추출하여 정렬된 JSON 형식으로 표준 출력(stdout)에 내보내는 것"

김욱영 프로필 이미지
김욱영2025.11.06

YAML 형식으로 해서, 경로를 알려주는 용도로 list-skills가 필요한 것으로 알고 있습니다!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기