Codex의 Skill Creator는 새 스킬에 필요한 질문을 하고 SKILL.md 초안을 만듭니다. SKILL.md에는 name과 description이 필요하며, description은 스킬의 역할과 호출 조건을 설명합니다. Anthropic의 Skill Creator도 새 스킬을 만들거나 기존 스킬을 개선하고 실제 요청으로 결과를 확인하는 절차를 제공합니다.
만드는 순서
스킬 이름과 맡을 일, 사용할 때와 사용하지 않을 때, 결과 형태를 정합니다.
SKILL.md 초안을 만듭니다.
실제 사용자가 말할 법한 요청 두세 개로 실행합니다.
결과를 보고 공통 문제를 고칩니다.
같은 요청을 다시 실행해 전후 결과를 비교합니다.
스킬은 한 번 만든 파일보다 반복해서 고친 작업 기준에 가깝습니다. 실제 결과의 아쉬운 점을 다음 버전에 반영합니다.
5분 실습 — 설치 전에 규칙 고치기
Claude Skill Library의 /grill-me는 비단순 제작 요청을 받으면 먼저 10~15개 질문을 요구합니다. 공개 압축 파일에는 2026년 9월 3일 확인 기준으로 SKILL.md 한 개가 들어 있습니다. 수업에서는 이 스킬을 설치하지 않고 규칙만 읽습니다.
/grill-me만 내려받아 압축을 풉니다. 이메일 입력을 요구하면 내려받지 않고 멈춥니다.
세 번 이상 반복한 작업 하나를 고르고, 스킬 이름·사용할 때·사용하지 않을 때·입력·결과·검수 기준을 적습니다.
Codex에서 `$skill-creator`를 부르고 초안을 요청합니다. Skill Creator가 묻는 질문에 답하면 필수 파일인 `SKILL.md`에 이름과 설명이 들어갑니다.
$skill-creator
매주 회의록을 결정사항·할 일·미결로 나누는 반복 작업을 스킬로 만들어 주세요. 할 일의 담당자는 추정하지 말고 비워 두며, 결과는 표로 만들어야 합니다. 이 스킬을 써야 하는 요청과 쓰지 않아야 하는 요청을 먼저 질문한 뒤 초안을 보여 주세요.
확인SKILL.md 초안에 name과 description이 있고, description에 사용할 때와 사용하지 않을 때가 구분됩니다.
이 단계의 실제 화면
화면에서 확인할 것반복 작업과 호출 조건을 설명한 뒤 Skill Creator에 스킬 초안을 요청합니다. Claude Code 2.1.135 · 2026-07-27
두 결과를 보고 공통으로 아쉬운 부분 한 가지를 구체적으로 피드백합니다.
수정한 스킬로 같은 요청을 다시 실행해 전후 결과를 비교합니다.
직접 해보기
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
내 상황에 맞춰
$skill-creator
내가 반복하는 [작업]을 스킬로 만들고 싶습니다. 스킬 이름, 사용할 때와 사용하지 않을 때, 입력 자료, 결과 형태, 완료 기준을 먼저 질문한 뒤 초안을 만들어 주세요.
한 단계 더
방금 만든 스킬을 내가 실제로 말할 법한 요청 두 개로 시험해 줘. 결과를 나란히 보여 주고, 반복해서 어긋나는 부분만 수정안으로 제안해 줘.
설치 전 검토
이 SKILL.md는 설치하거나 실행하지 말고 내용만 검토해 주세요.
1. 어떤 요청에서 자동으로 불리는지
2. 질문을 몇 개 요구하는지
3. 질문을 줄이거나 생략하는 조건이 있는지
4. 작은 문서나 프레젠테이션에도 이 규칙이 과한지
네 항목을 표로 정리하고, 작업의 복잡성·비용·보안·외부 공개 여부에 따라 질문 수가 달라지도록 description과 Core rule 수정안만 보여 주세요.
세 번 이상 반복한 작업 하나로 스킬을 만들고, 실제 요청 두 개의 결과를 비교해 한 번 수정해 보세요.
헷갈리기 쉬운 것
한 번만 쓸 작업을 모두 스킬로 만들면 관리할 파일만 늘어납니다. 예시 하나에만 맞춘 규칙도 다른 요청에서 깨지므로 서로 다른 실제 요청으로 시험합니다.
왜 이렇게 작동하나요
자주 쓰는 양식을 만들 때 제목과 작성 규칙뿐 아니라 언제 꺼내 쓰는지도 적는 것과 같습니다.
Codex는 SKILL.md의 name과 description을 보고 요청과 맞는 스킬을 찾습니다. 사용할 때와 사용하지 않을 때를 설명에 함께 적고 서로 다른 요청으로 시험해야 잘못 불리거나 빠지는 문제를 찾을 수 있습니다.
더 알고 싶다면
description에는 무엇을 적습니까?
스킬이 하는 일, 어떤 요청에서 써야 하는지, 어떤 비슷한 요청에서는 쓰지 않아야 하는지를 짧게 적습니다.
사용자가 실제로 말할 표현을 넣어야 Codex가 요청과 스킬을 연결하기 쉽습니다. 내부 제작 용어만 적으면 같은 뜻의 일상 표현을 놓칠 수 있습니다.
name과 description은 SKILL.md의 필수 항목이므로 초안을 만든 뒤 두 값이 실제 파일에 있는지 확인합니다.
스크립트를 반드시 함께 만들어야 합니까?
판단 순서와 출력 형식만 필요한 작업은 SKILL.md 설명만으로 시작할 수 있습니다.
같은 변환을 정확히 반복해야 하거나 파일 검사가 필요할 때만 스크립트를 추가합니다. 첫 초안부터 쓰지 않을 파일을 만들면 관리할 범위가 늘어납니다.
새 상황에 적용
호출 조건이 다른 요청 두 개로 시험하기
스킬을 사용해야 하는 실제 요청 하나와 비슷하지만 사용하지 않아야 하는 요청 하나를 실행합니다.
확인할 결과
첫 요청에서만 스킬이 사용되고, 두 요청의 결과가 설명에 적은 경계와 맞습니다.
막혔을 때 확인할 순서
두 요청에서 모두 불리거나 모두 빠지면 description의 사용 조건과 제외 조건을 실제 요청 표현으로 고칩니다.
