Skip to content

Ch.9: 나만의 도우미 버튼 만들기 — Skills 입문 ​

이 챕터를 읽으면 /quiz-from-chapter, /grade-rubric 같은 나만의 슬래시 명령을 만들어 반복 프롬프트를 버튼 하나로 실행할 수 있습니다.


🎬 시나리오 ​

금요일 오후 5교시가 끝났습니다.

박선생님은 이번 주 수업 내용으로 형성평가 퀴즈를 만들어야 합니다. 클로드코드 채팅창을 열고 타이핑을 시작합니다.

"너는 초등학교 담임 교사야. 다음 내용으로 5지선다 객관식 5문제를 만들어줘. 난이도는 중간으로, 기본 개념 이해 여부를 확인할 수 있게 해줘. 각 문제에는 정답과 2~3줄 해설을 붙여줘. 학습 내용은..."

퀴즈가 만들어집니다. 결과물이 마음에 듭니다.

월요일. 다음 단원 퀴즈를 만들려고 또 클로드코드를 엽니다. 아까 그 긴 프롬프트를... 어디 갔지? 지난 대화 기록을 뒤져봅니다. 찾았습니다. 복사합니다. 붙여넣습니다. 단원 내용만 바꿔서 다시 보냅니다.

수요일. 또 같은 과정을 반복합니다. 복사, 붙여넣기, 수정, 전송.

박선생님이 한숨을 쉽니다.

"이 명령어를 매번 입력해야 해? 단축키 같은 거 없어?"


💬 김선생님 한마디 ​

"있어요. Skills라는 기능이요. 제가 처음 이걸 발견했을 때, '이걸 왜 이제야 알았지?' 싶었어요. 매일 쓰는 긴 프롬프트를 파일 하나에 저장해두면, /quiz 한 줄로 끝나요. 전자레인지 '팝콘 버튼'처럼요."


📖 이게 왜 되나요? ​

9-1. Skills가 뭔가요? ​

전자레인지의 '자동 요리 버튼'을 떠올려보세요. 팝콘 버튼을 누르면 시간과 출력이 자동으로 설정됩니다. 매번 "2분 30초, 출력 700W"를 직접 입력할 필요가 없죠. Skills도 같은 원리예요. 복잡한 프롬프트를 파일 하나에 저장해두면, /quiz-from-chapter 한 줄로 실행됩니다.

기술적으로는 이렇습니다. Skills 파일은 두 곳에 저장할 수 있어요.

  • ~/.claude/commands/ (전역) — 모든 프로젝트에서 사용 가능
  • .claude/commands/ (프로젝트 내) — 현재 작업 폴더에서만 사용

처음에는 프로젝트 폴더 안의 .claude/commands/ 에 저장하는 게 가장 간단해요. 나중에 "이 버튼을 어디서든 쓰고 싶다"는 생각이 들면 ~/.claude/commands/로 옮기면 됩니다. 파일 이름이 곧 슬래시 명령어가 됩니다.

파일 이름실행 명령어
quiz-from-chapter.md/quiz-from-chapter
grade-rubric.md/grade-rubric
lesson-plan.md/lesson-plan

그리고 파일 안에 $ARGUMENTS라는 특별한 자리 표시가 있어요. 이건 레시피의 '재료'에 해당합니다. 만드는 법(프롬프트 구조)은 파일에 저장되어 있고, 재료(실제 내용)는 명령어를 실행할 때 그때그때 넣어줍니다.

Skills가 없을 때:

매번 직접 타이핑:

"너는 초등학교 담임 교사야. 다음 내용으로 5지선다 객관식
5문제를 만들어줘. 난이도는 중간으로, 기본 개념 이해 여부를
확인할 수 있게 해줘. 각 문제에는 정답과 2~3줄 해설을 붙여줘.
학습 내용은: [지문 내용]"

Skills가 있을 때:

/quiz-from-chapter 광합성의 정의, 과정, 필요한 조건

이게 끝이에요. 나머지는 저장해둔 프롬프트가 알아서 처리합니다.


9-2. $ARGUMENTS — 매번 다른 재료 넣기 ​

레시피 비유를 조금 더 해볼게요. 카레 레시피에는 "재료를 볶는다 → 물을 붓는다 → 카레 가루를 넣는다"라는 흐름이 정해져 있어요. 하지만 재료는 바뀌죠. 오늘은 닭고기, 내일은 소고기. $ARGUMENTS가 바로 이 '재료 자리'입니다.

Skills 파일 안에 $ARGUMENTS를 넣어두면, 명령어 뒤에 붙이는 내용이 자동으로 그 자리에 들어갑니다.

예를 들어 이렇게 입력하면:

