AI/Skills

Claude Code ELI5 스킬 이란? : Anthropic에서 쓰던 화제의 ELI5 스킬(ELI5 설치 및 사용해보기)

안녕하세요! 갓대희 입니다.

이번 포스팅은 [ Claude Code ELI5 스킬 튜토리얼 ] 입니다. : )

2026년 8월 21일(UTC), Claude Code 팀의 Thariq Shihipar가 X에 짧은 스킬 하나를 올렸다. 이름은 ELI5다.

작성자 안내처럼 /eli5 뒤에 알고 싶은 주제를 붙여 쓸 수 있다. 플러그인 이름까지 붙인 정식 호출명은 /eli5:eli5다.

반응은 꽤 빠르게 퍼졌다. 한국어권에도 곧바로 번역 소개가 올라왔고, “공식 플러그인으로 넣을지 고민 중인데 일단 커뮤니티에 올려 뒀다”는 내용도 함께 공유됐다. 작성자가 예로 든 용도는 모듈의 동작 방식, 특정 설계를 선택한 이유, 장애 원인처럼 개발자가 자주 설명해야 하는 주제들이다.

이번 글은 소개만 하고 끝내지 않는다. 설치부터 실제 호출까지 따라 해보고, README의 DNS 예시를 실행한 뒤, 마지막에는 ELI5에게 ELI5 스킬 자체를 설명시키는 메타 실험까지 해보는 흐름으로 구성했다. 다만 지금 단계의 글은 아직 내 계정에서 직접 검증하기 전 초안이다. 실제 결과가 확인되기 전까지는 성공했다고 단정하지 않고 각 단계에 검증 항목을 남겨 둔다.

이 글은 2026년 8월 24일을 기준으로 작성했다. 주요 출처는 anthropics/claude-plugins-community eli5, Thariq 원문 게시, Claude Code 공식 문서의 Plugins / Skills / Artifacts다. 플러그인 버전·공식/커뮤니티 여부·X 수치는 시점에 따라 바뀐다.

이 글의 핵심

ELI5는 지금 공식 플러그인이 아니다. Anthropic 직원이 커뮤니티 마켓에 올린 스킬이고, 작성자도 공식화 여부를 고민 중이라고 밝혔다.
실체는 MCP나 실행 스크립트가 붙은 복잡한 도구가 아니라 10줄짜리 SKILL.md다. 새로운 모델 능력을 더하는 대신, 누구에게 어떤 형식으로 설명할지를 고정한다.
설치는 커뮤니티 마켓 추가 → eli5@claude-community 설치 순이다. 설치 요약이 활성화를 요구할 때만 /reload-plugins를 실행한다.
이번 튜토리얼의 핵심 실습은 /eli5로 ELI5 스킬 자체를 설명시키는 메타 실험이다.
HTML 결과물을 Claude의 Artifact로 게시할 수 있는지는 플랜·로그인 방식·CLI 버전에 따라 달라진다. 게시가 안 되더라도 로컬 HTML은 남을 수 있다. 그리고 결과가 그림으로 잘 나왔다고 해서 그 내용까지 자동으로 정확해지는 것은 아니다.

먼저 팩트체크할 부분

“Anthropic 사람들이 쓰는 스킬”을 Anthropic 공식 플러그인으로 읽으면 안 된다. 원문 표현은 “a skill people at Anthropic have been using a lot recently”이고, 바로 다음 게시에서 공식 플러그인으로 넣을지 고민 중이며 지금은 커뮤니티에 설치하라고 안내한다. GitHub에 있는 다른 eli5 스킬과도 별개다. 이번 글의 대상은 eli5@claude-community, 작성자 Thariq Shihipar다.

작성자 원문

Thariq Shihipar(@trq212), 2026-08-21 19:32:50 GMT. 같은 스레드에서 설치 명령과 사용 예시를 이어서 올렸다.

→ X 원문 바로가기

1. 왜 지금 이 스킬인가

이번에 ELI5라는 스킬이 주목받은 건 이 익숙한 요청을 Claude Code 스킬로 만들어 두고, 답변 형식까지 큰 그림과 짧은 설명 중심의 HTML Artifact로 고정했다는 점이다.

