이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.
클로드 코드 스킬 설치와 수정법, ELI5 스킬 2종 비교
클로드 코드 스킬 설치부터 SKILL.md를 열어 내 입맛대로 고치는 법까지, 이름이 같은 ELI5 스킬 두 개에 같은 질문을 넣은 결과와 함께 설명합니다. 설치 명령, 세션 비우기, 프런트매터(파일 맨 위 설정 칸) 수정까지 개발 경험 없이 따라 할 수 있게 풀었습니다.

클로드 코드 ELI5 스킬이 필요한 순간
클로드에게 뭘 설명해 달라고 하면 장황한 글이 돌아오고, 그 설명에 나온 용어를 또 물어봐야 하는 일이 생깁니다. 이럴 때 글 대신 그림으로, 혹은 다섯 살 눈높이로 풀어 주는 스킬이 ELI5(Explain Like I'm 5, "다섯 살에게 설명하듯")입니다. 스킬(skill)은 클로드에게 특정 일을 하는 방법을 적어 둔 지시서 묶음이고, 핵심은 SKILL.md
이 글은 같은 이름을 가진 스킬 두 개에 똑같은 질문을 넣어 비교합니다. 절반은 두 스킬의 결과 비교, 나머지 절반은 스킬을 어떻게 공부하고 내 것으로 고칠지입니다. 스킬은 실행해 보는 것 자체보다, 열어 보고 내 쓰임에 맞게 고치는 과정이 더 중요합니다.
스킬 없이 물어보면 어떻게 나오나
예로 고른 질문은 누구나 한 번쯤 겪은 상황입니다. 쇼핑몰에서 운동화를 한 번 봤을 뿐인데 다른 앱을 켜니 그 운동화 광고가 또 뜬다. 다른 앱은 내가 뭘 봤는지 어떻게 아는 걸까. 흔히 타게팅 광고라고 부르는 그것입니다.
이 질문을 스킬 없이 그대로 넣으면 "리타게팅 광고 시스템", "스마트폰에 부여된 광고 식별자", 안드로이드와 아이폰이 각각 뭐라고 부르는지 같은 전문용어가 줄줄이 나옵니다. 답이 틀린 건 아닙니다. 다만 처음 듣는 용어가 계속 나오니 어렵습니다.
첫 번째 ELI5 스킬, 마켓플레이스 버전
첫 번째는 클로드 코드가 제공하는 마켓플레이스(플러그인과 스킬을 모아 둔 목록)에서 설치한 스킬입니다. 설치 방법은 아래 13단계의 2단계에 적어 두었습니다.
같은 질문을 다시 넣자 "신발이 왜 나를 따라오는지 그림 다섯 개로 설명하는 페이지를 만들었다"는 답과 함께 HTML 아티팩트가 열립니다. 아티팩트는 클로드가 대화 옆에 따로 만들어 보여 주는 웹 페이지나 문서입니다. 여기서는 도식과 그림으로 개념을 설명하는 페이지였습니다.
생성된 페이지가 설명한 내용
페이지의 흐름은 이렇습니다.
- 쇼핑 앱에서 운동화를 눈으로만 봤다. 누르지도, 사지도 않았다.
- 그런데 내 폰에 조용히 "번호표"가 붙는다. 사람 이름이 아니라 이 폰만의 숫자 번호다. 어려운 말로는 기기 식별자(디바이스 ID).
- 이 번호표가 광고 회사로 넘어간다. 여러 앱에 동시에 광고를 걸어 주는 회사다.
- 다른 앱을 열면 광고 회사가 번호표를 다시 확인한다. "이 번호표, 저번에 신발 봤던 거네" 하고 기억을 꺼내 신발 광고를 꽂는다.
- 비유는 놀이공원 손목 밴드. 직원은 내 이름을 몰라도 밴드 번호만 보면 아까 그 사람인 줄 안다.
이게 클로드의 아티팩트입니다. 글로 읽을 때보다 도식으로 보니 개념이 훨씬 쉽게 잡힙니다.
SKILL.md는 몇 줄짜리
스킬은 SKILL.md 파일 하나에 들어 있고, 이 버전은 굉장히 짧습니다. description(스킬이 무엇을 하는지 적는 칸)에 적힌 지시는 대략 이렇습니다.
내가 다섯 살인 걸로 간주하고 주제를 설명해라.
HTML 아티팩트를 사용해서 큰 그림과 단어를 거의 쓰지 않고 설명을 만들어라.
아키텍처(프로그램의 전체 구조)를 그림으로 그릴 때 /artifact
두 번째 ELI5 스킬, 저장소 버전
같은 이름의 다른 스킬입니다. GitHub(개발자들이 코드를 올려 공유하는 사이트)에서 스타(즐겨찾기 수)를 어느 정도 받았고, 마켓플레이스 버전보다 description과 설명이 훨씬 많이 들어 있습니다. 설치 방법은 저장소 README(저장소 첫 화면의 안내문)의 Installation 절에 있고, 그대로 따라 하면 됩니다.
설치하고 세션을 비운 뒤 같은 모델로 같은 질문을 넣습니다. 같은 이름의 스킬이 2개지만, 플러그인으로 설치한 쪽은 슬래시 명령 목록에 /플러그인이름:eli5
결과는 아티팩트 없이 비유로
이 스킬은 시각화가 아니라 설명을 간결하고 쉽게 하는 쪽이라 아티팩트나 HTML을 만들지 않습니다. 대신 이런 비유가 나왔습니다.
- 운동화에 몰래 붙은 스티커 = 쿠키.
- 헨젤과 그레텔이 빵가루를 떨어뜨리며 걸어간 이야기. 인터넷을 돌아다닐 때도 비슷한 일이 일어난다.
- 쇼핑 앱에서 운동화를 구경하면 앱이 "이 사람 운동화 봤음"이라는 작은 메모지를 내 폰에 붙인다.
- 광고 회사들은 여러 앱과 손을 잡고 있어서, 다른 앱을 켜도 "이 폰에 운동화 스티커가 있네, 운동화 광고를 보여 줘야지" 하고 알아챈다.
README에 있는 청중 옵션
개발자나 광고업계 종사자처럼 비유보다 한 단계 올라간 설명을 원하는 사람을 위해 이 스킬은 여러 옵션을 둡니다. README에 지원 청중 카테고리가 정리돼 있습니다.
- 연령대(age range): 5살, 10살, 15살 등
- 학력 수준(grade levels)
- 직무(jobs): 매니저, 엔지니어, 디자이너, PM
- 관계: 아내, 남편, 아이들, 친구들
클로드 코드 스킬 설치부터 수정까지 13단계
아래는 두 스킬을 설치하고 비교한 뒤 SKILL.md를 고치기까지의 순서입니다. 저장소 주소는 특정하지 않고, 어떤 저장소든 똑같이 쓰는 명령 형식으로 적었습니다.
준비물
- 클로드 유료 요금제 계정. 클로드 코드는 유료 요금제나 API 결제가 있어야 쓸 수 있고, 요금은 바뀌므로 공식 안내를 확인해야 합니다.
- 클로드 코드(Claude Code)가 설치돼 실행되는 상태
- 스킬: ELI5 계열 스킬 두 개(마켓플레이스 버전, GitHub 저장소 버전)
클로드 코드를 아직 안 깔았다면 이렇게 합니다.
- 맥은
Command + 스페이스로 Spotlight를 열고 "터미널"을 쳐서 엽니다. 윈도우는 시작 메뉴에서 "PowerShell"을 엽니다. - 맥 터미널에 아래 명령을 붙여 넣고 엔터를 누릅니다.
curl -fsSL https://claude.ai/install.sh | bash
- 설치가 끝나면 작업할 폴더에서
claude를 치고 엔터를 누릅니다. - 처음 실행하면 브라우저가 열리며 로그인하라고 나옵니다. 클로드 계정으로 로그인합니다.
윈도우는 PowerShell에 아래 명령을 붙여 넣습니다. 설치 안내 원문은 code.claude.com/docs의 Claude Code 설치 문서에 있습니다(2026년 10월 기준).
irm https://claude.ai/install.ps1 | iex
1단계. 스킬 없이 타게팅 광고 질문을 넣는다
클로드 코드 입력창에 질문을 입력합니다.
쇼핑몰에서 운동화를 한 번 봤는데 다른 앱을 켰더니 운동화 광고가 또 나온다.
다른 앱은 내가 뭘 봤는지 어떻게 아는 걸까?
확인: "리타게팅 광고 시스템", "광고 식별자", 안드로이드·아이폰별 명칭 같은 전문용어가 섞인 글 답변이 나온다.
2단계. 마켓플레이스에서 첫 번째 스킬을 설치한다
클로드 코드 입력창에 아래를 치고 엔터를 누르면 플러그인 관리 화면이 열립니다.
/plugin
- 방향키로 Discover(찾아보기) 탭으로 갑니다.
- 검색에
eli5를 입력합니다. - 원하는 항목에서 엔터를 눌러 상세 화면을 엽니다. 함께 들어올 스킬·훅·MCP가 적혀 있으니 한 번 읽습니다.
- 설치 범위를 고릅니다. 나만 모든 프로젝트에서 쓰려면 "Install for you(user scope)"를 고릅니다.
찾는 스킬이 기본 마켓플레이스에 없고 다른 사람이 만든 마켓플레이스에 있다면, 그 마켓플레이스를 먼저 등록한 뒤 설치합니다. 형식은 이렇습니다.
/plugin marketplace add GitHub사용자이름/저장소이름
/plugin install 플러그인이름@마켓플레이스이름
확인: 설치 끝에 "Plugin is now active."가 뜨면 바로 쓸 수 있습니다. "Run /reload-plugins to apply."가 뜨면 /reload-plugins//플러그인이름:eli5 형태로 스킬이 보이고, /plugin
3단계. 1단계와 똑같은 질문을 다시 넣는다
확인: "신발이 왜 나를 따라오는지 그림 다섯 개로 설명하는 페이지를 만들었다"는 답과 함께 HTML 아티팩트(도식+그림)가 열린다.
4단계. 첫 번째 스킬의 SKILL.md를 연다
플러그인으로 설치한 스킬은 내 홈 폴더의 .claude/plugins 아래에 들어갑니다. 위치를 모르겠으면 맥 터미널에서 이렇게 찾습니다.
find ~/.claude -name SKILL.md | grep -i eli5
나온 경로를 텍스트 편집기로 엽니다. 맥이라면 open -e 경로
확인: 아주 짧은 파일이고, description에 "내가 다섯 살인 걸로 간주하고 설명해라. HTML 아티팩트를 써서 큰 그림과 단어를 거의 쓰지 않고 설명을 만들어라"는 취지의 지시가 있다.
5단계. 두 번째 스킬 저장소의 README에서 Installation 절을 읽는다
GitHub 저장소 첫 화면을 아래로 내리면 README가 보입니다. 그 안의 Installation 제목을 찾습니다.
확인: 설치 방법이 적혀 있다.
6단계. Installation에 적힌 대로 설치한다
README에 적힌 명령을 그대로 복사해 씁니다. 저장소가 마켓플레이스 형식이면 2단계의 /plugin marketplace add 방식을 씁니다. README에 npx skills add GitHub사용자이름/저장소이름 같은 한 줄이 있으면 터미널에서 그대로 실행합니다(Node.js 22.20 이상 필요, 끝에 -g
git clone https://github.com/GitHub사용자이름/저장소이름.git
mkdir -p ~/.claude/skills
cp -r 저장소이름/스킬폴더이름 ~/.claude/skills/
~/.claude/skills/.claude/skills/SKILL.md~/.claude/skills/스킬폴더이름/ 바로 안에 있어야 인식됩니다. 클로드 코드가 켜져 있었다면 /reload-skills
확인: /skills 목록에 eli5 스킬이 2개 보인다. 직접 넣은 것은 /eli5, 플러그인으로 설치한 것은 /플러그인이름:eli5
7단계. 세션을 비운다
이전 대화가 다음 답에 영향을 주지 않게 대화 기록을 지웁니다. 입력창에 이렇게 칩니다.
/clear
확인: 이전 대화가 없는 상태에서 새 질문을 할 수 있다.
8단계. 같은 모델로 1단계와 같은 질문을 다시 넣는다
1단계 질문을 그대로 넣어도 되지만, 청중(다섯 살, 엔지니어 등)을 함께 적으면 스킬이 더 잘 발동됩니다. 이렇게 청중을 붙여 보길 권합니다.
/eli5 타게팅 광고가 어떻게 나를 따라오는지, 광고 업계 신입 마케터에게 설명해 줘
슬래시 뒤 이름은 내 목록에 뜬 실제 스킬 이름으로 바꿔 칩니다.
확인: 아티팩트·HTML 없이 글로만 답한다. "운동화에 몰래 붙은 스티커 = 쿠키", "헨젤과 그레텔 빵가루" 비유가 나온다.
9단계. README에서 지원 청중 카테고리를 읽는다
확인: 연령대(5살·10살·15살 등), 학력 수준(grade levels), 직무(매니저·엔지니어·디자이너·PM), 관계(아내·남편·아이들·친구들) 카테고리가 보인다.
10단계. 두 번째 스킬의 SKILL.md를 연다
4단계와 같은 방법으로 찾습니다. 6단계에서 직접 복사해 넣었다면 ~/.claude/skills/스킬폴더이름/SKILL.md
확인: 마켓플레이스 버전보다 길고, description에 언제 발동되는지·청중 타입·자동 발동 환경("내 아내한테 설명", "내 상사한테 설명" 같은 자연어)이 정의돼 있다.
11단계. 연령·직무 정의를 읽고 기준이 어떻게 나뉘었는지 본다
SKILL.md 안의 age 5 / age 10 / jobs 정의 부분입니다.
확인: age 5 = "super simple words", 장난감·동물·사탕 같은 재밌는 단어 / age 10 = 초등학교 수준, 기본적인 원인·결과, 학교·스포츠·비디오 게임 용어 / 엔지니어 = 동작 방식·아키텍처 구조·트레이드오프 위주.
12단계. 프런트매터에 argument-hint를 추가한다
프런트매터는 SKILL.md 맨 위 --- 두 줄 사이에 있는 설정 칸입니다. 지금은 namedescription 값만 있습니다. 여기에 argument-hint(슬래시 명령을 칠 때 무엇을 적으면 되는지 보여 주는 안내문) 한 줄을 넣습니다. 아래는 이 스킬에 맞춘 예시입니다.
---
name: eli5
description: (원래 있던 설명 그대로)
argument-hint: [주제] [대상 청중(예: 5살, 엔지니어, 상사)]
---
플러그인 폴더 안의 파일을 직접 고치면 플러그인을 업데이트할 때 덮어써질 수 있습니다. 고칠 스킬은 폴더째 ~/.claude/skills/my-eli5/namemy-eli5/reload-skills
확인: 클로드 코드에서 슬래시 명령어를 칠 때 스킬 이름 옆에 주제·대상 청중 같은 호출 방법이 미리 보기로 뜬다.
13단계. 모델의 자동 호출을 끄는 옵션을 true로 설정한다
같은 프런트매터에 disable-model-invocation(클로드가 문맥을 보고 스킬을 알아서 부르지 못하게 막는 설정) 한 줄을 추가합니다.
---
name: my-eli5
description: (원래 있던 설명 그대로)
argument-hint: [주제] [대상 청중(예: 5살, 엔지니어, 상사)]
disable-model-invocation: true
---
이미 불러온 스킬 폴더의 SKILL.md를 고친 것은 저장하면 바로 반영됩니다. 반영이 안 된 것 같으면 /reload-skills
확인: 스킬을 명시적으로 부를 때만 호출되고, 문맥 추론에 의한 자동 호출이 일어나지 않는다.
스킬을 공부하는 법 1, 직접 여러 번 써 본다
같은 질문을 넣어 보고, 설명 대상을 바꿔 보고, 실제로 하던 일에도 써 봅니다. 그러면 "팀원에게 업무 흐름 설명할 때 써도 되겠다", "개발자용 설명을 기획자에게 전달할 때 써 볼까" 같은 아이디어가 생깁니다.
도움이 되면 계속 쓰고, 별로면 뺍니다. 유명한 스킬이어도 내가 안 쓰면 갖고 있을 이유가 없습니다. 빼는 방법은 간단합니다. /pluginclaude plugin uninstall 플러그인이름@마켓플레이스이름), 직접 넣은 스킬이면 ~/.claude/skills/ 안의 그 폴더를 지웁니다.
몇 번 해 봐야 눈이 생깁니다. 그대로 써도 되는 것, 고쳐야 하는 것, 필요 없는 것을 가르는 눈 말입니다. 처음엔 결과가 보기 좋다는 것만 보이지만, 쓰다 보면 "설명은 쉬운데 중요한 조건이 빠졌네" 같은 것도 보입니다.
스킬을 공부하는 법 2, SKILL.md를 뜯어 본다
두 번째 스킬의 SKILL.md
클로드 코드를 제대로 쓰고 내게 맞는 스킬을 설계하고 싶다면, 잘 만든 스킬이 기준을 어떻게 나눴는지 자세히 봐야 합니다. 인기 있는 스킬의 구조를 알아 두면 나중에 내 스킬을 만들 때 도움이 되고, 필요한 부분만 조금씩 바꿔 쓸 수도 있습니다.
직접 뜯어볼 때 클로드 코드에 이렇게 시키면 빠릅니다.
~/.claude/skills 안에 있는 eli5 스킬 두 개의 SKILL.md를 읽고,
description, 청중 정의, 출력 형식이 어떻게 다른지 표로 비교해 줘.
내가 사내 보고용으로 고쳐 쓰려면 어느 줄을 바꾸면 되는지도 알려 줘.
SKILL.md에서 고칠 두 가지
argument-hint. 슬래시 명령어를 칠 때 지금은 스킬 이름만 보입니다. 힌트를 주면 주제와 대상 청중 등 호출 방법이 미리 보기로 보입니다. 광고 질문을 자연어로만 넣고 청중을 적지 않으면 스킬이 덜 정확하게 발동됩니다. README를 안 읽은 사람도 원작자 의도대로 부를 수 있게 하려면 힌트가 낫습니다.
모델 자동 호출 끄기. 스킬을 설치하면 명시적으로 부르지 않아도 클로드가 문맥을 추론해 자동으로 부를 수 있습니다. 스킬이 많이 깔리면 원치 않는 스킬이 문맥상 호출돼 답변 품질이 이상해질 수 있습니다. 전문적인 답을 원했는데 갑자기 쿠키 얘기가 나오는 식입니다. 원작자에게도 의도가 있었겠지만, 명시적으로 부를 때만 호출되게 바꿔 두는 편이 결과를 예측하기 쉽습니다.
ELI5 스킬 다음에 해 볼 것
- 오늘 본 스킬부터 궁금한 주제로 써 볼 것. 괜찮으면 실제 업무에 적용하고, 아쉬운 부분은 지시문을 열어 바꿔 볼 것.
- 다른 저장소에도 같은 계열 스킬이 꽤 있으니 직접 설치·테스트하고 구조를 확인해 볼 것.
- 컨텍스트 처리, 스킬 적용 방식, 옵션 같은 세부는 SKILL.md를 비교하면서 하나씩 익힐 것.
두 스킬의 차이는 SKILL.md 몇 줄
두 스킬의 차이는 결국 SKILL.md 몇 줄의 차이였습니다. 하나는 /artifact
자주 묻는 질문
클로드 코드 스킬은 어디에 설치되나요?
직접 넣는 개인 스킬은 홈 폴더의 ~/.claude/skills/스킬이름/SKILL.md.claude/skills//plugin~/.claude/plugins 아래에 들어갑니다. 어느 쪽이든 클로드 코드에서 /skills
ELI5 스킬은 무엇을 해 주나요?
어려운 주제를 다섯 살에게 설명하듯 쉬운 말과 비유로 풀어 주는 스킬입니다. 마켓플레이스 버전은 그림이 들어간 HTML 페이지를 만들었고, 저장소 버전은 글과 비유로만 설명했습니다. 저장소 버전은 연령, 직무, 관계별로 설명 수준을 바꾸는 옵션이 있습니다.
스킬이 멋대로 호출되지 않게 하려면 어떻게 하나요?
SKILL.md 맨 위 프런트매터에 disable-model-invocation: true 한 줄을 넣습니다. 그러면 /스킬이름/reload-skills
이름이 같은 스킬 두 개를 같이 깔아도 되나요?
됩니다. 플러그인으로 설치한 쪽은 슬래시 명령 목록에서 /플러그인이름:eli5
이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.
원본 영상 보러가기 ↗