본문으로 건너뛰기
Codex DesignBETA

Codex 스킬.

Codex 스킬은 SKILL.md 파일이 들어 있는 폴더로, CI 고치기나 디자인 리뷰 같은 한 가지 작업 방식을 Codex에 가르칩니다. 이 가이드에서는 스킬을 두는 위치, 설치하고 호출하는 방법, Codex가 알맞은 때에 골라 쓰는 스킬을 만드는 방법, 먼저 설치할 만한 스킬을 다룹니다.

2026년 11월 12일 업데이트 · 7분 분량

짧게 답하자면

  • 스킬은 폴더입니다. SKILL.md 파일에 name, description, 그리고 Markdown으로 쓴 지침이 들어 있고, 스크립트와 참고 파일을 함께 둘 수도 있습니다.
  • 설치하려면 Codex에서 $skill-installer와 스킬 이름 또는 GitHub URL을 입력하거나, 폴더를 ~/.agents/skills에 복사하세요. 그런 다음 Codex를 다시 시작합니다.
  • 사용하려면 /skills를 실행하거나 $와 스킬 이름을 입력하세요. 요청이 스킬의 description과 맞으면 Codex가 알아서 스킬을 고르기도 합니다.
  • 만들려면 내장된 $skill-creator를 쓰세요. Codex가 스킬을 쓸지는 description이 결정하니 여기에 가장 많이 신경 쓰세요.
  • OpenAI의 openai/skills 카탈로그는 지원이 중단되었습니다. 새 공식 스킬은 openai/plugins 저장소의 플러그인에 담겨 제공됩니다.

Codex 스킬이란?

스킬은 한 가지 작업을 위한 지침을 묶은 것이며, 스크립트와 리소스를 포함할 수도 있습니다. Codex는 세션을 시작할 때 각 스킬의 name과 description만 읽습니다. 작업이 description과 맞거나 사용자가 스킬을 언급하면 그때 SKILL.md 전체를 불러옵니다. 그래서 스킬을 수십 개 설치해 두어도 컨텍스트 창이 가득 차지 않습니다.

스킬은 공개 표준인 Agent Skills 형식을 따르므로, 같은 폴더를 Claude Code를 비롯해 SKILL.md를 읽는 다른 에이전트에서도 대개 그대로 쓸 수 있습니다. 플러그인은 다른 개념입니다. 여러 스킬과 MCP 서버, 훅을 함께 담을 수 있는 설치용 패키지입니다. 차이는 Codex 플러그인과 스킬의 차이에서 확인하세요.

Codex 스킬이 있는 위치

범위경로용도
저장소현재 폴더 또는 저장소 루트까지의 상위 폴더에 있는 .agents/skills한 프로젝트에만 해당하는 스킬
사용자~/.agents/skills모든 프로젝트에서 쓰고 싶은 스킬
조직/etc/codex/skills관리자가 모두를 위해 설치하는 스킬
시스템Codex에 내장skill-creator, skill-installer 등 몇 가지

Codex는 실행한 위치부터 저장소 루트까지 모든 .agents/skills 폴더를 확인합니다. 이름이 같은 스킬은 하나로 합쳐지지 않고 둘 다 목록에 나타납니다. 심볼릭 링크로 연결한 스킬 폴더도 작동하므로, 스킬을 Git 저장소 한 곳에서 관리할 때 편리합니다.

스킬 사용 방법

  • 골라서 쓰기: Codex CLI나 IDE 확장 프로그램에서 /skills를 실행하고 스킬을 선택하세요.
  • 언급해서 쓰기: 프롬프트에 $와 스킬 이름을 입력하세요. 예를 들어 $gh-fix-ci the build on this branch is red처럼 씁니다.
  • Codex가 고르게 하기: 평소처럼 작업을 설명하세요. 스킬의 description과 맞으면 Codex가 스스로 그 스킬을 불러옵니다.

ChatGPT 데스크톱 앱에서는 $ 대신 @를 입력하세요.

Codex 스킬 설치 방법

$skill-installer로 설치하기

$skill-installer는 Codex에 포함된 시스템 스킬입니다. 이름이나 GitHub 폴더 주소를 알려 주면 됩니다.

$skill-installer gh-address-comments
$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui

이름만 쓰면 OpenAI의 큐레이션 카탈로그에서 설치하고, URL을 쓰면 공개 저장소 어디에서든 설치합니다. 새 스킬이 보이지 않으면 Codex를 다시 시작하세요.

폴더를 복사해서 설치하기

스킬은 파일일 뿐이라서, 폴더를 ~/.agents/skills(모든 프로젝트) 또는 .agents/skills(한 프로젝트)에 복제하거나 복사해도 됩니다. 팀과 스킬을 공유하는 가장 쉬운 방법이기도 합니다. 저장소에 커밋해 두면 Codex로 그 프로젝트를 여는 사람은 누구나 스킬을 쓸 수 있습니다.

플러그인으로 설치하기

OpenAI는 openai/skills 저장소의 지원을 중단하고, 이제 자체 스킬을 openai/plugins 저장소의 플러그인에 담아 제공합니다. Figma, Notion, Linear, GitHub, Vercel, Build Web Apps, Product Design 등이 있습니다. Codex CLI에서 /plugins를 실행하면 둘러보고 설치할 수 있습니다. 플러그인을 설치하면 스킬과 그 스킬에 필요한 도구가 한 번에 설치됩니다.

나만의 스킬 만드는 방법

가장 빠른 방법은 Codex에 부탁하는 것입니다.