Thariq의 원문 핵심은 이 한 줄이다.

explain like I'm someone who knows nothing about this topic,
using a HTML artifact with big pictures and few words

같은 스레드에서 본인이 즐겨 쓰는 예시를 세 개 적었다.

/eli5 how does this module work
/eli5 why did we make this tradeoff
/eli5 what caused this incident

개발자라면 이 세 줄이 왜 주목받는지 바로 감이 올 것 같다.

코드를 대신 작성해주는 기능이 아니라, 복잡한 코드베이스와 설계 의도, 장애가 발생한 맥락을 처음 보는 사람도 이해할 수 있게 시각 자료로 다시 풀어주는 스킬이기 때문이다.

실무에서는 코드를 작성하는 것만큼 “왜 이렇게 만들었는지”, “어디서 문제가 났는지”를 다른 사람에게 설명할 일이 많다. 신규 입사자 온보딩부터 코드 리뷰, 장애 회고(Postmortem)처럼 지식을 공유하고 설명해야 하는 상황에서 꽤 유용하게 쓸 수 있어 보인다.

개발자 본인에게도 마찬가지다. 처음 보는 모듈이나 복잡한 장애를 코드부터 파고들기보다 그림으로 전체 흐름을 먼저 잡고 들어가면 이해하기가 훨씬 수월하다.

원문 게시

2026-08-21 19:32:50 GMT, @trq212

이 글 확인 시점

게시 직후 여러 언어권에서 설치 명령과 활용 예시가 재공유됐다. 반응 수치는 계속 변하므로 본문 판단 근거에서는 제외했다.

배포 위치

anthropics/claude-plugins-community, 플러그인 이름 eli5

한국어권에서는 @Krongggggg님이 원문을 거의 그대로 옮겨 “완전 초보한테 설명하듯이 큰 그림 넣고 글은 거의 없는 HTML로 쭉 뽑아줌”이라고 소개했다. 영어권에서 다시 공유된 글들도 비슷했다. 모듈 동작, 설계 선택의 이유, 장애 원인이라는 세 가지 활용 예가 반복해서 언급됐다.

커뮤니티 반응은 어디까지나 참고로 보고, 실제 동작은 저장소의 SKILL.md와 공식 문서를 기준으로 확인해 보자.

한 줄 정리: ELI5의 핵심은 단순히 말을 쉽게 바꾸는 데 있지 않다. 누구에게 설명할지와 어떤 형식으로 보여줄지를 슬래시 명령 하나에 고정해 둔 것에 가깝다.

2. 공식 플러그인인가? 동명 스킬과 구별

공식 마켓과 커뮤니티 마켓

Claude Code 플러그인은 마켓플레이스에서 설치한다.

공식 문서를 보면 공식 마켓 claude-plugins-official은 대화형 첫 실행 때 자동으로 붙을 수 있다.

커뮤니티 마켓은 기본값이 아니다. 직접 추가해야 한다.

구분	공식 마켓	커뮤니티 마켓 (eli5가 있는 곳)
저장소	anthropics/claude-plugins-official	anthropics/claude-plugins-community
마켓 이름	claude-plugins-official	claude-community
기본 추가	대화형 첫 실행 때 자동 추가될 수 있음	수동 추가
설치 suffix	@claude-plugins-official	@claude-community
eli5 위치 (2026-08-24)	공식 플러그인으로 안내되지 않음	등록됨. source `./eli5`, category learning

2026년 8월 24일 기준 공식 설치 문서에서는 저장소를 anthropics/claude-plugins-community, 설치할 때 쓰는 Marketplace 이름을 claude-community로 안내한다. 카탈로그의 전체 플러그인 수처럼 수시로 바뀌는 숫자는 ELI5 자체의 품질이나 신뢰도를 판단하는 데 큰 의미가 없어 본문에서는 제외했다.

