인공지능

Claude Code ELI5 Skill로 대상에 맞는 기술 설명 자동화하기

파파누보 2026. 8. 25. 11:30
728x90
반응형
728x170

기술적인 내용을 쉽게 설명하는 일은 생각보다 어렵습니다. 특히 같은 내용을 어린이, 관리자, 엔지니어, 디자이너처럼 서로 다른 사람에게 설명해야 한다면 단순히 문장을 쉽게 바꾸는 것만으로는 부족합니다.

Claude Code의 ELI5 Skill은 이런 문제를 해결하기 위해 만들어진 Skill입니다. 사용자가 지정한 대상에 맞춰 어휘, 비유, 말투, 설명의 깊이와 관점까지 조절해 기술적인 내용을 이해하기 쉽게 설명합니다.

이 글에서는 ELI5 Skill이 무엇인지부터 지원하는 대상, 작동 방식, 설치 방법, 평가 방법과 실제 평가 결과까지 제공된 내용을 기준으로 정리합니다.

반응형

ELI5 Skill이란?

ELI5는 "Explain Like I Am 5"의 의미로, 말 그대로 "내가 5살이라고 생각하고 설명해줘"라는 방식의 설명을 의미합니다.

하지만 Claude Code의 ELI5 Skill은 단순히 모든 내용을 어린이 수준으로 설명하는 데 목적이 있지 않습니다.

핵심은 설명을 듣는 대상에 따라 설명 방식을 바꾸는 것입니다.

예를 들어 데이터베이스 인덱스를 설명한다고 가정해 보겠습니다.

5세 어린이에게 설명한다면 기술 용어 대신 친숙한 비유를 활용할 수 있습니다. 반면 엔지니어에게 설명할 때는 정확한 기술 용어와 구조를 활용해야 합니다.

관리자에게 설명한다면 기술적인 구현 자체보다 비즈니스 영향이나 위험을 중심으로 설명하는 것이 적합할 수 있습니다.

ELI5 Skill은 이러한 차이를 자동으로 조절하도록 설계됐습니다.

대상에 따라 달라지는 설명 방식

ELI5 Skill은 사용자가 누구인지에 따라 다음과 같은 요소를 조정합니다.

Vocabulary

가장 먼저 달라지는 것은 사용하는 단어입니다.

어린이를 대상으로 설명할 때는 어려운 기술 용어를 줄이고 이해하기 쉬운 단어를 사용합니다. 반대로 엔지니어를 대상으로 한다면 필요한 기술 용어를 정확하게 사용할 수 있습니다.

즉, 같은 개념이라도 대상의 지식 수준에 맞춰 사용하는 언어를 조절합니다.

Analogies

비유 역시 대상에 따라 달라집니다.

5세 어린이에게는 장난감이나 놀이터처럼 익숙한 대상을 활용할 수 있습니다.

관리자에게는 비즈니스 결과를 중심으로 설명할 수 있고, 다른 대상에게는 그들이 익숙한 상황을 기준으로 개념을 풀어낼 수 있습니다.

Tone

말투도 대상에 맞춰 변경합니다.

어린이에게는 보다 재미있고 친근한 방식으로 설명하고, 디렉터와 같은 직군에는 전문적인 말투를 사용할 수 있습니다.

가족에게 설명할 때는 따뜻한 표현을 사용하는 방식으로 조정할 수 있습니다.

Depth

설명의 깊이도 달라집니다.

간단한 내용을 쉽게 이해해야 하는 대상에게는 짧고 핵심적인 설명을 제공할 수 있습니다.

반대로 대학원 수준의 독자처럼 보다 깊이 있는 설명이 필요한 경우에는 더 세부적인 내용을 다룰 수 있습니다.

Framing

같은 기술이라도 어떤 관점에서 설명하느냐가 달라집니다.

관리자에게는 영향과 위험을 중심으로 설명하고, 디자이너에게는 UX 관점에서 접근할 수 있습니다. 엔지니어에게는 아키텍처를 중심으로 설명하는 방식입니다.

결국 ELI5 Skill은 단순히 설명을 쉽게 만드는 것이 아니라 대상에게 적합한 방식으로 설명의 방향 자체를 조절합니다.

다양한 대상에게 활용할 수 있는 ELI5 Skill

제공된 내용에서는 ELI5 Skill이 특정 연령대만을 대상으로 하지 않는다는 점을 보여줍니다.

지원 대상은 다음과 같이 구성되어 있습니다.

연령

  • 5세
  • 10세
  • 15세
  • 20세
  • 30세
  • 40세 이상

학년 및 교육 수준

  • 초등학교 5학년
  • 중학교
  • 고등학교
  • 대학교
  • 대학원

직무

  • 관리자
  • 엔지니어
  • 디자이너
  • 디렉터
  • 프로덕트 매니저

관계

  • 아내
  • 남편
  • 부모
  • 아이
  • 친구

이처럼 ELI5 Skill은 단순한 연령별 설명을 넘어 직무와 관계까지 고려해 설명 방식을 조절할 수 있도록 구성되어 있습니다.

