클로드 코드 스킬 설치와 수정법, 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개라서 슬래시 명령 목록에 저장소 이름이 앞에 붙어 구분되고, 방금 설치한 것이 맨 위에 있습니다.

결과는 아티팩트 없이 비유로

이 스킬은 시각화가 아니라 설명을 간결하고 쉽게 하는 쪽이라 아티팩트나 HTML을 만들지 않습니다. 대신 이런 비유가 나왔습니다.

• 운동화에 몰래 붙은 스티커 = 쿠키.
• 헨젤과 그레텔이 빵가루를 떨어뜨리며 걸어간 이야기. 인터넷을 돌아다닐 때도 비슷한 일이 일어난다.
• 쇼핑 앱에서 운동화를 구경하면 앱이 "이 사람 운동화 봤음"이라는 작은 메모지를 내 폰에 붙인다.
• 광고 회사들은 여러 앱과 손을 잡고 있어서, 다른 앱을 켜도 "이 폰에 운동화 스티커가 있네, 운동화 광고를 보여 줘야지" 하고 알아챈다.

README에 있는 청중 옵션

개발자나 광고업계 종사자처럼 비유보다 한 단계 올라간 설명을 원하는 사람을 위해 이 스킬은 여러 옵션을 둡니다. README에 지원 청중 카테고리가 정리돼 있습니다.

• 연령대(age range): 5살, 10살, 15살 등. 자막에는 "4살 이상"까지만 잡혀 나머지 구간은 확인하지 못했습니다. "왜 이렇게 나눴는지는 잘 모르겠다"는 말이 덧붙습니다.
• 학력 수준(grade levels)
• 직무(jobs): 매니저, 엔지니어, 디자이너, PM
• 관계: 아내, 남편, 아이들, 친구들

클로드 코드 스킬 설치부터 수정까지 13단계

아래는 영상에서 수행한 동작을 순서대로 옮기고, 영상이 화면으로만 보여 주고 넘어간 명령과 경로를 채운 것입니다. 저장소 주소는 영상에서 읽지 않아 특정하지 않았습니다. 대신 어떤 저장소든 똑같이 쓰는 명령 형식을 적었습니다.

준비물

• 클로드 유료 요금제 계정. 클로드 코드는 유료 요금제나 API 결제가 있어야 쓸 수 있고, 요금은 바뀌므로 공식 안내를 확인해야 합니다.
• 클로드 코드(Claude Code)가 설치돼 실행되는 상태
• 스킬: ELI5 계열 스킬 두 개(마켓플레이스 버전, GitHub 저장소 버전)
• 비용·소요 시간: 영상에서 언급하지 않습니다

클로드 코드를 아직 안 깔았다면 이렇게 합니다.

1. 맥은 Command + 스페이스로 Spotlight를 열고 "터미널"을 쳐서 엽니다. 윈도우는 시작 메뉴에서 "PowerShell"을 엽니다.
2. 맥 터미널에 아래 명령을 붙여 넣고 엔터를 누릅니다.

curl -fsSL https://claude.ai/install.sh | bash

3. 설치가 끝나면 작업할 폴더에서 claude를 치고 엔터를 누릅니다.
4. 처음 실행하면 브라우저가 열리며 로그인하라고 나옵니다. 클로드 계정으로 로그인합니다.

윈도우 설치 명령은 공식 문서(docs.claude.com의 Claude Code 설치 안내)에 따로 있으니 그쪽을 따릅니다.

1단계. 스킬 없이 타게팅 광고 질문을 넣는다

클로드 코드 입력창에 질문을 입력합니다. 화면 문구는 판독하지 못해 발화 기준으로 재구성했습니다.

쇼핑몰에서 운동화를 한 번 봤는데 다른 앱을 켰더니 운동화 광고가 또 나온다.
다른 앱은 내가 뭘 봤는지 어떻게 아는 걸까?

확인: "리타게팅 광고 시스템", "광고 식별자", 안드로이드·아이폰별 명칭 같은 전문용어가 섞인 글 답변이 나온다.

2단계. 마켓플레이스에서 첫 번째 스킬을 설치한다

클로드 코드 입력창에 아래를 치고 엔터를 누르면 플러그인 관리 화면이 열립니다.

/plugin

1. 방향키로 Discover(찾아보기) 탭으로 갑니다.
2. 검색에 eli5를 입력합니다.
3. 원하는 항목에서 엔터를 누르고 설치를 고릅니다.

찾는 스킬이 기본 마켓플레이스에 없고 다른 사람이 만든 마켓플레이스에 있다면, 그 마켓플레이스를 먼저 등록한 뒤 설치합니다. 형식은 이렇습니다.

/plugin marketplace add GitHub사용자이름/저장소이름
/plugin install 플러그인이름@마켓플레이스이름