공식 Discover Plugins 문서를 보면 Community Marketplace의 서드파티 플러그인은 등록 과정에서 자동 검증(automated validation)과 안전성 검사(safety screening)를 거치고, 카탈로그에는 특정 commit SHA로 고정된다. 그렇다고 first-party 공식 플러그인이 되는 것은 아니다. 같은 문서에서 Plugin과 Marketplace가 사용자 권한으로 코드를 실행할 수 있으니 신뢰할 수 있는 소스만 추가하라고 경고한다.

즉 검사 절차가 있다는 점과, 사용자가 소스를 직접 신뢰해야 한다는 점을 같이 봐야 한다.

plugin.json

name eli5 / version 1.0.0 / author Thariq Shihipar / license MIT / 사용법 /eli5 <topic>

Thariq의 후속 게시 원문이다.

debating whether we should make it an official plugin, but
you can try installing it here to try with these commands:

claude plugin marketplace add anthropics/claude-plugins-community
claude plugin install eli5@claude-community

이름만 같은 다른 스킬

GitHub에서 “eli5 claude skill”을 검색해 보면 이름이 같은 다른 프로젝트도 나온다. 예를 들어 DreambigOu/ELI5는 아이·매니저·엔지니어처럼 청자별로 말투를 바꾸는 별개 스킬이다. HTML 그림 explainer가 목적이 아니다.

구별 방법은 단순하다. 설치 식별자가 eli5@claude-community인지, manifest 작성자가 Thariq Shihipar인지 보면 된다.

한 줄 정리: Anthropic 직원이 만든 스킬이고 Anthropic이 운영하는 커뮤니티 저장소에서 배포되지만, 현재 기준 first-party 공식 플러그인은 아니다.

3. 이렇게 짧은 스킬이 왜 잘 먹히나

코드만 보면 의외로 단순하다.

이 스킬이 Claude에 없던 새로운 기능을 추가하는 것은 아니다. 공개된 파일을 보면 핵심은 plugin.json, README.md, skills/eli5/SKILL.md이고, 별도의 MCP 서버나 실행 스크립트도 없다.

2026년 8월 24일에 GitHub raw를 받아 세어 보면 SKILL.md는 10줄, 321바이트다. 전문은 아래와 같다.

---
name: eli5
description: Explain a topic like I'm a 5 year old. Use when the user types /eli5 <topic> or asks for a dead-simple picture explainer of how something works.
---

# eli5

Explain like I'm someone who knows nothing about this topic, using a HTML artifact with big pictures and few words.

Topic: $ARGUMENTS

이 스킬이 실제로 정해 두는 것은 크게 두 가지다.

축	스킬이 강제하는 것	그냥 물어보면 흔들리지 쉬운 것
청자 수준	이 주제를 전혀 모르는 사람	질문한 사람이 이미 안다고 가정한 문장
출력 형식	큰 그림, 적은 글의 HTML artifact	어떤 날은 긴 문단, 어떤 날은 표, 어떤 날은 불릿

이름과 본문의 의도적 차이

이름과 description은 “5 year old”를 쓴다.

그런데 모델이 실제로 따르는 본문은 “someone who knows nothing about this topic”이다. PR diff에는 공개 전 문구를 더 중립적인 청자 표현과 “HTML artifact”로 다듬은 흔적도 남아 있다.

이 차이는 꽤 중요하다.

이름은 익숙한 ELI5 표현을 쓰지만, 실제 지시는 유아처럼 말하라는 뜻보다는 배경지식이 없는 사람도 이해할 수 있게 큰 시각 요소와 짧은 설명으로 풀어 달라는 쪽에 가깝다. 따라서 어린아이용 어휘를 강제하는 스킬이라기보다, 처음 보는 사람을 위한 시각 설명 형식으로 이해하는 편이 정확하다.

호출되면 무슨 일이 일어나는가

공식 Skills 문서를 보면 일반 세션에서는 description이 컨텍스트에 남아 있고, 실제 SKILL.md 본문은 스킬이 호출될 때 로드된다. 한 번 불러온 내용은 이후 대화 컨텍스트에도 포함된다. $ARGUMENTS는 Skill 이름 뒤에 붙인 문자열이다.

그래서 흐름은 대략 이렇게 보면 된다.