/quiz-from-chapter 오늘 배운 광합성의 정의, 과정, 필요한 조건들

클로드코드는 내부적으로 이렇게 실행해요:

다음 학습 내용으로 퀴즈 10문제를 만들어줘.
형식: 선택지 4개 (①②③④), 정답 표시, 해설 1~2문장
난이도: 초등학교 4학년 기준
...
학습 내용: 오늘 배운 광합성의 정의, 과정, 필요한 조건들

$ARGUMENTS 자리에 선생님이 입력한 내용이 그대로 들어간 거예요. 이 원리 하나만 이해하면 어떤 Skills든 만들 수 있습니다.


🖥️ 실습해보기 ​

9-3. Skills 만들기 실습 ​

Step 1: 폴더 확인 ​

VS Code 터미널에서 다음을 입력하세요.

bash
ls ~/.claude/commands/

폴더가 없다고 나와도 괜찮아요. 클로드코드가 자동으로 만들어줍니다. 또는 클로드코드 채팅창에 이렇게 요청하면 됩니다:

내 프로젝트에 .claude/commands 폴더를 만들어줘.
없으면 새로 만들고, 이미 있으면 있다고 알려줘.

폴더가 준비됐으면 다음 단계로 넘어가세요.


Step 2: 첫 번째 Skill — 퀴즈 생성기 ​

클로드코드 채팅창에 이렇게 요청하세요:

.claude/commands/quiz-from-chapter.md 파일을 새로 만들어줘.
파일 내용은 아래와 같아:

파일 내용:

markdown
# 퀴즈 생성기

$ARGUMENTS 챕터 내용을 읽고 퀴즈 10문제를 만들어줘.

형식:
- 선택지 4개 (①②③④)
- 정답 표시
- 해설 1~2문장

난이도: 초등학교 4학년 기준
결과 파일: quiz-{{날짜}}.md

"파일 생성 완료"라는 응답이 오면 성공입니다.

이제 테스트해볼게요:

/quiz-from-chapter @Unit4-본문.txt

@를 붙이면 파일 내용을 통째로 넘겨줄 수 있어요. 파일이 없다면 직접 내용을 타이핑해도 됩니다:

/quiz-from-chapter 식물의 광합성: 엽록체에서 빛에너지를 이용해
물과 이산화탄소를 포도당과 산소로 변환하는 과정

10문제짜리 퀴즈가 자동으로 만들어지면 성공이에요.


Step 3: 두 번째 Skill — 루브릭 생성기 ​

같은 방법으로 두 번째 Skills를 만들어봅시다.

파일: .claude/commands/grade-rubric.md

markdown
# 루브릭 생성기

$ARGUMENTS 과제에 대한 루브릭을 만들어줘.

형식:
- 5점 척도
- 평가 항목 4가지
- 각 점수별 구체적 기준
- 총점 20점

결과 파일: rubric-{{과제명}}.md

테스트:

/grade-rubric 중2 과학 발표 과제 — 내가 좋아하는 과학자를
조사하고 5분 발표하기

20점 만점 루브릭이 자동으로 만들어집니다. 매번 평가 기준을 처음부터 작성할 필요가 없어요.


Step 4: 세 번째 Skill — 수업안 생성기 ​

파일: .claude/commands/lesson-plan.md

markdown
# 수업안 생성기

$ARGUMENTS 내용으로 45분 수업안을 만들어줘.

구조:
- 도입(5분): 전시학습 확인 + 동기유발
- 전개(30분): 핵심 활동 3단계
- 정리(10분): 요약 + 형성평가

내 CLAUDE.md 설정 참고해서 내 과목·학년에 맞게.
결과 파일: lesson-plan-{{주제}}.md

여기서 눈여겨볼 점이 하나 있어요. "내 CLAUDE.md 설정 참고해서"라는 문장을 넣었죠. Ch.8에서 CLAUDE.md에 학교급, 교과, 학년 정보를 저장했잖아요. Skills가 이 정보를 자동으로 참조합니다. 매번 "초등학교 4학년 과학"이라고 입력하지 않아도 되는 거예요.

CLAUDE.md가 "나는 이런 교사예요"라는 신분증이라면, Skills는 "이런 일을 이 방식으로 해줘"라는 업무 매뉴얼입니다. 신분증과 매뉴얼이 모두 준비된 보조 교사는 첫날부터 바로 일할 수 있죠.


9-4. 교육자 추천 Skills 모음 ​

세 가지 기본 Skills를 만들어봤으니, 교육 현장에서 바로 쓸 수 있는 Skills를 더 소개할게요. 클로드코드에게 "이 내용으로 파일 만들어줘"라고 하면 됩니다.