$skill-creator로 스킬 만들기
$skill-creator design-review라는 사용자 단위 스킬을 만들어 줘. 프로젝트의 DESIGN.md를 기준으로 UI 화면을 점검하는 스킬이야. 색상과 글꼴은 파일에 있는 것만 쓰고, 간격은 8px 그리드, 본문 글자는 16px 이상, 아이콘 대신 이모지를 쓰지 않는지 확인해 줘. 문제는 파일과 줄 번호를 붙인 목록으로 알려 주고, 그다음 직접 고쳐 줘.

직접 파일을 쓸 수도 있습니다. 경로는 ~/.agents/skills/design-review/SKILL.md입니다.

---
name: design-review
description: Review a UI screen against the project's DESIGN.md. Use when the user asks for a design review, says a screen looks off, or before finishing any UI change.
---

1. Read DESIGN.md. If there is none, say so and stop.
2. Check colors, fonts, spacing, and type sizes against it.
3. List each problem with the file and line, then fix it.

Codex가 쓰는 스킬과 무시하는 스킬은 세 가지에서 갈립니다.

  • 매칭을 염두에 두고 description을 쓰세요. 스킬이 무엇을 하는지, 언제 쓰는지를 사람들이 실제로 입력하는 표현으로 적으세요. “Use when the user asks for a design review”는 잘 통하지만 “Design helper”는 통하지 않습니다.
  • SKILL.md는 짧게 유지하세요. 긴 참고 자료는 references/ 폴더에 넣고, 언제 읽을지 스킬에 알려 주세요. Codex는 추가 파일을 필요할 때만 불러옵니다.
  • 정확해야 하는 단계는 스크립트로 처리하세요. 검사나 변환처럼 매번 똑같이 실행되어야 하는 일은 scripts/에 넣고 스킬이 그것을 실행하게 하세요.

Codex가 스킬을 알아서 쓰지는 못하게 하면서 $name 호출은 그대로 유지하려면, 스킬 폴더에 agents/openai.yaml을 추가하고 policy: { allow_implicit_invocation: false }를 넣으세요.

설치할 만한 Codex 스킬

스킬하는 일얻는 방법
skill-creator, skill-installer스킬을 만들고 설치합니다내장
imagegenCodex 안에서 프롬프트로 이미지를 생성합니다내장
gh-fix-ci실패한 GitHub Actions 로그를 읽고 빌드를 고칩니다$skill-installer gh-fix-ci
gh-address-comments열려 있는 풀 리퀘스트의 리뷰 댓글을 차례로 처리합니다$skill-installer gh-address-comments
playwright실제 브라우저를 띄워 Codex가 만든 결과를 테스트하고 스크린샷을 찍습니다$skill-installer playwright
security-best-practices흔한 보안 실수가 없는지 코드를 점검합니다$skill-installer security-best-practices
Figma 스킬Figma 프레임을 코드로, 코드를 Figma로 바꿉니다/plugins에서 Figma 플러그인
Taste SkillUI가 흔한 AI 느낌에서 벗어나게 이끕니다튜토리얼 참고
pretty-uiUI에서 AI 티가 나는 디자인을 찾아 고칩니다$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui

디자인 작업에 쓸 스킬은 UI 디자인에 좋은 Codex 스킬 추천과 Taste Skill vs Impeccable vs UI UX Pro Max에서 비교했습니다.

스킬 끄기, 그리고 스킬이 보이지 않을 때

스킬을 삭제하지 않고 끄려면 ~/.codex/config.toml에 아래 내용을 추가하고 Codex를 다시 시작하세요.

[[skills.config]]
path = "/Users/you/.agents/skills/design-review/SKILL.md"
enabled = false

path 대신 name = "design-review"를 쓰면 그 이름의 스킬을 모두 끕니다.

/skills에 스킬이 나타나지 않는다면 다음을 확인하세요.

  • Codex를 다시 시작하세요. 새 스킬은 세션을 시작할 때 로드됩니다.
  • 폴더를 확인하세요. 파일 이름은 SKILL.md여야 하고, 위에서 설명한 경로 중 한 곳에 있는 스킬 폴더 바로 안에 있어야 합니다.
  • frontmatter를 확인하세요. name과 description이 모두 필요합니다.
  • 스킬이 너무 많을 수 있습니다. 처음에 불러오는 스킬 목록에는 컨텍스트 창의 약 2%가 할당됩니다. 이를 넘으면 Codex는 description을 줄이고, 경고와 함께 일부 스킬을 빼기도 합니다. config.toml의 skills.max_context_tokens로 한도를 늘리거나, 쓰지 않는 스킬을 지우세요.

자주 묻는 질문

Claude Code 스킬을 Codex에서 쓸 수 있나요?

대개 가능합니다. 둘 다 SKILL.md 형식을 쓰기 때문입니다. ~/.claude/skills의 폴더를 ~/.agents/skills로 복사하세요. 둘 중 한쪽에만 있는 도구를 쓰라고 안내하는 스킬은 수정이 필요합니다.

스킬과 AGENTS.md는 어떻게 다른가요?

AGENTS.md는 해당 프로젝트의 모든 세션에서 로드되므로 항상 적용할 규칙에 알맞습니다. 스킬은 작업에 필요할 때만 로드되므로 가끔 쓰는 워크플로에 알맞고, 스크립트와 참고 파일도 담을 수 있습니다.

Codex 스킬은 어디서 더 찾을 수 있나요?

/plugins의 OpenAI 플러그인, 지원은 중단되었지만 여전히 열람할 수 있는 openai/skills 저장소, 그리고 제작자들이 GitHub에 공개한 스킬이 있습니다. 설치하기 전에 스킬의 파일, 특히 스크립트를 먼저 읽어 보세요. 스킬은 Codex와 같은 권한으로 실행됩니다.

더 읽어 보기

Codex용 독립 플러그인입니다. OpenAI와 제휴하거나 OpenAI의 보증을 받은 제품이 아닙니다.