사용자가 /eli5 how does DNS work 또는 /eli5:eli5 how does DNS work를 친다.
SKILL.md 본문이 로드되고 Topic: how does DNS work가 된다.
Claude는 현재 대화·프로젝트 파일을 읽은 뒤, 문단 답 대신 HTML explainer를 만든다.
환경이 되면 그 HTML을 artifact로 발행하고, 안 되면 로컬 HTML 파일로 남긴다.

참고

플러그인 스킬의 정식 호출 규칙은 /플러그인명:스킬명이다. 따라서 이 플러그인은 /eli5:eli5가 정식 이름이다. 최신 Skills 문서는 충돌하는 명령이 없으면 짧은 호출명인 /eli5도 호출된다고 설명하고, README와 작성자 안내도 짧은 호출명을 사용한다. 설치 후 두 이름을 모두 확인하는 단계를 넣어 두었다.

X에서도 “이 정도 문구라면 마켓 없이 그냥 붙여 넣어도 되는 것 아닌가?”라는 질문이 나왔다.

실제로 핵심 문구만 일반 프롬프트로 붙여 넣어도 비슷한 결과를 시도할 수 있다.

차이는 매번 다시 쓰던 지시를 스킬로 저장해 두고, 슬래시 명령으로 반복해서 호출하거나 팀과 공유할 수 있느냐에 있다.

한 줄 정리: ELI5가 짧은 지시만으로 동작하는 이유는 Claude에 새로운 능력을 추가해서가 아니다. 설명 대상의 눈높이와 출력 형식을 매번 같은 방식으로 지정해 주기 때문이다.

4. 준비물

이 글에서는 Claude Code 기준으로 진행한다.

Cowork의 경우 커뮤니티 README가 claude.com/plugins 설치를 안내한다. 화면이 다르므로 이 글의 명령은 CLI/슬래시 기준으로 적는다.

항목	필요한 이유	확인 방법
Claude Code	플러그인 마켓과 `/eli5` 슬래시 명령	{{VERIFY_CLI_VERSION}} / artifact 발행은 공식 문서 기준 CLI 2.1.183+
claude.ai 로그인 세션	Claude Code artifact를 private URL로 발행하려면 `/login`된 claude.ai 계정이 필요하다. API 키·게이트웨이·클라우드 자격 증명 세션은 발행 불가다.	{{VERIFY_LOGIN_SURFACE}}
플랜	공식 Artifacts 문서 기준 Pro / Max / Team / Enterprise. 조건을 못 맞추면 로컬 HTML로 떨어진다.	{{VERIFY_PLAN}}
네트워크/GitHub 접근	커뮤니티 마켓 클론/설치	회사 프록시·마켓 정책에 막힐 수 있음
실습용 프로젝트 폴더	HTML 파일이 프로젝트에 쓰일 수 있다. 비밀이 없는 저장소로 시작하는 편이 안전하다.	개인 테스트 repo 권장

비용 구조는 별도로 복잡하지 않다. plugin.json에는 별도 가격이 없고 라이선스는 MIT다.

5. 실제로 따라해보기

지금부터는 실제로 따라 해볼 차례다. 다만 아직 실행 전 초안이므로 결과를 미리 성공으로 적지 않는다. 각 단계에서 무엇이 나와야 하는지 먼저 정리하고, 직접 실행한 화면과 비교해 가며 채워 넣는다.

실습 순서

커뮤니티 마켓 추가
eli5 설치
plugin list로 설치 확인
세션 재로드 후 /eli5 노출 확인
README 예시: DNS
메타 실험: ELI5에게 ELI5 설명시키기
같은 질문을 스킬 없이 비교

1단계. 커뮤니티 마켓 추가

Claude Code 세션에서 플러그인을 추가해주자.

/plugin marketplace add anthropics/claude-plugins-community

ex) claude code 세션에서 /plugin marketplace add anthropics/claude-plugins-community 실행

- 결과

2단계. eli5 설치

/plugin install eli5@claude-community

ex) /plugin install eli5@claude-community

- 전역으로, user scope으로 설치하였다.

Plugin is now active.라면 재로드를 생략해도 된다.

