본문으로 건너뛰기

반복 작업을 이름 하나로 부르는 스킬로 만들기 (Codex 스킬)

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

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

내 내용 넣기

2칸 · 필수 2칸
내 내용 넣기

준비

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

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

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

AI에게 보내기
$skill-creator [반복할 작업]

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

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

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

터미널에 붙여 넣기
---
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를 다시 시작합니다.

터미널에 붙여 넣기
/skills

5. 이름으로 불러 실행

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

AI에게 보내기
$[스킬 이름]

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

주의

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

업무 분야 · 필요한 기능

이 기능을 가진 도구