파일명: feedback.md — 학생 피드백 초안 생성

markdown
# 학생 피드백 생성기

$ARGUMENTS 학생 관찰 메모를 바탕으로 개인 피드백 초안을 써줘.

원칙:
- 긍정 먼저 → 개선점 → 미래 행동 제안 순서
- 구체적 행동 중심 (막연한 칭찬이나 비판 금지)
- 학생이 읽어도 상처받지 않는 말투

두 가지 버전:
- 구두 피드백용: 150~200자
- 서면 피드백용: 300~400자

사용 예시:

/feedback 발표는 자신감 있게 했지만 내용 정리가 부족함.
핵심과 부가 내용을 구분하지 못함. 그림 활용은 창의적이었음.

파일명: weekly-report.md — 학부모 주간 보고서 생성

markdown
# 주간 학습 보고서 생성기

$ARGUMENTS 이번 주 수업 내용을 학부모에게 보내는
주간 학습 보고서로 변환해줘.

분량: A4 반 장 (300~400자)
문체: 따뜻하고 전문적으로, 교육 용어는 풀어서 설명
구성: 이번 주 배운 내용 / 다음 주 예고 / 가정에서 도울 수 있는 것

파일명: differentiate.md — 수준별 자료 변환

markdown
# 수준별 자료 변환기

$ARGUMENTS 원본 학습 자료를 3가지 수준으로 변환해줘.

기초 수준 (하위 30%):
- 핵심 개념만 남기기
- 어려운 단어는 쉬운 말로 교체

보통 수준 (중위 50%):
- 원본 내용 유지, 필요시 부가 설명 추가

심화 수준 (상위 20%):
- 비판적 사고 질문 2개 추가
- 심화 탐구 활동 1개 제안

이 여섯 가지 Skills(quiz-from-chapter, grade-rubric, lesson-plan, feedback, weekly-report, differentiate)만 있어도 주간 업무의 상당 부분이 자동화됩니다.


9-5. Skills와 CLAUDE.md의 시너지 ​

잠깐, 한 가지 더 알려드릴게요.

신입 보조 교사가 처음 왔을 때를 떠올려보세요. 학교, 학년, 교과, 학생 특성을 처음부터 다 설명해야 하죠. CLAUDE.md는 그 오리엔테이션 자료예요. Skills는 "이런 업무는 이 방식으로 해줘"라는 업무 매뉴얼이에요. 오리엔테이션과 매뉴얼이 모두 준비된 보조 교사는 첫날부터 일을 잘하는 사람처럼 움직입니다.

예를 들어, CLAUDE.md에 이렇게 써두었다면:

- 교사 정보: 서울 OO초등학교, 과학 4학년 담당
- 학급: 4-3반 (30명), 4-5반 (30명)
- 주요 참고: 2022 개정 교육과정

/lesson-plan 식물의 호흡 이라고 입력하면, 클로드코드가 자동으로 초등학교 4학년 과학, 2022 개정 교육과정에 맞춰 수업안을 만들어요. 매번 학교급이나 교과를 따로 입력하지 않아도 됩니다.


9-6. MCP 맛보기 ​

Skills가 내 손으로 만든 버튼이라면, MCP는 외부 서비스를 연결하는 어댑터예요.

USB 허브를 생각해보세요. 노트북에 USB 허브를 꽂으면 마우스, 키보드, 외장 하드를 동시에 연결할 수 있죠. MCP(Model Context Protocol)도 마찬가지입니다. 클로드코드에 MCP를 연결하면 구글드라이브, 노션, 슬랙 같은 외부 도구를 직접 읽고 쓸 수 있게 됩니다.

교육자에게 특히 유용한 MCP 세 가지를 소개할게요:

MCP연결되는 도구할 수 있는 일
Google Drive MCP구글드라이브드라이브 파일 직접 읽기/쓰기/검색
Notion MCP노션페이지 읽기, 새 페이지 생성, 데이터베이스 관리
Gmail MCP지메일이메일 초안 자동 작성

MCP 설정은 Skills보다 약간 더 기술적이에요. 하지만 당황하지 마세요. 클로드코드에게 "구글드라이브 MCP 연결하고 싶어. 처음 하는 거야"라고 말하면 단계별로 안내해줍니다.

상세한 설정 방법은 부록 E에서 MCP별 설치 명령어와 단계별 안내를 확인하실 수 있어요. MCP는 업데이트가 자주 되는 기능이라, 막히면 클로드코드에게 직접 "구글드라이브 MCP 연결하고 싶어. 처음이야"라고 물어보는 게 가장 확실합니다.