Run /reload-plugins to activate.라면 안내대로 실행해주다.

식별자가 eli5@claude-community가 아니면 설치 대상을 다시 확인하자.

3단계. plugin list로 설치 확인

/plugin list

ex) /plugin list

소스 manifest 버전은 1.0.0이다.

4단계. 세션 reload 후 /eli5가 보이는지

공식 문서는 설치 요약이 요구할 때만 /reload-plugins를 쓰라고 한다.

캐시 경고가 있으면 /reload-plugins --force다.

Claude Code v2.1.221 이전에는 같은 세션에서 설치가 바로 적용되지 않았지만, 이후 버전은 설치 과정에서 즉시 활성화될 수 있다. Shell의 claude plugin install은 세션 밖에서 실행되므로 새 세션이나 수동으로 /reload 한이후 보일 것이다.

결론적으로, 슬래시 목록에서 정식 호출명 /eli5:eli5를 확인할 수 있다.

ex)

충돌이 없다면 짧은 호출명 /eli5도 호출된다. 만약 안 보이면 설치 요약과 /plugin의 Errors tab을 먼저 보고, 필요할 때만 새 세션을 연다.

5단계. README 예시로 스모크 테스트

README에 있는 예시를 한번 바로 테스트 해보려고 한다.

/eli5 how does DNS work

ex) 바로 artifact로 만들어주며, url까지 생성하여 준다.

- effort : medium으로 진행 하였다.

채팅 문단만으로 끝나지 않고 HTML 산출물이 생긴다. artifact URL이거나 프로젝트의 .html 파일이다.
큰 도형/단계 그림과 짧은 라벨이 본문보다 앞에 있다.
전문 용어를 이미 안다고 가정한 문장이 적다.

공식 Artifacts 문서에 따르면 Claude는 HTML을 프로젝트에 쓴 뒤 발행 권한을 물을 수 있다.

예를 들어 “Claude wants to publish … to a private page on claude.ai” 같은 확인이다. Yes를 누르면 URL이 인쇄되고 브라우저가 열릴 수 있다. 최근 artifact는 터미널에서 Ctrl+]로 다시 열 수 있다고 문서에 적혀 있다.

조건을 못 맞추면 로컬 HTML만 남는다.

그 경우도 스킬이 “완전히 실패한” 것은 아니다. HTML 결과물은 만들어졌지만 claude.ai에 게시하는 단계만 빠진 경우다.

이때는 스킬 전체가 실패했다고 보기보다 출력은 성공했고 게시만 되지 않은 부분 성공으로 보는 편이 자연스럽다.

ex) effort를 조정하면 더 괜찮지 않을까하여 effort를 medium > high 로 변경후 생성 시도 해보았다.

- 확실히 퀄리티가 다른것 같다.

https://claude.ai/code/artifact/7fef429d-a0a2-4325-a499-3826f494c482

6단계. 메타 실험 — ELI5에게 ELI5를 설명시키기

이 글의 핵심 실습이다. 스킬이 정말 “큰 그림, 적은 글” 형식으로 결과를 유도하는지, 이번에는 ELI5에게 자기 자신을 설명시켜 확인해 본다. 새 세션에서 프로젝트 파일을 읽게 하려면 아래처럼 구체적으로 적는 편이 낫다.

/eli5 eli5 스킬이 뭔지, 파일은 뭐가 들어 있고, 왜 HTML 그림으로 설명하는지 알려줘

한 줄이 약하면 이렇게 나눠도 된다.

/eli5 how the eli5 Claude Code skill works
Read the installed skill files if you can, then explain
plugin vs skill vs HTML artifact in pictures.

ex) 하기 링크에 결과도 있고, 주저리 주저리 쓴 내 글보다 담백하게 오히려 이해하기 좋은것 같기도 했다.

https://claude.ai/code/artifact/e98ee84f-08f3-4838-8ff5-770975f5cb72?via=auto_preview

- Effort : medium에서 진행하였고 2분 정도 소요되었다.

ex) effort를 max로 변경하여 다시 시도해보았다.

