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