확인: /를 쳤을 때 목록에 스킬 이름이 보인다. 안 보이면 클로드 코드를 한 번 껐다 켭니다.

3단계. 1단계와 똑같은 질문을 다시 넣는다

확인: "신발이 왜 나를 따라오는지 그림 다섯 개로 설명하는 페이지를 만들었다"는 답과 함께 HTML 아티팩트(도식+그림)가 열린다.

4단계. 첫 번째 스킬의 SKILL.md를 연다

영상은 파일 경로를 말하지 않습니다. 플러그인으로 설치한 스킬은 내 홈 폴더의 .claude/plugins 아래에 들어갑니다. 위치를 모르겠으면 맥 터미널에서 이렇게 찾습니다.

find ~/.claude -name SKILL.md | grep -i eli5

나온 경로를 텍스트 편집기로 엽니다. 맥이라면 open -e 경로로 텍스트 편집기에서 열립니다. 클로드 코드 안에서 "eli5 스킬의 SKILL.md 내용을 보여 줘"라고 시켜도 됩니다.

확인: 아주 짧은 파일이고, description에 "내가 다섯 살인 걸로 간주하고 설명해라. HTML 아티팩트를 써서 큰 그림과 단어를 거의 쓰지 않고 설명을 만들어라"는 취지의 지시가 있다.

5단계. 두 번째 스킬 저장소의 README에서 Installation 절을 읽는다

GitHub 저장소 첫 화면을 아래로 내리면 README가 보입니다. 그 안의 Installation 제목을 찾습니다.

확인: 설치 방법이 적혀 있다.

6단계. Installation에 적힌 대로 설치한다

README에 적힌 명령을 그대로 복사해 씁니다. 저장소가 마켓플레이스 형식이면 2단계의 /plugin marketplace add 방식을 씁니다. 스킬 폴더만 있는 저장소라면 그 폴더를 통째로 내 스킬 폴더에 넣으면 됩니다. 예시는 이렇습니다.

git clone https://github.com/GitHub사용자이름/저장소이름.git
mkdir -p ~/.claude/skills
cp -r 저장소이름/스킬폴더이름 ~/.claude/skills/

~/.claude/skills/에 넣은 스킬은 모든 프로젝트에서 쓰입니다. 특정 프로젝트에서만 쓰려면 그 프로젝트 폴더 안의 .claude/skills/에 넣습니다.

확인: 슬래시 명령 목록에 같은 이름의 스킬이 2개 보이고, 앞에 저장소 이름이 붙어 구분된다. 방금 설치한 것이 맨 위에 있다.

7단계. 세션을 비운다

이전 대화가 다음 답에 영향을 주지 않게 대화 기록을 지웁니다. 입력창에 이렇게 칩니다.

/clear

확인: 이전 대화가 없는 상태에서 새 질문을 할 수 있다.

8단계. 같은 모델로 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 맨 위 --- 두 줄 사이에 있는 설정 칸입니다. 지금은 name과 description 값만 있습니다. 여기에 argument-hint(슬래시 명령을 칠 때 무엇을 적으면 되는지 보여 주는 안내문) 한 줄을 넣습니다. 영상은 실제로 넣은 값을 읽지 않았으니, 아래는 이 스킬에 맞춰 만든 예시입니다.

---
name: eli5
description: (원래 있던 설명 그대로)
argument-hint: [주제] [대상 청중(예: 5살, 엔지니어, 상사)]
---

플러그인 폴더 안의 파일을 직접 고치면 플러그인을 업데이트할 때 덮어써질 수 있습니다. 고칠 스킬은 폴더째 ~/.claude/skills/로 복사하고 name을 my-eli5처럼 바꿔 내 것으로 따로 두는 편이 안전합니다.

확인: 클로드 코드에서 슬래시 명령어를 칠 때 스킬 이름 옆에 주제·대상 청중 같은 호출 방법이 미리 보기로 뜬다.

13단계. 모델의 자동 호출을 끄는 옵션을 true로 설정한다

같은 프런트매터에 disable-model-invocation(클로드가 문맥을 보고 스킬을 알아서 부르지 못하게 막는 설정) 한 줄을 추가합니다.

---
name: my-eli5
description: (원래 있던 설명 그대로)
argument-hint: [주제] [대상 청중(예: 5살, 엔지니어, 상사)]
disable-model-invocation: true
---

저장한 뒤 클로드 코드를 다시 시작하면 반영됩니다.

확인: 스킬을 명시적으로 부를 때만 호출되고, 문맥 추론에 의한 자동 호출이 일어나지 않는다.

스킬을 공부하는 법 1, 직접 여러 번 써 본다

같은 질문을 넣어 보고, 설명 대상을 바꿔 보고, 실제로 하던 일에도 써 봅니다. 그러면 "팀원에게 업무 흐름 설명할 때 써도 되겠다", "개발자용 설명을 기획자에게 전달할 때 써 볼까" 같은 아이디어가 생긴다는 것이 화자의 경험입니다.