- effort가 올라간만큼 오래 걸리기도 하였고, 더 자세히 조사하여 퀄리티가 올라간것을 볼 수 있었다.

https://claude.ai/code/artifact/55056335-3369-4c26-b44d-70b72e27b070?via=auto_preview

짧은 지시만으로 ELI5가 자기 구조와 한계를 얼마나 정확하게 설명하는지를 알 수 있는 실험?이었다.

7단계. 같은 질문을 스킬 없이 비교

새 대화에서 슬래시 없이 아래만 보낸다.

eli5 스킬이 뭔지, 파일은 뭐가 들어 있고, 왜 HTML 그림으로 설명하는지 알려줘

여기서는 정답의 우열보다 답변 형식이 얼마나 달라지는지를 본다.

일반 문단이나 불릿으로 끝나는지, HTML 시각 자료가 만들어지는지, 설명의 눈높이가 어떻게 달라지는지를 나란히 비교하면 된다.

ex) 개인적으로는, 다음과 같이 text로 결과를 보기보다는 아무래도 이전의 시각화된 자료가 훨씬 이해도 잘되고, 눈에 잘 들어오는 것 같다.

다시 한번 정리 하자면, 출력의 형식만 바꿨는데(특별한 프로그램이 아닌 간단한 지시사항을 뿐임에도) 엄청나게 효율성이 올라가기도 한다.

6. 기존 프로젝트에서 활용하는 법과 대체 경로

작성자가 추천한 세 가지 활용 예

DNS처럼 단순한 예제만 돌려 보면 설치 여부는 확인할 수 있지만, 이 스킬이 실무에서 어디에 유용한지는 잘 드러나지 않는다. Thariq가 직접 적은 세 가지 예시를 보면 실제 활용처가 훨씬 선명해진다.

/eli5 how does this module work
/eli5 why did we make this tradeoff
/eli5 what caused this incident

기존 저장소에서 사용할 때는 설명할 대상을 구체적으로 적는 편이 좋다. 스킬 지시 자체가 짧기 때문에 주제가 모호하면 코드베이스와 상관없는 일반적인 그림으로 흘러갈 수 있다.

/eli5 src/auth/middleware.ts 가 요청마다 무엇을 검사하는지
/eli5 왜 세션을 JWT 대신 서버 세션으로 뒀는지
/eli5 지난번 500 장애에서 타임아웃이 어떻게 전파됐는지. 로그 파일도 읽어줘

일본 사용기에서는 주제만 적으면 그림이 빠질 때가 있어, “문장만 쓰지 말고 최소 3개의 SVG 도해를 넣어줘”를 덧붙였다고 한다. 공식 스킬 문구는 아니므로 필요할 때만 쓰는 팁으로 보면 된다.

/eli5 이 결제 모듈의 상태를 설명해줘. 글만 쓰지 말고
최소 3개의 SVG 도해로 요청 → 검증 → 저장 흐름을 보여줘.

프로젝트에 직접 스킬로 넣기

마켓을 추가하기 어렵거나, 팀 저장소에 같은 지시를 넣고 싶다면 공식 Skills 경로를 쓰면 된다. .claude/skills/eli5/SKILL.md 또는 ~/.claude/skills/eli5/SKILL.md에 위 10줄을 그대로 두는 방식이다. 이 경로는 커뮤니티 마켓 등재와 별개다. 자동 업데이트도 없다.

정상 경로가 막혔을 때

상황	정상 경로	대체 방법
마켓 추가 가능	eli5@claude-community 설치	SKILL.md를 개인/프로젝트 skills에 복사
슬래시 명령 사용	/eli5 주제	본문 한 줄을 일반 프롬프트로 붙여 넣기
artifact 발행 가능	claude.ai private URL	프로젝트 로컬 HTML. 공유는 별도
그림이 안 나옴	스킬 기본 지시만	SVG 개수/흐름을 한 줄 더 적기. 커뮤니티 팁

이런 대체 방법을 기본 사용법처럼 볼 필요는 없다.

프롬프트 복붙은 매번 결과가 조금씩 달라질 수 있고, 로컬 HTML은 공유 방식이 다르며, 프로젝트에 직접 복사한 SKILL.md는 원본이 바뀌어도 자동으로 업데이트되지 않는다.

