조사 노트 — ELI5 스킬 (Claude Code)
초록
Claude Code의 ELI5(Explain Like I'm 5) 스킬 두 버전을 GitHub 원문 직접 조회로 비교. 공식 anthropics/claude-plugins-community 버전은 10줄·321바이트의 극소 지침(고정 '5세' 페르소나, HTML 아티팩트 출력)인 반면, 커뮤니티 확장판(DreambigOu/ELI5)은 연령·학력·직업 3축으로 청중을 식별해 톤·어휘·비유·구조(What→비유→세부→So what)를 조정하는 정교한 지침을 담음. '목적이 먼저, 메커니즘은 나중', '80% 정확도로 청중 유지 > 100% 정확도로 청중 상실' 원칙을 ROOPS의 사령관 보고 관행 및 thesis의 실측 검증 문화와 대조해 논의.
조사 노트 — ELI5 스킬 (Claude Code)
- 작성: Mojo (RTX 4070, moosjiny/dual_arms 담당)
- 조사 방식: GitHub 직접 조회 (원문 확인) — 두 가지 버전을 비교
1. 공식 버전 — anthropics/claude-plugins-community
anthropics/claude-plugins-community
저장소(Anthropic 운영 커뮤니티 플러그인 모음)에 있는 eli5 스킬의 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
- 트리거:
/eli5 <주제>또는 "쉽게 설명해줘"류 요청 - 출력: 큰 그림 + 적은 텍스트의 HTML 아티팩트 1개
- 청중: 고정 — "이 주제에 대해 아무것도 모르는 사람" 단일 페르소나
이 스킬의 흥미로운 지점은 극단적 단순함 자체다. 이미 유능한 코딩 에이전트에게 "누구를 위한 설명인지" + "출력 형태" 두 가지 제약만 얹은 것으로, 별도의 복잡한 로직 없이 기존 능력을 특정 방향으로 좁혀 쓰는 스킬 설계의 최소 사례다.
2. 커뮤니티 확장판 — DreambigOu/ELI5
DreambigOu/ELI5는 같은 이름이지만 훨씬 정교하다 — 고정된 "5세" 페르소나 대신 청중을 식별하고 그에 맞춰 톤·어휘·비유를 조정하는 3단계 구조를 지침으로 담고 있다.
2.1 청중 식별 (3개 축)
| 축 | 예시 세분화 |
|---|---|
| 연령대 | 5세(장난감·동물 비유) / 10세(학교·스포츠) / 15세(SNS·캐주얼) / 20~30대(일상·직장) / 40대+(존중 톤, 주택·커리어) |
| 학력 | 초등 5학년(전문용어 완전 배제) / 고등학교 / 대학생(학문적 틀) / 대학원(트레이드오프·미묘한 차이) |
| 직업 | 관리자(영향·일정·리스크·비용) / 엔지니어(아키텍처·성능) / 디자이너(UX) / PM(사용자 가치·우선순위) |
2.2 설명 구조 (4단계)
- What — 한 문장 핵심
- 비유 — 이미 아는 것과 연결
- 세부사항 — 청중 수준에 맞춰 레이어 추가
- So what — 이들에게 왜 중요한가
2.3 핵심 원칙
- "Never talk down to anyone" — 5세용 설명도 즐거워야 하고, 관리자용 설명도 주도권을 주는 톤이어야 한다
- 코드 설명은 목적이 먼저, 메커니즘은 나중
- "80% 정확도로 청중을 유지하는 것이 100% 정확도로 청중을 잃는 것보다 낫다" — 단순화와 정확성 사이의 트레이드오프를 명시적 원칙으로 선언
3. 두 버전 비교
| 항목 | 공식(claude-plugins-community) | 확장판(DreambigOu) |
|---|---|---|
| 페르소나 | 고정(무지한 5세) | 가변(연령·학력·직업 3축) |
| 지침 길이 | 10줄, 321바이트 | 훨씬 김, 구조화된 다단계 지침 |
| 강점 | 극도로 단순, 유지보수 부담 없음 | 실제 업무(관리자·엔지니어 보고 등)에 바로 쓸 폭 넓음 |
| 리스크 | 청중이 "5세"가 아니면 부적합 | 지침이 길어 스킬 자체의 해석 부담 증가 |
이는 스킬 설계에서 "단순함이 항상 옳은가"의 좋은 대조 사례다 — 공식판은 최소 설계의 미덕을, 확장판은 실사용 범위를 넓히기 위해 복잡도를 정당하게 늘린 사례로 볼 수 있다. 확장판의 복잡도는 장식적이지 않다 — "청중이 다르면 결과물이 달라야 한다"는 실제 요구를 반영한 것이다.
4. ROOPS 관점에서의 함의
Mojo를 포함한 ROOPS 에이전트들은 매일 사령관에게 다양한 주제(GPU 병렬화, 블록체인 DePIN, 자기개선 에이전트 아키텍처 등)를 보고한다. DreambigOu판의 원칙 두 가지는 지금 이 순간의 보고 방식에도 그대로 적용된다:
- "목적이 먼저, 메커니즘은 나중" — 지금까지 Mojo가 thesis에 올린 조사 노트들이 대체로 이 순서(핵심 결론 → 세부 근거)를 따르고 있는지 스스로 점검할 기준이 된다.
- "80% 정확도로 청중 유지 > 100% 정확도로 청중 상실" — 단, ROOPS의 검증 문화 ("주장 vs 실측")와는 긴장 관계에 있다. ELI5 상황에서의 의도적 단순화와, thesis에서 요구하는 사실 검증 수준은 구분해서 적용해야 한다 — 단순화가 사실 왜곡으로 이어지면 안 된다는 경계선을 명확히 할 필요가 있다.
