Appearance
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.mdSkills 파일을 만들고, 이번 주 수업 내용으로 실제 퀴즈를 하나 만들어보세요.
파일 하나 만드는 데 3분, 테스트에 1분. 총 4분이면 됩니다. 한번 만들어두면 이번 학기 내내 쓸 수 있어요. 다음에 퀴즈가 필요할 때 /quiz-from-chapter만 입력하면 되니까요.
이번 챕터 핵심 3가지
Skills = 반복 프롬프트를 슬래시 명령어로 저장하는 매크로 기능.
~/.claude/commands/폴더에 마크다운 파일을 만들면 끝.$ARGUMENTS = Skills 파일 안의 '재료 자리'. 명령어 뒤에 붙이는 내용이 자동으로 이 자리에 들어감.
CLAUDE.md + Skills = 교사 정보(신분증)와 업무 방식(매뉴얼)이 합쳐지면 클로드코드가 처음부터 맥락을 아는 AI 비서로 작동.