7. 한계, 오류, 보안, 대안

이 스킬이 할 수 없는 한계

SKILL.md에는 인용, 테스트, 코드 수정, 보안 감사 절차가 없다. 그래서 아래 용도에는 맞지 않다.

정확한 스펙·숫자·쿼터 확인
예외 분기와 경계 조건 검증
보안 리뷰, 법률·의료·금융 판단
코드 수정이나 PR 생성

ELI5의 장점은 복잡한 내용을 한눈에 보기 쉽게 만드는 데 있다.

다만 그림이 그럴듯하다고 해서 안의 흐름까지 모두 정확하다는 뜻은 아니다.

전체 구조를 빠르게 이해하는 용도로 쓰고, 세부 사실은 코드와 공식 문서로 다시 확인하는 편이 안전하다.

트러블슈팅

증상	먼저 볼 곳	다음 행동
/eli5가 목록에 없음	plugin list의 Status, 현재 세션	/reload-plugins 또는 새 세션. 그래도 없으면 마켓이 추가됐는지 확인
install 실패 / 플러그인을 못 찾음	마켓 이름과 suffix	community 마켓을 먼저 add 했는지, 식별자가 eli5@claude-community인지
다른 eli5가 깔림	작성자, 설명 문구	Thariq Shihipar / HTML picture explainer가 아니면 제거
HTML은 있는데 그림이 없음	프롬프트가 주제만인지	SVG 개수와 흐름을 한 줄 추가. 그래도 문단이면 모델/출력 스타일 문제일 수 있음
artifact URL이 안 나옴	플랜, /login, CLI 2.1.183+, API 키 세션 여부	로컬 HTML 경로를 찾는다. 발행 불가를 스킬 실패와 구분
버전이 예상과 다름	서드파티 마켓 auto-update	/plugin marketplace update claude-community 후 재확인
사내 코드 그림에 비밀이 보임	HTML 원문	공유하지 않고 파일을 지운다. 고객명·키·내부 URL을 주제로 넣지 말 것

보안·개인정보·비용

커뮤니티 마켓을 추가한다는 건 결국 그 소스를 신뢰하겠다는 의미다. 공식 문서에서도 Plugin과 Marketplace가 사용자 권한으로 코드를 실행할 수 있다고 경고하므로, 출처를 확인한 뒤 추가하는 편이 좋다.
eli5 자체는 스크립트가 없는 지시 파일이지만, 설명 대상 코드의 비밀은 HTML에 그대로 복사될 수 있다.
Claude Code Artifact는 기본적으로 만든 사람만 볼 수 있는 private URL이다. 팀 공유/공개 링크는 플랜과 조직 설정에 달려 있다. 스킬이 공개 웹에 자동 업로드한다고 보면 안 된다.
플러그인 가격표는 보이지 않는다. 사용량은 Claude 플랜/토큰으로 나간다.

대안과 고르는 기준

선택	잘 맞는 때	약한 때
eli5@claude-community	팀과 슬래시 명령을 공유하고, HTML 그림 형식을 고정하고 싶을 때	마켓 추가가 정책상 막혀 있을 때
프로젝트 SKILL.md 복사	저장소에 설명을 고정하고 싶을 때	업스트림 문구 변경을 자동으로 따라가야 할 때
한 줄 프롬프트 복붙	한 번만 실험할 때, 다른 에이전트에서 같은 형식을 시험할 때	매일 쓰고 문구가 흔들리면 안 될 때
다른 eli5 스킬 (청자별 말투)	매니저/아이/엔지니어용 문장 톤이 목적일 때	HTML 그림 explainer가 목적일 때

어떤 방식이 무조건 낫다고 정할 필요는 없다. 자주 쓰고 팀과 같은 명령을 공유하고 싶다면 플러그인이 편하고, 한 번 시험해 보는 정도라면 프롬프트만 붙여 넣어도 된다. 회사 정책상 커뮤니티 마켓을 추가하기 어렵다면 프로젝트에 SKILL.md를 직접 두는 방식이 현실적인 대안이 될 수 있다.

