첫 번째 스킬: "인사하기"

지금부터 여러분은 만드는 사람(Maker)입니다

여기까지 오신 분들, 진심으로 축하드려요.

1부에서 AI가 뭔지 배웠고, 2부에서 스킬 패키지의 구조를 해부했죠. 재미있었지만, 솔직히 말하면 지금까지는 "구경"이었어요. 다른 사람이 만든 걸 들여다본 거예요.

이제 달라집니다.

긴장되시나요? 괜찮아요. 프로그래밍의 오랜 전통이 하나 있거든요.

모든 것은 "Hello, World!"에서 시작한다는 것.

1972년, 프로그래밍 언어 C를 만든 브라이언 커니핸이 교재에 "Hello, World!"를 화면에 출력하는 예제를 처음 넣었어요. 그 이후 50년 동안, 새로운 기술을 배울 때는 항상 가장 간단한 것부터 만들어보는 게 전통이 됐죠.

우리도 그 전통을 따릅니다. 가장 간단하고, 가장 쉽고, 가장 빨리 결과를 볼 수 있는 스킬부터 만들어볼 거예요.

이름하여: "인사하기" 스킬.

뭘 만들 거예요?

우리가 만들 스킬은 이거예요:

단순하죠? 바로 그게 포인트예요.

첫 번째 스킬은 단순해야 해요. 복잡하면 중간에 막히고, 막히면 재미없고, 재미없으면 포기하니까. 일단 성공의 맛을 봐야 다음으로 갈 수 있어요.

자, 시작합시다. 딱 3단계면 됩니다.

Step 1: 폴더 만들기

모든 스킬은 폴더 하나에서 시작해요. 스킬의 집을 짓는 거라고 생각하면 돼요.

터미널(명령어 창)을 열고, 다음 명령어를 입력하세요:

mkdir hello-skill
cd hello-skill

끝이에요. 정말로요. 폴더 하나 만들고 들어간 게 전부예요.

"이게 다예요?" 네, 이게 다예요. 스킬 패키지는 기본적으로 폴더 안에 파일을 넣는 것이거든요. 대단한 설치 과정이나 복잡한 설정 같은 거 없어요.

지금 우리 폴더 구조는 이렇게 생겼어요:

hello-skill/
  (아직 비어 있음)

텅 빈 집이죠. 이제 여기에 가장 중요한 파일을 넣을 거예요.

Step 2: SKILL.md 작성하기

자, 이제 스킬의 심장을 만들 차례예요. SKILL.md 파일이요.

2부에서 배웠죠? SKILL.md는 AI에게 주는 레시피 카드라고요. 이 파일 하나가 스킬의 전부예요.

hello-skill 폴더 안에 SKILL.md 파일을 만들고, 다음 내용을 그대로 입력하세요:

---
description: "사용자에게 따뜻한 한국어 인사를 해주는 스킬"
---

# 인사하기 스킬

당신은 따뜻하고 친근한 한국어 인사 전문가입니다.

사용자가 인사를 하면 (예: "안녕", "하이", "hello", "좋은 아침") 다음을 수행하세요:

1. 시간대에 맞는 따뜻한 한국어 인사로 응답하세요
   - 아침이면 "좋은 아침이에요! ☀️"
   - 낮이면 "안녕하세요! 좋은 하루 보내고 계신가요? 😊"
   - 저녁이면 "좋은 저녁이에요! 오늘 하루 수고 많으셨어요 🌙"
2. 오늘 날짜에 대한 재미있는 사실을 하나 알려주세요
   - 역사적 사건, 유명인 생일, 특별한 기념일 등
3. 하루를 응원하는 짧은 한마디를 덧붙이세요

## 톤과 스타일
- 친구처럼 편하지만 예의 바르게
- 이모지를 적절히 사용
- 너무 길지 않게, 3-5줄 정도로

## 예시 응답
"좋은 아침이에요! ☀️

오늘은 3월 27일인데요, 1845년에 뢴트겐이 X선을 발견한 날이에요!
눈에 보이지 않는 것도 발견할 수 있다니, 오늘 하루도 새로운 발견이
있는 멋진 날이 되길 바랄게요! 💪"

다 입력하셨나요? 그러면 저장하세요.

지금 폴더 구조:

hello-skill/
  └── SKILL.md    ← 이게 전부!

잠깐, 이 파일을 해부해볼까요?

방금 만든 파일이 뭘 하는 건지 하나하나 뜯어볼게요.

1. 프론트매터 (맨 위 --- 사이 부분)

---
description: "사용자에게 따뜻한 한국어 인사를 해주는 스킬"
---

이건 스킬의 "명찰"이에요. Claude Code가 "이 스킬이 뭘 하는 거지?"를 빠르게 파악하는 데 사용해요. 사용자가 인사를 하면, Claude Code가 이 description을 보고 "아, 인사하기 스킬을 쓰면 되겠다!"라고 판단하는 거예요.