ELI5 Skill 사용 예시

사용 방법도 복잡하지 않습니다.

예를 들어 다음과 같은 요청을 사용할 수 있습니다.

  • ELI5 what a database index is
  • Explain this code to my manager
  • Break down how git merge conflicts work for a 5th grader
  • Explain this error to my mom
  • Simplify this for a designer

같은 기술 개념이라도 요청에 포함된 대상이 달라지면 그 대상에 맞춰 설명의 어휘와 비유, 말투, 깊이, 관점이 달라지는 방식입니다.

예를 들어 "이 코드를 관리자에게 설명해줘"라고 요청한다면 코드의 세부 구현만 설명하는 것이 아니라 관리자에게 필요한 관점에 맞춰 설명하도록 구성할 수 있습니다.

Claude Code에 ELI5 Skill 설치하기

제공된 내용에 따르면 ELI5 Skill은 Claude Code의 Skill 디렉터리에 복사해 설치할 수 있습니다.

먼저 저장소를 복제합니다.

git clone https://github.com/DreambigOu/ELI5.git

그 다음 ELI5 Skill을 Claude Code의 Skill 디렉터리에 복사합니다.

cp -r ELI5/skills/eli5 ~/.claude/skills/eli5

설치 후에는 Claude Code에서 ELI5 this 또는 explain this to my manager와 같은 방식으로 Skill을 사용할 수 있습니다.

제공된 설치 방법을 기준으로 보면 별도의 복잡한 설정 과정 없이 Skill을 지정된 디렉터리에 설치한 뒤 요청에 활용하는 구조입니다.

ELI5 Skill의 효과를 어떻게 평가할까?

ELI5 Skill의 특징 중 하나는 단순히 사용해 보는 것에서 끝나지 않고 평가할 수 있도록 구성되어 있다는 점입니다.

평가를 위해 테스트 케이스는 eli5-workspace/evals.json에 정의합니다.

예를 들어 다음과 같은 테스트 케이스를 만들 수 있습니다.

{
  "id": 3,
  "name": "explain-recursion-teenager",
  "prompt": "Explain recursion like I'm 15",
  "audience": "Age 15",
  "assertions": [
    "Uses social media, gaming, or phone references as analogies",
    "Tone is casual but not cringey — no 'fellow kids' energy",
    "Correctly explains the concept of a function calling itself",
    "Mentions a base case or stopping condition"
  ]
}

하나의 테스트 케이스에는 요청 내용과 대상, 그리고 결과가 충족해야 하는 구체적인 조건을 정의합니다.

이를 통해 단순히 "설명이 좋아졌다"라고 판단하는 것이 아니라 특정 조건을 만족했는지 확인할 수 있습니다.

평가 과정은 어떻게 진행될까?

제공된 run-evals.py는 세 가지 작업을 수행합니다.

첫 번째는 각 프롬프트를 두 번 실행하는 것입니다.

  • Skill을 적용한 결과
  • Skill을 적용하지 않은 기본 결과

두 번째는 각각의 결과를 Assertions를 기준으로 자동 평가합니다.

세 번째는 Skill 적용 결과와 기본 결과의 통과율을 비교해 결과를 보여줍니다.

예를 들어 제공된 평가 결과에서는 다음과 같은 형태로 결과를 확인할 수 있습니다.

--- Test 1: explain-db-index-age5 ---

  [with skill]

    PASS #1 — No technical jargon present
    PASS #2 — Uses book/page analogy and toy/messy room analogy
    PASS #3 — Sentences are short and conversational
    PASS #4 — Warm, enthusiastic tone with "huuuge", "super duper fast"

  [baseline]

    PASS #1 — No technical jargon found
    FAIL #2 — Uses phone book analogy, not child-friendly
    PASS #3 — Sentences are generally short
    FAIL #4 — Tone is informative but encyclopedic

=========================================

  PASS RATE SUMMARY — Iteration 1

=========================================

  With Skill:    10/12 passed (83.3%)
  Without Skill: 5/12 passed (41.6%)
  Delta:         41.7%

=========================================

제공된 결과에서는 Skill을 적용했을 때 12개 평가 항목 중 10개가 통과했고, 적용하지 않았을 때는 5개가 통과했습니다.

이에 따라 Skill 적용 결과의 통과율은 83.3%, 기본 결과는 41.6%였으며, 두 결과의 차이는 41.7%로 나타났습니다.

평가 테스트는 직접 추가할 수 있다

ELI5 Skill의 평가 범위는 고정되어 있지 않습니다.

새로운 테스트 케이스를 eli5-workspace/evals.json의 evals 배열에 추가할 수 있습니다.

테스트 케이스에는 다음과 같은 요소가 필요합니다.

  • prompt: 실제로 사용할 요청
  • name: 결과 저장을 위한 식별자
  • assertions: 결과를 평가하기 위한 구체적인 조건

제공된 내용에서는 테스트 하나에 4개의 Assertion을 사용하는 방식이 효과적이라고 설명합니다.