8. Q&A와 정리

Q1. 지금 공식 플러그인인가?

아니다. 2026년 8월 24일 기준으로는 커뮤니티 마켓 플러그인이다. 작성자가 공식화 여부를 고민 중이라고 밝혔다. 상태가 바뀌면 plugin.json 위치와 Thariq 안내를 다시 보면 된다.

Q2. 한국어로 주제를 넣어도 되나?

SKILL.md는 영어 지시지만 주제는 $ARGUMENTS라서 한국어를 막을 이유는 없다. 일본 사용기에서도 일본어 주제가 동작했다고 한다. 내 환경 결과는 6단계 캡처로 확인한다.

Q3. 플러그인은 무료인가?

plugin.json 라이선스는 MIT고 별도 가격표는 보이지 않는다. Claude Code 사용량과 플랜 한도는 그대로 적용된다.

Q4. HTML이 자동으로 공개 링크가 되나?

SKILL.md는 발행을 보장하지 않는다. Claude Code artifact는 필요한 조건을 갖춘 세션에서는 private URL을 만들 수 있고, 공개 공유는 플랜/조직 설정에 달려 있다. 조건이 안 되면 로컬 파일만 남는다.

Q5. 코드를 수정해 주나?

아니다. 설명용 스킬이다. 구조를 이해한 다음 일반 Claude Code 지시로 수정 요청을 보내는 편이 맞다.

Q6. 설치 없이 다른 도구에서도 쓰나?

지시 자체는 Markdown이라 다른 코딩 에이전트에 붙여 넣을 수는 있다. 이번 글이 검증하는 설치 경로는 Claude Code의 eli5@claude-community다. 다른 도구에서도 같은 슬래시 명령이나 Artifact 화면이 제공된다고 가정하면 안 된다.

처음 질문으로 돌아가 보면 ELI5가 주목받는 이유는 복잡한 신기능이라서가 아니다. Anthropic 내부에서 자주 쓰던 설명 방식을 10줄짜리 스킬로 공개했고, 그 안에 “처음 보는 사람에게 그림 중심으로 설명한다”는 규칙을 아주 단순하게 담아냈기 때문이다.

개인적으로는 설치 자체보다 메타 실험이 더 중요해 보인다.

실제 직접 effort도 조정하고, 프롬프트도 바꿔가면서 진행해가면서 경험을 해보고나면, 이 결과물을 어디까지 믿고 활용할 수 있을지도 감이 온다.

스펙 문서를 대신하는 도구라기보다 복잡한 내용을 이해하기 위한 첫 화면으로 쓰는 쪽이 더 잘 맞아 보인다.

처음부터 프로젝트 전체를 한 번에 설명시키기보다 지금 이해가 안 되는 모듈 하나, 최근에 겪은 장애 하나처럼 범위를 좁혀 /eli5로 확인해 보는 편이 좋을 것 같다.

9. 참고 자료

저작자표시 비영리 변경금지 (새창열림)

'AI > Skills' 카테고리의 다른 글

"하네스 엔지니어링" - Superpowers 리뷰 : 7단계 워크플로우와 14개 스킬 라이브러리 - 브레인스토밍부터 코드리뷰까지 (1)	2026.04.22
PM Skills 분석 : 8개 PM 플러그인과 36개 워크플로우 - PM Skills Marketplace로 혼자서 PM 팀처럼 일하기 (0)	2026.04.12
k-skill 리뷰 - 한국인이 만든 생활 밀착형 AI 에이전트(Claude Code로 KTX 예매까지 자동화하는 법) (0)	2026.04.12
"하네스 엔지니어링" - gstack(혼자서 팀처럼 개발하기) 리뷰 : Garry Tan의 Claude Code 셋업을 내 프로젝트에 적용하는 법 (0)	2026.03.30
Agent Skill 오픈 표준(Claude Skills는 Claude 전용이 아니다) - SKILL.md 하나로 Claude, Cursor, Copilot, Gemini 전부 쓰는 방법 (0)	2026.03.19

Contents

새소식