2. 제목과 역할 (# 인사하기 스킬)

# 인사하기 스킬

당신은 따뜻하고 친근한 한국어 인사 전문가입니다.

AI에게 "너는 이런 사람이야"라고 역할을 부여하는 부분이에요. 배우에게 "너는 인사 전문가야"라고 대본을 주는 것과 같아요.

3. 지시사항 (번호 목록)

"이런 순서로 이렇게 해"라는 구체적인 지시예요. 요리 레시피의 조리 순서와 같죠.

4. 톤과 스타일

"어떤 느낌으로 해"라는 스타일 가이드예요. "친구처럼 편하지만 예의 바르게" — 이 한 줄이 AI의 응답 분위기를 결정해요.

5. 예시 응답

"이런 식으로 해줘"라는 샘플이에요. AI는 예시를 보면 훨씬 더 정확하게 의도를 파악해요.

Step 3: 설치하고 테스트하기

스킬을 만들었으니, 이제 Claude Code에게 알려줘야 해요. "이런 스킬이 있으니 써봐!"라고요.

설치 방법

방법은 아주 간단해요. 우리가 만든 hello-skill 폴더를 Claude Code의 스킬 폴더에 넣으면 됩니다.

방법 A: 프로젝트 스킬로 설치 (추천)

작업 중인 프로젝트 폴더에 .claude/skills/ 디렉토리를 만들고, 거기에 넣으면 돼요:

# 프로젝트 폴더에서 실행
mkdir -p .claude/skills/
cp -r hello-skill .claude/skills/

이렇게 하면 해당 프로젝트에서 Claude Code를 실행할 때 자동으로 스킬을 인식해요.

방법 B: 글로벌 스킬로 설치

어디서든 쓰고 싶으면, 홈 디렉토리의 스킬 폴더에 넣으면 돼요:

# 글로벌 스킬 폴더에 설치
mkdir -p ~/.claude/skills/
cp -r hello-skill ~/.claude/skills/

테스트!

설치했으면, 이제 Claude Code를 실행하고 인사해보세요:

claude

Claude Code가 실행되면, 간단하게 이렇게 말해보세요:

안녕!

그러면... 두근두근...

작동합니다!

여러분이 방금 만든 스킬이, AI의 응답 방식을 바꿨어요. 그냥 "안녕하세요"라고만 대답하던 AI가, 재미있는 사실과 응원 메시지까지 전해주는 친구가 됐어요.

축하합니다! 여러분은 방금 첫 번째 AI 스킬을 만들었어요!

뒤에서 무슨 일이 일어난 걸까?

"그래, 작동은 하는데... 도대체 어떻게 되는 거야?"

좋은 질문이에요. 여러분이 "안녕!"이라고 입력한 순간부터 응답이 나올 때까지, 뒤에서 일어나는 일을 순서대로 볼게요:

1. 사용자 입력: 여러분이 "안녕!"이라고 타이핑
2. 스킬 탐색: Claude Code가 설치된 스킬들의 description을 훑어봄
3. 매칭: "사용자에게 따뜻한 한국어 인사를 해주는 스킬" — 오, 이게 딱이네!
4. 스킬 로드: SKILL.md의 내용을 읽어서 AI의 지시사항에 추가
5. 응답 생성: AI가 스킬의 지시를 따라 인사 + 재미있는 사실 + 응원 메시지를 생성
6. 출력: 완성된 응답이 화면에 표시!

핵심은 3번과 4번이에요. Claude Code가 자동으로 적절한 스킬을 찾아서 적용하는 거예요. 여러분이 "/인사하기"라고 명시적으로 스킬을 호출하지 않아도, AI가 문맥을 보고 "아, 이 상황에서는 이 스킬이 맞겠다"고 판단하는 거죠.

변형 도전! 나만의 색깔 입히기

첫 스킬이 작동하는 걸 확인했으니, 이제 조금씩 바꿔볼 차례예요. 스킬의 매력은 내 마음대로 고칠 수 있다는 거예요.

변형 1: 사투리 인사 스킬

SKILL.md의 톤 부분을 이렇게 바꿔보세요:

## 톤과 스타일
- 부산 사투리로 인사하기
- 구수하고 정겨운 느낌
- "~하이가", "~아이가" 같은 부산 특유의 어미 사용

그러면 AI가 이렇게 응답해요: "오, 왔나! 좋은 아침이다 아이가! ☀️"

변형 2: 격식체 인사 스킬

## 톤과 스타일
- 조선시대 선비처럼 격식 있게
- "~하옵니다", "~이로소이다" 같은 고풍스러운 어미
- 한자 성어를 하나 포함

변형 3: 랩퍼 인사 스킬

## 톤과 스타일
- 힙합 스타일로 인사하기
- 라임을 넣어서 리듬감 있게
- "yo!", "check it" 같은 표현 자연스럽게 섞기

어때요? 톤 부분 몇 줄만 바꿨는데, 완전히 다른 스킬이 되죠?

이게 바로 스킬의 힘이에요. 한국어로 글을 바꾸면, AI의 행동이 바뀌어요. 코드를 짤 줄 몰라도, 글을 쓸 줄 알면 AI를 원하는 대로 움직일 수 있어요.

혹시 안 되나요? 당황하지 마세요

처음 만들 때 안 되는 건 당연해요. 몇 가지 흔한 문제와 해결법을 알려드릴게요.

"스킬이 인식이 안 돼요"

• 파일 이름이 정확히 SKILL.md인지 확인 (대문자!)
• 파일이 hello-skill/SKILL.md 경로에 있는지 확인
• Claude Code를 재시작해보세요

"스킬이 적용되는 것 같지 않아요"

• description 필드가 있는지 확인 — 이게 없으면 Claude Code가 스킬을 찾을 수 없어요
• 프론트매터의 ---가 정확히 두 줄 있는지 확인

"응답이 내 기대와 좀 달라요"

• 이건 정상이에요! AI는 매번 조금씩 다르게 응답해요
• 더 정확한 응답을 원하면, 지시사항을 더 구체적으로 적으면 돼요 (이건 다음 챕터에서!)