skill-creator란? Codex에서 나만의 AI 스킬 만드는 방법
Codex에 같은 일을 반복해서 맡기다 보면 이런 생각이 들 수 있습니다. “블로그 글을 게시하기 전에 목차, 링크, 모바일 화면을 확인하라고 매번 설명하지 않고, 나만의 점검 방법을 저장할 수는 없을까?” 그런 작업 절차를 만드는 데 도움을 주는 도구가 skill-creator(스킬 크리에이터)입니다. skill-creator는 Codex에서 새 스킬을 만들거나 기존 스킬을 고칠 때, 필요한 지침과 파일을 구성하도록 도와주는 스킬입니다. 쉽게 말해 직접 업무 매뉴얼의 틀을 짜는 일을 도와주는 ‘매뉴얼 제작 도우미’입니다. 여기서 중요한 차이가 하나 있습니다. skill-creator는 스킬을 만드는 도구이지, 완성된 스킬이 모든 일을 실제로 성공하게 만드는 버튼이 아닙니다. 이번 글에서는 블로그 발행 점검이라는 예시로 제작 요청부터 결과 확인까지 알아보겠습니다.
이 글의 순서
1. skill-creator는 어떤 일을 해줄까요?
요리책을 직접 만든다고 상상해 보세요. 재료 목록, 조리 순서, 주의 사항, 완성 기준이 있어야 다른 사람도 같은 요리를 따라 할 수 있겠죠. Codex에서 사용하는 스킬도 비슷합니다. 특정 종류의 일을 언제 시작하고, 어떤 순서로 처리하며, 무엇을 완료라고 판단할지 정하는 안내서입니다. skill-creator는 이런 내용을 질문과 예시를 바탕으로 정리하고, 환경에서 지원한다면 필요한 스킬 파일을 만들어 주는 역할을 합니다. 예를 들어 다음과 같은 반복 업무에 활용할 수 있습니다.
- 블로그 글을 공개하기 전에 링크와 제목 구조를 검사하기
- 코드가 바뀌었을 때 변경 파일과 테스트 결과를 같은 양식으로 보고하기
- 연구 자료를 정해진 항목에 따라 읽고 요약하기 하지만 “이름만 입력하면 완벽한 전문가 도구가 자동 완성된다”는 식으로 생각하면 곤란합니다. 무엇을 검사할지 정하고, 생성된 내용을 검토하며, 가능한 환경에서 실제로 시험하는 과정이 필요합니다.
2. 일반 스킬과 skill-creator는 무엇이 다를까요?
둘의 역할은 간단히 구분할 수 있습니다.
| 구분 | 역할 | 예시 |
|---|---|---|
| skill-creator | 스킬을 설계하고 만드는 일을 돕기 | ‘블로그 검수 스킬을 만들어 줘’ |
| 직접 만든 스킬 | 정해진 절차에 따라 업무를 진행하기 | ‘블로그 검수 스킬로 이 글을 확인해 줘’ |
| 일반 프롬프트 | 지금의 한 가지 요청 전달하기 | ‘이 글의 링크 두 개만 확인해 줘’ |
즉, skill-creator로 스킬을 만든 다음, 이후 작업에서 그 스킬을 사용하는 방식입니다. 한 번만 필요한 질문이라면 복잡하게 스킬을 제작할 이유가 없습니다. 같은 작업을 여러 번 맡기고 결과 형식까지 일관되게 관리하고 싶을 때 가치가 커집니다.
3. Codex에서 skill-creator를 어떻게 부를까요?
OpenAI의 공식 개발 문서에서 Codex의 skill-creator 호출 예시는 다음과 같습니다.
$skill-creator
이 문구는 Codex 대화창에 입력하는 스킬 호출 형식입니다. macOS 터미널이나 Windows 명령 프롬프트에서 그대로 실행하는 일반 셸 명령이라고 생각하면 안 됩니다. 사용할 수 있는 환경이라면 다음과 같이 요청을 이어갈 수 있습니다.
$skill-creator 를 사용해서
블로그 글 발행 전 점검 스킬을 설계해 줘.
어떤 파일을 만들지 먼저 설명하고,
내 승인 없이 기존 파일을 덮어쓰거나
GitHub에 푸시하거나 Blogger에 게시하지 마.
입력해도 스킬을 찾지 못한다면? 먼저 현재 사용하는 Codex 앱·CLI·작업 공간에 skill-creator가 제공되고 인식되는지 확인하세요. 지원되는 기능과 표시 방법은 제품 환경·버전에 따라 달라질 수 있습니다. 없는데도 무조건 실행됐다고 가정할 수는 없습니다.
참고로 OpenAI는 ChatGPT의 스킬 생성 예시에서 @skill-creator 표기도 안내합니다. Codex의 $skill-creator와 제품별 호출 화면을 혼동하지 마세요.
4. 실전 예시: 블로그 발행 점검 스킬 만들기
이번에는 실제 계정을 건드리지 않는 교육용 가상 블로그를 생각해 보겠습니다.
원하는 스킬 이름은 blog-release-review입니다. 발행 버튼을 대신 누르는 기능이 아니라, 공개 전 점검 항목을 일관되게 확인하도록 돕는 스킬이 목표입니다.
Codex에 다음 요청을 복사해 볼 수 있습니다.
$skill-creator
반복적으로 사용하는 'blog-release-review' 스킬을
만들 수 있도록 도와줘.
목적:
블로그 글의 공개 직전 품질 문제를 점검하고
실제로 확인한 결과만 보고한다.
사용 상황:
새 글을 게시하기 전,
또는 기존 글의 본문을 크게 수정한 직후.
확인 순서:
1. 제목과 본문이 일치하는지 확인한다.
2. 목차의 링크가 본문 소제목에 연결되는지 확인한다.
3. 이미지 크기와 ALT 설명을 확인한다.
4. 내부 링크가 실제 공개 페이지로 연결되는지 확인한다.
5. 모바일 320px과 390px 화면의 넘침을 확인한다.
6. 비밀번호·API 키·개인정보 노출 위험을 찾는다.
완료 보고:
확인 항목 / 발견한 문제 / 실제 실행한 검사 /
검사하지 못한 항목 / 공개 전 남은 작업.
제한:
- Blogger 게시, GitHub 푸시, 외부 계정 변경 금지.
- 테스트 환경이 없으면 '미실행'으로 기록.
- 기존 스킬이 있으면 덮어쓰지 말고 먼저 알려주기.
- 만들 파일과 적용 범위를 먼저 보여주기.
이 예시의 핵심은 기능을 많이 적는 것보다 실행 조건과 완료 기준을 분명하게 적었다는 점입니다. 예를 들어 화면 크기를 확인하라는 항목은 실제 브라우저를 이용할 수 있을 때 검증할 수 있습니다. 브라우저를 사용할 수 없다면, 스킬이 존재해도 320px 화면을 직접 검사했다는 결과를 내서는 안 됩니다.
5. 만들기 전에 무엇을 먼저 정해야 할까요?
스킬 제작 요청에는 네 가지를 포함하면 좋습니다. 첫째, 목표입니다. ‘무슨 종류의 일을 반복해서 처리하려는가?’가 분명해야 합니다. ‘AI를 더 똑똑하게 해 줘’처럼 막연한 목표는 검증하기 어렵습니다. 둘째, 사용 조건입니다. 어떤 요청이 들어왔을 때 이 스킬이 필요한지 예문을 제시해 보세요. 예를 들어 ‘게시 전 검수 요청’, ‘기존 글의 대규모 수정 검토’처럼요. 셋째, 실제 입력 자료입니다. 원고, HTML, 이미지, 브라우저 접근 등 어떤 자료가 있어야 검사가 가능한지 정해야 합니다. 파일을 제공하지 않았다면 검사 가능한 범위도 제한됩니다. 넷째, 완료 기준과 금지 작업입니다. 어떤 형식으로 결과를 보고해야 하는지, 파일 수정이나 공개 게시처럼 별도 허락을 받아야 하는 작업이 무엇인지 명시하세요. 이 네 가지가 불분명하면 생성된 스킬이 너무 광범위해지거나, 사용자의 의도와 다른 일을 하도록 작성될 수 있습니다.
6. skill-creator가 만든 결과물은 무엇인가요?
환경과 요청에 따라 달라질 수 있지만, 가장 중요한 결과물은 이름이 붙은 폴더 안의 SKILL.md 파일입니다.
예를 들면 다음과 같은 구조입니다.
blog-release-review/
├── SKILL.md
├── agents/
│ └── openai.yaml
└── references/
└── review-checklist.md
SKILL.md는 스킬 이름·사용 조건·실행 절차를 담는 핵심 파일입니다.agents/openai.yaml은 지원하는 환경에서 표시명 등 인터페이스 정보를 제공할 수 있습니다.references/는 자세한 점검 기준이 많을 때 사용하는 선택 자료입니다. 간단한 스킬은SKILL.md하나로 충분할 수도 있습니다. 불필요한 폴더와 설명서를 모두 만들 필요는 없습니다. 이 글은 파일 구조 자체를 외우는 법보다 skill-creator로 유용한 초안을 얻고 확인하는 과정에 초점을 둡니다. 파일 문법과 자세한 작성 규칙은 별도SKILL.md설명글에서 다루는 것이 적합합니다.
7. 생성됐다고 끝난 것이 아닌 이유
처음 만드는 분들이 가장 많이 혼동하는 부분입니다.
파일 생성 완료, Codex에서 스킬 인식, 스킬 선택, 검사 실행, 검사 결과 정확성은 서로 다른 단계입니다.
예를 들어 blog-release-review 파일이 만들어졌더라도 스킬의 설명이 ‘컴퓨터 관련 모든 일을 한다’처럼 모호하면 Codex가 적절한 순간에 선택하기 어려울 수 있습니다.
또 스킬을 인식했더라도 글의 HTML을 읽을 수 없거나 브라우저에 접근할 수 없다면 실제 모바일 화면 검사는 진행되지 않을 수 있습니다.
따라서 처음에는 실제 게시를 하지 않는 작은 검사 요청으로 결과를 확인하세요.
지금 blog-release-review 스킬을 사용할 수 있는지 확인해 줘.
가능하다면 이 테스트 원고의 제목과 목차 구조만 검토해.
파일을 수정하거나 공개 게시하지 말고,
어떤 자료를 읽었는지와 실제 검사한 항목을 구분해서 보고해.
출력된 내용이 형식에 맞고, 확인한 자료와 테스트 결과가 일치하는지 사람이 다시 살펴봐야 합니다.
8. 마음에 들지 않는 결과는 어떻게 수정하나요?
처음부터 완벽하게 쓰려고 하기보다 작은 업무로 시험하고 부족한 부분만 수정하는 편이 효율적입니다. 예를 들어 첫 시도에서 ‘문제가 없습니다’라고만 보고했다면 이렇게 요청할 수 있습니다.
blog-release-review 스킬을 보완해 줘.
검사 결과에 다음 세 가지를 반드시 나눠 적어:
1. 실제 파일·화면을 보고 확인한 사실
2. 코드나 원고만 읽고 예상한 위험
3. 도구가 없어 미실행한 검사
기존 규칙과 무관한 내용은 바꾸지 말고
수정할 파일과 변경점을 먼저 보여 줘.
공식 skill-creator 자료는 기본 파일 형식 검사와 실제 작업을 이용한 반복 개선을 구분합니다. 예를 들어 지원되는 생성기에는 quick_validate.py 같은 검사 도구가 포함될 수 있지만, 그 검사가 통과했다는 사실만으로 블로그 모바일 QA까지 성공했다고 말할 수는 없습니다.
9. 스킬을 만들 때 주의할 보안 문제
스킬 생성도 결국 새로운 지침과 파일을 만드는 일입니다. 특히 다른 사람이 배포한 스킬이나 보조 스크립트를 사용할 때는 주의가 필요합니다.
- 비밀번호·API 키·고객 정보 등을 생성 요청문이나 스킬 파일에 넣지 마세요.
- 제작된 스크립트가 어떤 파일을 읽고 수정하는지 확인하세요.
- 외부 주소로 데이터를 전송하거나 패키지를 설치하는 동작은 실행 전 검토하세요.
- ‘사용자 승인 없이 게시 금지’ 같은 문장은 좋은 지침이지만, 실제 앱 권한을 자동으로 제한하는 보안 기능은 아닙니다.
- 읽기 검사와 파일 수정, 원격 푸시, 공개 게시를 별도 단계로 나누세요. 좋은 스킬은 사용자를 대신해 마음대로 행동하는 스킬이 아니라, 필요한 일을 분명한 범위에서 재현 가능하게 도와주는 스킬입니다.
10. 자주 묻는 질문
Q1. skill-creator를 쓰려면 코딩을 잘해야 하나요?
간단한 지침형 스킬이라면 자연어로 업무 절차를 설명하면서 시작할 수 있습니다. 다만 실제 스크립트 작성이나 프로그램 연동이 필요하면 해당 파일을 검토하고 실행 결과를 확인할 기술적 이해가 도움이 됩니다.
Q2. skill-creator는 무료인가요?
사용 가능 여부와 한도는 사용 중인 Codex 제품·계정·플랜·기능 정책에 따라 달라질 수 있습니다. 여기서는 모든 환경에서 무료라고 단정하지 않습니다.
Q3. 스킬 이름만 알려 주면 모든 것이 자동으로 되나요?
아닙니다. 목표, 입력 자료, 완료 기준, 제한 사항이 구체적일수록 쓸모 있는 초안을 만들기 쉽습니다. 생성 이후에도 검토와 사용 시험이 필요합니다.
Q4. skill-creator와 SKILL.md는 같은 건가요?
아닙니다. skill-creator는 스킬 제작을 돕는 기능이고, SKILL.md는 만들어진 스킬의 중요한 지침 파일입니다.
Q5. 기존 스킬도 고칠 수 있나요?
공식 skill-creator는 새 스킬 생성뿐 아니라 기존 스킬 개선을 지원하는 용도로 안내됩니다. 다만 기존 파일의 내용과 변경 범위를 확인한 후 수정해야 합니다.
Q6. 스킬을 만들면 매번 자동으로 실행되나요?
보장되지 않습니다. 요청이 스킬의 이름·설명과 맞는지, 현재 환경에서 인식되는지에 따라 선택이 달라질 수 있습니다. 꼭 써야 할 때는 해당 스킬을 명시하고 실제 사용 여부를 확인하세요.
Q7. 만든 스킬로 블로그 글을 자동 게시해도 되나요?
스킬만으로 Blogger에 게시할 수 있는 권한이 자동 생성되는 것은 아닙니다. 실제 게시 기능·계정 접근·사용자 승인과 발행 전 검수는 별개로 필요합니다.
마무리: 가장 작은 반복 업무부터 만들어 보세요
skill-creator의 가치는 ‘스킬 파일을 많이 만드는 것’이 아니라 반복해서 맡기는 작업의 기준을 명확하고 검증 가능하게 만드는 것에 있습니다. 처음에는 홈페이지나 블로그를 자동으로 수정·배포하는 거대한 스킬보다, 글 하나의 제목·목차를 검사하고 결과를 보고하는 작은 스킬부터 시작해 보세요. 해당 작업이 실제로 잘 수행되는지 확인한 뒤 링크·이미지·모바일 점검 등 범위를 차근차근 넓히면 됩니다. 무엇보다 스킬을 만들었다는 사실과 검증을 완료했다는 사실을 구분하는 것이 중요합니다.