스킬 완성까지의 전체 체크리스트
새로운 스킬을 만들 때마다, 이 체크리스트를 따라가보세요. 빠뜨리는 것 없이 완성도 높은 스킬을 만들 수 있어요.
팁: 이 페이지를 인쇄(Ctrl+P)해서 책상에 붙여두면, 스킬 만들 때마다 하나씩 체크할 수 있어요!
1단계: 기본 구조 만들기
-
☐
폴더 생성 — kebab-case 이름 사용 (예:
my-review-skill) - ☐ SKILL.md 파일 생성 — 스킬의 핵심 파일
- ☐ references/ 폴더 필요 여부 판단 — 추가 참조 문서가 필요한가?
2단계: 프론트매터 작성
- ☐ name 작성 — 스킬의 이름 (kebab-case)
- ☐ description 작성 — 스킬이 뭘 하는지 명확하게
- ☐ description이 충분히 구체적인가? — Claude가 다른 스킬과 구분할 수 있을 만큼?
- ☐ allowed-tools 작성 — 필요한 도구만 최소한으로 나열
- ☐ allowed-tools가 최소 권한인가? — 불필요한 도구가 포함되지 않았는지 확인
3단계: 스킬 본문 작성
- ☐ 역할 정의 — AI가 어떤 역할을 맡는지 명확하게
- ☐ 지시사항이 명확한가? — 모호한 표현 없이, 구체적으로
- ☐ 단계별 프로세스 정의 — 어떤 순서로 작업하는지 명시
- ☐ 출력 형식 지정 — 결과물의 형태를 명확하게 (마크다운? 코드? 표?)
- ☐ 예시 포함 — 좋은 결과물의 예시가 있으면 품질이 올라감
- ☐ "하지 말아야 할 것" 명시 — AI가 피해야 할 행동 정의
4단계: References (필요한 경우)
- ☐ references/ 폴더에 파일 추가 — 체크리스트, 가이드, 템플릿 등
- ☐ 참조 파일이 자기 완결적인가? — 외부 의존성 없이 이해 가능한지
- ☐ SKILL.md에서 참조 파일을 언급 — AI가 참조하도록 안내
5단계: 테스트
- ☐ 설치 확인 — 스킬이 정상적으로 인식되는지
- ☐ 해피 패스 테스트 — 가장 기본적인 사용 시나리오가 잘 작동하는지
- ☐ 엣지 케이스 테스트 — 예외 상황에서도 적절하게 동작하는지
- ☐ 프레시 아이즈 테스트 — 다른 사람에게 테스트 요청 (초보자가 이상적)
- ☐ 3-5회 반복 테스트 — 결과가 일관적인지 확인
6단계: 공유 준비
- ☐ 개인 정보 제거 — API 키, 비밀번호, 내부 URL 등이 없는지 확인
-
☐
하드코딩된 경로 제거 —
/Users/내이름/...같은 개인 경로 없는지 확인 - ☐ README.md 작성 — 스킬 설명, 설치 방법, 사용 예시 포함
- ☐ GitHub 저장소 생성 및 업로드
- ☐ 저장소를 Public으로 설정 — 다른 사람이 볼 수 있게
빠른 참조: 프론트매터 템플릿
---
name: my-skill-name
description: |
이 스킬이 무엇을 하는지 구체적으로 적어주세요.
Claude가 이 설명을 보고 스킬을 활성화할지 판단합니다.
allowed-tools:
- Read
- Edit
- Bash
---
# 역할
당신은 [역할]입니다.
# 프로세스
1. [첫 번째 단계]
2. [두 번째 단계]
3. [세 번째 단계]
# 출력 형식
[결과물의 형태를 명시]
# 주의사항
- [하지 말아야 할 것]
- [주의할 점]