중요한 건 — MCP를 허용해도 클로드코드가 모든 파일에 접근하는 건 아니에요. 내가 설정해서 허용한 범위 안에서만 접근합니다. 안심하셔도 돼요.


9-7. Hooks — 자동 실행 장치 맛보기 ​

Skills가 "내가 부를 때 실행"하는 버튼이라면, Hooks는 "특정 상황이 되면 자동으로 실행"되는 장치예요.

도어락을 생각해보세요. 누군가 누를 때만 열리는 게 Skills예요. Hooks는 센서 도어락처럼 사람이 다가오면 자동으로 열리는 방식입니다.

교육자에게 유용한 Hooks 예시:

  • 저장할 때마다 자동 백업: 파일을 저장하면 자동으로 구글드라이브에 복사
  • 작업 완료 후 자동 보고: 클로드코드가 작업을 마치면 자동으로 슬랙 메시지 발송

Hooks는 Skills보다 설정이 조금 더 복잡하지만, 한 번 만들어두면 매일 반복되는 일을 완전히 자동화할 수 있어요. 지금은 "이런 것도 있다"는 정도만 알아두세요. 더 알고 싶다면 공식 문서를 참고하세요: https://code.claude.com/docs/en/hooks


9-8. 이번 주부터 바로 쓸 수 있는 자동화 루틴 ​

이론은 충분히 봤어요. 실제로 이번 주 업무에 적용할 수 있는 루틴 세 가지를 보여드릴게요.

루틴 1: 월요일 아침 — 수업 준비 패키지 (20분)

1단계: /lesson-plan 중2 과학, 식물의 호흡 작용 첫 수업
2단계: /quiz-from-chapter 호흡 작용의 정의, 미토콘드리아, 산소 소비
3단계: /differentiate [2단계에서 나온 학습지 내용]

세 단계 합쳐서 20분. 수업안, 퀴즈, 수준별 자료가 모두 준비됩니다.

루틴 2: 금요일 오후 — 학생 피드백 처리 (30분)

/feedback 발표 자신감 있음. 내용 정리 부족. 그림 활용 창의적.

학생 20명의 피드백을 개인화된 내용으로 30분 안에 처리할 수 있어요.

루틴 3: 월말 — 학부모 주간 보고서 (10분)

/weekly-report 이번 주 과학 수업에서 광합성의 원리와 과정을 배웠습니다.
엽록체에서 빛, 물, 이산화탄소가 포도당으로 바뀌는 과정을 학습했고,
엽록소 추출 실험도 직접 해봤습니다.

5분 입력, 5분 검토. 따뜻한 학부모 보고서가 완성됩니다.


9-9. 자주 묻는 질문 (Q&A) ​

Q: Skills 파일을 잘못 만들면 어떻게 돼요?

걱정 마세요. 최악의 경우 명령어가 작동 안 하거나 이상한 결과가 나와요. 파일을 수정하거나 삭제하면 됩니다. Skills 파일은 텍스트 파일이라 삭제해도 클로드코드에 아무 영향이 없어요.

Q: Skills는 얼마나 만들 수 있어요?

제한이 없어요. 다만 자주 쓰는 것 위주로 10개 내외를 관리하는 게 좋아요. 너무 많으면 어떤 Skills가 있는지 기억하기 어려워지거든요.

Q: 동료 선생님들과 공유할 수 있나요?

물론이에요. .claude/commands/ 폴더의 마크다운 파일들을 이메일로 보내거나 구글드라이브에 올려두면 됩니다. 받은 파일을 같은 경로에 넣으면 바로 사용할 수 있어요.


🎯 이번 주 딱 한 가지 ​

quiz-from-chapter.md Skills 파일을 만들고, 이번 주 수업 내용으로 실제 퀴즈를 하나 만들어보세요.

파일 하나 만드는 데 3분, 테스트에 1분. 총 4분이면 됩니다. 한번 만들어두면 이번 학기 내내 쓸 수 있어요. 다음에 퀴즈가 필요할 때 /quiz-from-chapter만 입력하면 되니까요.


이번 챕터 핵심 3가지

  1. Skills = 반복 프롬프트를 슬래시 명령어로 저장하는 매크로 기능. ~/.claude/commands/ 폴더에 마크다운 파일을 만들면 끝.

  2. $ARGUMENTS = Skills 파일 안의 '재료 자리'. 명령어 뒤에 붙이는 내용이 자동으로 이 자리에 들어감.

  3. CLAUDE.md + Skills = 교사 정보(신분증)와 업무 방식(매뉴얼)이 합쳐지면 클로드코드가 처음부터 맥락을 아는 AI 비서로 작동.



교사를 위한 클로드 코드 완벽 입문(2026)