Codex 플러그인과 스킬의 차이.
스킬은 Codex에 한 가지 종류의 작업 방법을 가르칩니다. 플러그인은 설치하는 패키지로, 여러 스킬과 그 스킬에 필요한 도구를 함께 담을 수 있습니다. 둘이 어떻게 맞물리는지, 언제 무엇을 써야 하는지 정리했습니다.
2026년 11월 1일 업데이트 · 6분 분량
짧게 답하자면
| 스킬 | 플러그인 | |
|---|---|---|
| 정체 | 지침을 담은 폴더(스크립트와 참고 파일은 선택) | 설치 가능한 기능 묶음 |
| 구성 | SKILL.md 파일과 선택적인 스크립트, 에셋 | 스킬, MCP 서버, 브라우저 확장 프로그램, 훅 |
| 새 도구 추가? | 아니요. Codex가 이미 가진 도구를 쓰도록 안내합니다 | 네. 함께 포함된 MCP 서버를 통해 추가합니다 |
| 얻는 방법 | 폴더를 복사하거나 $skill-installer 사용 | 플러그인 디렉터리나 마켓플레이스에서 설치 |
| 추천 용도 | 한 저장소나 내 컴퓨터에서 쓰는 나만의 워크플로 | 완성된 워크플로를 다른 사람과 공유 |
Codex 스킬이란?
스킬은 SKILL.md 파일이 들어 있는 디렉터리입니다. 파일은 name과 description으로 시작하고, 그 뒤에 일반 Markdown으로 쓴 지침이 이어집니다. 폴더에는 scripts/, references/, assets/도 넣을 수 있습니다.
---
name: brand-ui-review
description: Review UI mockups against our brand guidelines. Use when the user asks for a design review.
---
Check every screen for:
- Colors from the brand palette only
- Inter for UI text, 16px minimum for body copy
- 8px spacing grid
Codex는 처음에 각 스킬의 name과 description만 읽습니다. 작업이 description과 맞거나 스킬을 이름으로 언급하면 그때 전체 지침을 불러옵니다. 덕분에 컨텍스트 창을 채우지 않고도 많은 스킬을 쓸 수 있습니다.
스킬이 있는 위치
- 저장소:
.agents/skills. Codex는 작업 중인 디렉터리부터 저장소 루트까지 모든 디렉터리를 확인합니다. - 사용자:
~/.agents/skills - 조직:
/etc/codex/skills. 관리자가 관리합니다. - 내장: Codex와 함께 제공되는 시스템 스킬.
스킬 사용 방법
Codex CLI나 IDE 확장 프로그램에서 /skills를 실행하거나 $를 입력해 스킬을 직접 언급하세요. 요청이 스킬의 description과 맞으면 Codex가 스스로 스킬을 고를 수도 있습니다. 스킬을 만들려면 내장된 $skill-creator에 요청하세요. 카탈로그나 저장소에서 스킬을 설치하려면 $skill-installer를 쓰세요. 새 스킬이 보이지 않으면 Codex를 다시 시작하세요.
Codex 플러그인이란?
플러그인은 여러 기능을 묶어 한 번에 설치할 수 있게 한 것입니다. OpenAI 문서에 따르면 플러그인에는 다음이 포함될 수 있습니다.
- 스킬: 위에서 설명한 재사용 가능한 지침.
- MCP 서버: GitHub, Slack, 로컬 앱 접근 같은 새 도구를 Codex에 제공합니다.
- 브라우저 확장 프로그램: 브라우저 기능이 필요한 워크플로용.
- 훅: Codex 런타임의 정해진 시점에 실행되는 명령어. 신뢰하기 전에 내용을 검토하세요.
플러그인은 ChatGPT와 Codex가 함께 쓰는 플러그인 디렉터리나 Git 저장소 같은 마켓플레이스에서 설치합니다. Codex CLI에서는 /plugins를 실행해 둘러볼 수 있습니다. 플러그인은 Codex CLI와 ChatGPT 데스크톱 앱 안의 Codex에서 작동하며, IDE 확장 프로그램은 지원하지 않습니다. 설치 후 새 세션을 시작해야 새 스킬과 도구가 로드됩니다.
예시: Codex Design의 구성
Codex Design은 플러그인이며, 두 가지가 모두 필요합니다.
- MCP 서버가 캔버스 도구를 추가합니다. 캔버스를 만들고, 열고, 이미지와 HTML 노드를 추가하거나 옮기는 도구입니다. 이 도구가 없으면 Codex가 작업할 캔버스가 없습니다.
- 스킬이 그 도구를 잘 쓰는 방법을 설명합니다. 화면을 추가하기 전에 캔버스를 열고, HTML 파일은 각각 단독으로 실행되게 만들고, 화면 크기는 기기에 맞추라는 식입니다.
스킬만으로는 캔버스를 설명할 수는 있어도 만들 수는 없습니다. MCP 서버만 있으면 노하우 없이 도구만 제공됩니다. 플러그인은 설치 명령어 하나로 둘 다 전달합니다. Codex Design 설치 방법을 확인하세요.
무엇을 써야 할까?
이럴 때는 스킬을 만드세요
- 파일 읽기, 명령어 실행처럼 Codex가 이미 가진 도구만으로 되는 워크플로일 때.
- 팀의 디자인 리뷰 체크리스트처럼 한 프로젝트에만 해당할 때.
- 빠르게 반복하고 싶을 때. Markdown 파일 하나만 고치면 됩니다.
이럴 때는 플러그인을 만들거나 설치하세요
- Codex에 새 도구나 다른 서비스 접근 권한이 필요할 때.
- 함께 쓰는 여러 스킬을 하나로 묶고 싶을 때.
- 다른 사람이 워크플로 전체를 한 번에 설치할 수 있어야 할 때.
자주 묻는 질문
플러그인 하나에 스킬을 여러 개 넣을 수 있나요?
네. 플러그인에는 MCP 서버 등 다른 구성 요소와 함께 여러 스킬을 묶을 수 있습니다.
Codex 스킬은 Agent Skills와 같은 건가요?
Codex 스킬은 공개 표준인 Agent Skills 형식을 기반으로 합니다. 같은 SKILL.md 형식을 쓰는 다른 에이전트용 스킬은 대개 .agents/skills에 복사해 Codex에서 쓸 수 있습니다.
스킬을 삭제하지 않고 끄려면 어떻게 하나요?
~/.codex/config.toml에 스킬 경로와 enabled = false를 넣은 [[skills.config]] 항목을 추가한 다음 Codex를 다시 시작하세요.