도움이 되면 계속 쓰고, 별로면 뺍니다. 유명한 스킬이어도 내가 안 쓰면 갖고 있을 이유가 없습니다. 빼는 방법은 간단합니다. /plugin에서 해당 플러그인을 골라 제거하거나, 직접 넣은 스킬이면 ~/.claude/skills/ 안의 그 폴더를 지웁니다.

몇 번 해 봐야 눈이 생깁니다. 그대로 써도 되는 것, 고쳐야 하는 것, 필요 없는 것을 가르는 눈 말입니다. 처음엔 결과가 보기 좋다는 것만 보이지만, 쓰다 보면 "설명은 쉬운데 중요한 조건이 빠졌네" 같은 것도 보입니다.

스킬을 공부하는 법 2, SKILL.md를 뜯어 본다

두 번째 스킬의 SKILL.md에는 마켓플레이스 버전보다 훨씬 자세한 설명이 있습니다. description에 언제 발동되는지, 청중 타입, 자동 발동 환경이 정의돼 있고, "내 아내한테 설명", "내 상사한테 설명" 같은 자연어에도 스킬이 잡히게 써 놨습니다.

클로드 코드를 제대로 쓰고 내게 맞는 스킬을 설계하고 싶다면, 이런 사람들이 기준을 어떻게 나눴는지 자세히 봐야 한다는 게 화자의 말입니다. 인기 있는 스킬의 구조를 알아 두면 나중에 내 스킬을 만들 때 도움이 되고, 필요한 부분만 조금씩 바꿔 쓸 수도 있습니다.

직접 뜯어볼 때 클로드 코드에 이렇게 시키면 빠릅니다.

~/.claude/skills 안에 있는 eli5 스킬 두 개의 SKILL.md를 읽고,
description, 청중 정의, 출력 형식이 어떻게 다른지 표로 비교해 줘.
내가 사내 보고용으로 고쳐 쓰려면 어느 줄을 바꾸면 되는지도 알려 줘.

SKILL.md에서 고칠 두 가지

argument-hint. 슬래시 명령어를 칠 때 지금은 스킬 이름만 보입니다. 힌트를 주면 주제와 대상 청중 등 호출 방법이 미리 보기로 보입니다. 영상에서는 자연어로 광고 질문만 하고 청중을 명시하지 않았는데, 명시했으면 스킬이 더 잘 발동됐을 겁니다. README를 안 읽은 사람도 원작자 의도대로 부를 수 있게 하려면 힌트가 낫습니다.

모델 자동 호출 끄기. 스킬을 설치하면 명시적으로 부르지 않아도 클로드가 문맥을 추론해 자동으로 부를 수 있습니다. 스킬이 많이 깔리면 원치 않는 스킬이 문맥상 호출돼 답변 품질이 이상해질 수 있습니다. 전문적인 답을 원했는데 갑자기 쿠키 얘기가 나오는 식입니다. 원작자 의도는 있겠지만 화자는 무조건 명시적으로 부를 때만 호출되게 만들겠다고 합니다.

ELI5 스킬 다음에 해 볼 것

• 오늘 본 스킬부터 궁금한 주제로 써 볼 것. 괜찮으면 실제 업무에 적용하고, 아쉬운 부분은 지시문을 열어 바꿔 볼 것.
• 다른 저장소에도 같은 계열 스킬이 꽤 있으니 직접 설치·테스트하고 구조를 확인해 볼 것.
• 영상은 컨텍스트 처리, 스킬 적용 방식, 옵션 같은 세부를 화자의 유료 강의("클로드 코드의 정석")로 돌리며 고정 댓글을 안내합니다. 홍보 발언입니다.

두 스킬의 차이는 SKILL.md 몇 줄

두 스킬의 차이는 결국 SKILL.md 몇 줄의 차이였습니다. 하나는 /artifact에 "쉽게"를 얹은 얇은 지시, 다른 하나는 청중별 정의를 촘촘히 적은 긴 지시. 어느 쪽이 낫다기보다, 영상이 보여 준 건 "결과를 보고, 파일을 열고, 내 취향대로 두 줄 고치는" 순서 자체였습니다.

이 글은 자동 자막을 근거로 정리했고 영상 화면과는 대조하지 못했습니다(실용주의 개발, 16분 33초 영상). 설치 명령, 파일 경로, 프런트매터 예시는 영상에서 읽지 않은 부분을 편집자가 일반적인 클로드 코드 사용법으로 채운 것이며, 스킬 이름은 자막에 "L", "리 5", "L5", 리타게팅은 "위타게팅", 스타는 "기업 스타", 자동 호출 옵션은 "disable 모델케이션"과 값 "트로"로 잡혀 있었습니다.

출처: youtu.be/…