Codex Skills 첫 설정: 반복 작업을 매번 설명하지 않는 법 | DAKER 커뮤니티
매번 같은 체크리스트를 다시 쓰고 있다면, 그건 프롬프트 문제가 아니라 절차를 저장할 타이밍입니다.
Codex Skills는 반복되는 작업 절차를 이름, 설명, 지침, 필요한 자료로 묶어 두는 방식입니다. Codex는 처음부터 모든 긴 지침을 다 읽는 대신, 스킬 이름과 설명을 보고 필요할 때 전체 지침을 불러옵니다. 그래서 매번 긴 프롬프트를 복사하기보다, 작은 절차 하나를 스킬로 만들어 두는 편이 작업 품질을 일정하게 유지하기 쉽습니다.
무엇이 달라지나요?
비유하자면 스킬은 냉장고에 붙인 요리 순서표입니다. 재료는 매번 달라도, 손 씻기부터 불 끄기까지 빠뜨리면 안 되는 순서는 종이에 남겨 둡니다.
언제 쓰면 좋나요?
특히 코드 리뷰 전 점검, 릴리스 노트 작성, 테스트 재현, 데이터 정리처럼 순서가 반복되고 결과물 기준이 분명한 작업에 잘 맞습니다. 반대로 한 번만 할 실험이나 아직 기준이 흔들리는 기획은 스킬보다 일반 프롬프트로 먼저 다듬는 편이 낫습니다.
바로 따라 할 3단계
처음부터 거창한 자동화를 만들 필요는 없습니다. 오늘 반복한 작업 하나만 아래 순서로 작게 고정해 보세요.
- 자주 반복한 작업 하나를 고르고, 성공 결과물을 한 문장으로 적습니다.
- 그 작업에서 매번 확인해야 하는 입력, 금지 행동, 검증 명령을 세 줄로 분리합니다.
- 스킬 설명은 짧게 쓰고, 자세한 절차는 스킬 지침 파일 안에서 단계별로 정리합니다.
예시로 보는 선택 기준
| 반복 신호 | 스킬 후보 | 완료 증거 |
|---|---|---|
| 같은 요청을 세 번 이상 복사했다 | 요청 템플릿을 절차로 분리 | 결과물과 검증 로그 |
| 리뷰 때 같은 누락이 반복된다 | 체크리스트 스킬로 고정 | 수정 전후 diff와 테스트 |
| 새 팀원이 순서를 자주 묻는다 | 온보딩 절차를 스킬로 작성 | 따라 한 파일과 실행 결과 |
흐름으로 기억하기
실수 방지 체크
스킬은 길게 쓰는 순간 다시 읽기 어려운 문서가 됩니다. 아래 세 가지만 먼저 지켜도 실패율이 꽤 줄어듭니다.
- 스킬 설명만 읽어도 언제 써야 하는지 바로 보이나요?
- 절차가 너무 커져서 코드 리뷰, 테스트, 문서 작성이 한 스킬 안에 섞이지 않았나요?
- 완료 전에 확인할 테스트, 링크 검사, 화면 확인 같은 증거가 적혀 있나요?
확인한 기준
작성 기준일 현재 기능 사실은 OpenAI 공식 Codex 문서 4개 항목으로 비공개 확인했습니다. 공개 링크는 DAKER 정책에 맞춰 아래 내부 링크만 남깁니다.
FAQ
스킬은 AGENTS 지침과 무엇이 다른가요?
AGENTS 지침은 저장소 전체에 늘 적용되는 기본 규칙에 가깝고, 스킬은 특정 작업을 할 때 꺼내 쓰는 절차서에 가깝습니다.
스킬 하나에 많은 일을 넣어도 되나요?
가능은 하지만 권하지 않습니다. 스킬은 작을수록 언제 호출할지 판단하기 쉽고, 실패했을 때 고칠 지점도 빨리 보입니다.
오늘 바로 만들 첫 스킬은 무엇이 좋나요?
가장 최근에 두 번 이상 반복한 작업을 고르세요. 예를 들어 PR 리뷰 전 점검, 배포 전 확인, 데이터 정리 순서처럼 결과가 눈에 보이는 작업이 좋습니다.
오늘은 최근 작업 기록을 보고 같은 요청을 두 번 이상 반복한 일을 하나만 고르세요. 그 작업의 성공 결과, 금지 행동, 검증 증거를 세 줄로 쓰면 첫 스킬 후보가 됩니다.