예를 들어 15세를 대상으로 재귀를 설명하는 테스트라면 단순히 "쉽게 설명했는가"를 확인하는 것이 아니라 다음과 같이 구체적인 기준을 만들 수 있습니다.

  • 소셜 미디어, 게임 또는 휴대폰을 활용한 비유를 사용하는가
  • 지나치게 어색하지 않은 캐주얼한 말투인가
  • 함수가 자기 자신을 호출한다는 개념을 정확하게 설명하는가
  • 종료 조건이나 기본 조건을 언급하는가

이렇게 평가 기준을 구체적으로 만들면 Skill이 실제 요구사항을 충족하는지 확인하기 쉬워집니다.

평가 명령어

제공된 내용에서는 평가를 실행하기 위한 몇 가지 명령어를 소개합니다.

전체 테스트를 실행하고 자동으로 평가하려면 다음 명령어를 사용할 수 있습니다.

python eli5-workspace/run-evals.py

특정 테스트 하나만 실행하려면 다음과 같이 사용할 수 있습니다.

python eli5-workspace/run-evals.py --test=1

기본 결과를 제외하고 Skill만 평가하려면 다음 명령어를 사용합니다.

python eli5-workspace/run-evals.py --with-skill-only

이미 생성된 결과를 다시 평가하려면 다음 명령어를 사용할 수 있습니다.

python eli5-workspace/run-evals.py --grade-only

평가 결과는 eli5-workspace/iteration-N/에 저장되며, 각 테스트 케이스에서는 grading.txt 파일을 통해 세부적인 평가 근거를 확인할 수 있습니다.

ELI5 Skill에서 확인된 가장 큰 개선점

제공된 평가 결과에서 가장 큰 개선점으로 언급된 부분은 대상에 맞춘 설명 방식입니다.

특히 관리자와 같은 비기술적인 대상에 대한 설명에서 차이가 크게 나타났습니다.

제공된 자료에서는 비기술 직군을 대상으로 한 audience-specific framing이 가장 큰 개선점으로 소개됐습니다.

이는 ELI5 Skill의 핵심이 단순히 기술 내용을 쉽게 만드는 데 있지 않다는 것을 보여줍니다.

중요한 것은 누구에게 설명하느냐에 따라 무엇을 중심으로 설명할 것인지 결정하는 것입니다.

어린이에게는 이해하기 쉬운 비유가 중요할 수 있고, 관리자에게는 비즈니스 영향이나 위험이 중요할 수 있습니다. 엔지니어에게는 기술적 구조가 더 중요할 수 있습니다.

ELI5 Skill은 이러한 차이를 설명 과정에 반영하는 것을 목표로 합니다.

ELI5 Skill이 보여주는 가능성

ELI5 Skill의 사례는 AI에게 단순히 "쉽게 설명해줘"라고 요청하는 것과 대상에 맞는 설명 기준을 명확하게 정의하는 것의 차이를 보여줍니다.

대상에 따라 필요한 설명 방식은 달라집니다.

어휘를 바꿔야 할 수도 있고, 비유를 바꿔야 할 수도 있습니다. 때로는 설명의 깊이를 줄이거나 늘려야 하고, 같은 기술을 전혀 다른 관점에서 설명해야 할 수도 있습니다.

ELI5 Skill은 이러한 요소를 하나의 Skill로 구성하고, 테스트 케이스와 자동 평가를 통해 그 결과를 확인할 수 있도록 했습니다.

728x90

Claude Code의 ELI5 Skill은 기술적인 내용을 무조건 어린이 수준으로 단순화하는 도구가 아닙니다.

핵심은 설명을 듣는 대상에 맞춰 어휘, 비유, 말투, 깊이, 관점을 조절하는 것입니다.

또한 연령뿐 아니라 교육 수준, 직무, 관계에 따라서도 설명 방식을 다르게 구성할 수 있으며, 실제 사용 예시를 통해 관리자, 엔지니어, 디자이너, 어린이 등 다양한 대상에 맞춘 설명을 요청할 수 있습니다.

여기에 테스트 케이스와 Assertions를 활용한 평가 체계를 통해 Skill 적용 전후의 결과를 비교할 수 있다는 점도 특징입니다.

제공된 평가에서는 Skill을 적용했을 때 기본 결과보다 높은 통과율을 기록했으며, 특히 비기술 직군을 대상으로 한 설명 방식에서 개선점이 확인됐습니다.

결국 ELI5 Skill이 보여주는 방향은 단순합니다. 좋은 설명은 어려운 내용을 무조건 쉽게 만드는 것이 아니라, 듣는 사람이 누구인지에 맞춰 설명하는 것입니다.

300x250

https://github.com/dreambigou/eli5

 

GitHub - DreambigOu/ELI5: ELI5 — A Claude Code skill that explains anything to anyone: kids, managers, engineers, parents. Ada

ELI5 — A Claude Code skill that explains anything to anyone: kids, managers, engineers, parents. Adapts tone, vocabulary, and analogies to match the audience. - DreambigOu/ELI5

github.com

728x90
반응형
그리드형
저작자표시 비영리 변경금지 (새창열림)