# 반복 작업을 이름 하나로 부르는 스킬로 만들기 (Codex 스킬)
id: codex-skills · 종류: 워크플로 · 상태: 검수 대기 (사람 확인 전) · 주제: 개발
주소: https://opencurrent.ai/w/codex-skills
기준일: 2026-11-15 (여기서 고친 날)
도구: Codex CLI
평가 점수: 32/100 (확인 없음 · 검수 대기)

자주 하는 작업의 순서를 매번 설명하지 않아도, $이름 한 번으로 같은 절차를 그대로 실행합니다.

설명: 만들기 도우미로 초안을 만들거나 SKILL.md를 직접 써서 스킬 폴더에 둡니다. 목록에 보이는지 확인한 뒤 $이름으로 불러 실행합니다.

준비물: Codex CLI 또는 IDE 확장 · 스킬로 만들 반복 작업 하나

입력값 (프롬프트의 {{이름}}에 넣는다):
- {{task}} 반복 작업 (필수) 예: PR을 올리기 전 변경 내역으로 릴리스 노트 초안 작성
- {{skill_name}} 스킬 이름 (필수) 예: release-notes

본문:

## 준비

- Codex CLI 또는 IDE 확장
- 스킬로 만들 반복 작업 하나

### 1. 만들기 도우미로 초안 생성

Codex에서 내장 `$skill-creator`를 부르고 작업을 설명합니다. 도우미가 하는 일, 실행 시점, 스크립트 필요 여부를 묻습니다. 기본은 지시문만 있는 스킬입니다.

```prompt
$skill-creator [반복할 작업]
```

폴더에 `SKILL.md`가 생기면 초안이 만들어진 것입니다.

### 2. 직접 만들 때는 SKILL.md 작성

도우미 없이 만들려면 저장소의 `.agents/skills/<skill-name>/SKILL.md`를 씁니다. 머리말에 name과 description은 꼭 있어야 합니다. 설명 앞부분에 주 용도와 부를 낱말, 쓰지 말아야 할 경우를 함께 적습니다.

```bash
---
name: <skill-name>
description: Explain exactly when this skill should and should not trigger.
---

Skill instructions for ChatGPT or Codex to follow.
```

### 3. 둘 위치 정하기

저장소 전체용은 `$REPO_ROOT/.agents/skills`, 한 하위 폴더용은 그 폴더의 `.agents/skills`, 모든 저장소 공통은 `$HOME/.agents/skills`에 둡니다.

### 4. 목록에서 확인

Codex에서 `/skills`를 실행합니다. 변경은 자동으로 감지되고, 목록에 새 스킬이 안 보이면 Codex를 다시 시작합니다.

```bash
/skills
```

### 5. 이름으로 불러 실행

프롬프트에 `$`와 스킬 이름을 넣어 직접 부릅니다. 설명과 맞는 작업을 말하면 Codex가 스스로 고르기도 합니다.

```prompt
$[스킬 이름]
```

결과가 스킬에 적은 순서와 형식을 따르면 됩니다.

## 주의

- 스킬이 많으면 처음 목록의 설명이 줄거나 일부 스킬이 빠질 수 있고, 이때 경고가 나옵니다. 주 용도와 부를 낱말은 설명 앞쪽에 둡니다.
- 같은 name의 스킬 둘은 합쳐지지 않고, 둘 다 선택 목록에 보일 수 있습니다.
- 스킬 하나에는 일 하나만 맡깁니다. 스크립트는 정해진 결과나 외부 도구가 필요할 때만 넣습니다.
- 지우지 않고 끄려면 `~/.codex/config.toml`의 `[[skills.config]]`에 path와 `enabled = false`를 적고 Codex를 다시 시작합니다.
- `agents/openai.yaml`에서 `policy.allow_implicit_invocation = false`이면 자동 선택이 꺼지고 `$이름` 호출만 동작합니다.

주의:
- 스킬이 많으면 처음 목록의 설명이 줄거나 일부 스킬이 빠질 수 있음(경고 표시). 주 용도와 부를 낱말은 설명 앞쪽에
- 같은 name의 스킬 둘은 합쳐지지 않고 둘 다 선택 목록에 보일 수 있음
- 스킬 하나에 일 하나. 정해진 결과나 외부 도구가 필요할 때만 스크립트
- 지우지 않고 끄려면 ~/.codex/config.toml의 [[skills.config]]에 path와 enabled = false, 바꾼 뒤 Codex 다시 시작
- agents/openai.yaml에서 policy.allow_implicit_invocation = false면 자동 선택은 꺼지고 $이름 호출만 동작

출처:
- Build Skills https://learn.chatgpt.com/docs/build-skills.md