AI에게 “쉽게 설명해 줘”라고 했는데도 낯선 용어와 예외가 한꺼번에 쏟아져 더 혼란스러웠던 경험이 있을 수 있다. 문제는 모델이 아는 것이 부족해서가 아니라, 아는 것을 첫 답변에 모두 담으려는 데 있다.
2026년 7월 공개된 커뮤니티 eli5 스킬은 이 문제를 간단한 규칙으로 다룬다. 핵심은 사실을 어린이 수준으로 축소하는 것이 아니다. 첫 답변에는 독자가 발을 디딜 수 있는 최소한의 지도만 주고, 더 알고 싶은 한 갈래를 선택하게 한 뒤 같은 방식으로 한 단계씩 내려가는 것이다.
이 글에서는 eli5 스킬의 실제 SKILL.md를 Agent Skills 규격과 함께 살펴보고, 개념 설명과 코드베이스 설명이 어떻게 달라지는지, 어디까지 믿고 써야 하는지 정리한다.

ELI5는 무슨 뜻인가
ELI5는 “Explain Like I'm Five”, 즉 “다섯 살에게 설명하듯 쉽게 말해 달라”는 인터넷 표현이다. 하지만 이 스킬의 기본 독자는 실제 다섯 살이 아니다. 원문은 독자를 “다른 분야에서 온 영리한 사람”으로 설정한다. 전문성을 무시하지 않되, 지금 설명하는 분야의 배경지식을 당연하게 여기지 말라는 뜻이다.
스킬의 한 문장 원칙은 다음처럼 요약할 수 있다.
사실을 단순화하지 말고, 사실을 전달하는 포장을 단순화한다.
--literal-5yo 옵션을 붙였을 때만 일상적인 비유만 사용하고 코드를 제외한다. 기본 모드에서는 정확한 용어와 코드도 필요하면 쓸 수 있다. 따라서 ELI5를 “무조건 유치한 비유를 만드는 기능”으로 이해하면 이 스킬의 의도를 놓치게 된다.
왜 일반적인 AI 설명은 어려워지는가
LLM은 질문을 받으면 관련 내용을 폭넓게 생성하는 데 능하다. 그 장점이 설명에서는 역효과를 낼 수 있다. 정의, 역사, 종류, 예외, 내부 구현, 주의사항을 한 번에 넣으면 각각은 맞더라도 독자가 어디부터 붙잡아야 할지 알기 어렵다.
eli5 스킬은 이를 “완전한 답변의 실패”로 본다. 첫 답변에서 모든 것을 다루는 대신 다음 세 가지를 제한한다.
- 한 단계에는 새로운 생각 하나만 소개한다.
- 추상적인 표현보다 실제로 일어나는 행동을 말한다.
- 첫 설명이 끝나면 더 깊게 볼 수 있는 갈래 2~3개를 제시한다.
중요한 것은 정보를 버리는 것이 아니라 순서를 바꾸는 것이다. 전체 분류표를 압축해서 보여 주는 대신, 먼저 가장 유용한 한 가지를 이해시키고 나머지는 선택 가능한 다음 단계로 남긴다. 원문이 말하는 “깊이는 분량이 아니라 하강을 통해 전달된다”는 뜻이 여기에 있다.

복잡한 전체 지식을 한 번에 압축하지 않고 핵심 발판을 만든 뒤 선택한 갈래로 내려간다. ELI5 스킬 원문을 바탕으로 재구성.
두 가지 설명 모드
이 스킬은 질문 대상을 크게 Concept mode와 System mode로 나눈다. 용어 하나를 설명하는 것과 코드베이스 전체를 안내하는 것은 같은 형식으로 처리할 수 없기 때문이다.
Concept mode: 개념·메커니즘·API
개념 모드는 약 200단어 이내의 첫 설명을 목표로 한다. 순서는 네 단계다.
- 이 개념이 해결하는 문제를 일상적인 한 문장으로 말한다.
- 기본 동작 중 딱 하나, 반드시 기억할 내용을 고른다.
- 구체적인 예시 하나를 보여 준다.
- 더 깊게 볼 수 있는 갈래를 제시한다.
예를 들어 Kubernetes의 Pod를 설명한다면 첫 답변부터 모든 라이프사이클 상태와 네트워크 규칙을 열거하지 않는다. “컨테이너 하나 이상을 함께 실행하고 관리하는 Kubernetes의 최소 배포 단위”라는 발판을 만든 뒤, 간단한 YAML이나 요청 흐름 하나를 보여 준다. 그다음 “왜 컨테이너가 아니라 Pod가 단위인지”, “재시작과 교체는 어떻게 다른지”, “Service는 Pod를 어떻게 찾는지” 가운데 하나를 고르게 한다.
좋은 비유가 있으면 사용할 수 있지만, 비유가 깨지는 지점이 실제 판단에 영향을 준다면 한계도 함께 알려야 한다. 비유가 사실을 대신해서는 안 된다.
System mode: 코드베이스·아키텍처·서비스
시스템 모드는 첫 설명을 한 화면, 약 450단어 아래로 제한한다. 먼저 코드와 문서를 실제로 탐색한 다음 조용히 단순화해야 한다. 읽지 않은 시스템을 그럴듯하게 쉽게 설명하는 것은 오히려 위험하기 때문이다.
설명은 다음 순서를 따른다.
- 누구를 위해 무엇을 하는 시스템인지 한 문장으로 말한다.
- 큰 블록 3~5개를 쉬운 이름으로 나누고 각자 하는 일 하나를 붙인다.
- 요청·클릭·실행 하나가 블록을 통과하는 여정을 끝까지 추적한다.
- 초보자가 놀랄 설계 결정 세 가지와 그 이유를 고른다.
- 앞의 이름과 일치하는 작은 Mermaid 다이어그램을 보여 준다.
파일과 ADR은 본문 중간에 계속 끼워 넣지 않고 끝의 짧은 읽기 목록으로 모은다. 사용자가 “더 깊게”라고 하면 전체 지도를 더 촘촘하게 다시 펼치지 않고, 선택한 블록 하나에만 같은 규칙을 적용한다.

개념 모드와 시스템 모드는 대상, 첫 답변의 분량, 설명 순서가 다르다. ELI5 스킬 원문을 바탕으로 재구성.
실제로 무엇이 달라지는가
일반적인 질문과 ELI5 방식의 차이를 “TLS가 무엇인가?”라는 질문으로 비교해 보자.
나쁜 첫 답변은 TLS 버전 역사, 핸드셰이크 메시지 종류, 인증서 체인, 대칭키와 비대칭키, 암호 스위트, 세션 재개를 한 번에 설명한다. 내용이 맞아도 TLS를 처음 배우는 사람에게는 지도보다 부품 목록에 가깝다.
ELI5 방식은 먼저 “TLS는 인터넷에서 상대가 맞는지 확인하고, 중간에서 내용을 훔쳐보거나 바꾸기 어렵게 만드는 통신 보호 규칙”이라는 문제와 기본 동작을 제시한다. 이어서 브라우저가 서버 인증서를 확인하고 둘만의 세션 키를 합의한 뒤 암호화된 HTTP를 주고받는 한 번의 여정을 보여 준다. 끝에서는 인증서 검증, 키 합의, TLS 1.3의 변화 중 하나를 고르게 한다.
이 방식의 장점은 짧다는 데만 있지 않다. 독자가 이미 아는 부분과 정말 궁금한 부분을 다음 선택으로 드러낼 수 있다. 설명자는 불필요한 내용을 줄이고, 독자는 자신에게 필요한 해상도로 내려갈 수 있다.
설치하면 모델에 새 지식이 생길까
그렇지 않다. Agent Skills는 모델 자체를 재학습시키는 기능이 아니다. 공식 규격에서 스킬은 최소한 SKILL.md를 포함하는 디렉터리이며, 필요하면 scripts/, references/, assets/를 함께 둔다. 클라이언트는 처음에 이름과 설명 같은 메타데이터만 보고, 요청이 맞을 때 전체 지침을 불러오며, 추가 자료는 필요할 때 읽는다. 이를 점진적 공개라고 한다.
eli5는 실행 프로그램이나 외부 도구를 추가하지 않는 단일 SKILL.md다. 따라서 모델의 사실 지식이나 접근 권한을 늘리지 않는다. 대신 설명할 때 지켜야 할 편집 규칙, 분량 예산, 탐색 순서와 후속 질문 형식을 반복 가능하게 만든다.
스킬을 설치할 위치와 호출 방식은 사용하는 에이전트 제품마다 다르다. 공통 규격을 지원하더라도 argument-hint 같은 추가 메타데이터를 모든 클라이언트가 똑같이 해석한다고 단정할 수 없다. 설치 전에는 해당 제품의 스킬 검색 경로와 지원 필드를 확인해야 한다.
장점과 한계
장점
- 인지 부하를 줄인다. 첫 답변의 목표가 “모든 내용 포함”이 아니라 “첫 발판 제공”으로 명확하다.
- 개념과 시스템을 다른 템플릿으로 다룬다. 특히 시스템 설명 전에 실제 코드와 문서를 읽도록 요구한다.
- 대화형 깊이 조절이 가능하다. 2~3개의 후속 갈래가 짧은 답변에서 빠진 내용을 복구한다.
- 구체성을 강제한다. 추상 용어를 다른 추상 용어로 설명하는 악순환을 줄인다.
한계와 주의점
첫째, 이 글에서 다룬 eli5는 공식 표준에 포함된 내장 스킬이 아니라 개인이 GitHub Gist로 공개한 커뮤니티 지침이다. 2026년 8월 26일 확인 기준으로 별도의 라이선스 표시가 보이지 않는다. 내용을 그대로 복제·배포하려면 작성자에게 이용 조건을 확인하는 편이 안전하다.
둘째, 짧은 첫 답변이 항상 적절한 것은 아니다. 사고 대응 절차, 약물 복용, 법률 요건처럼 누락 자체가 위험한 분야에서는 필수 경고와 전제 조건을 분량 예산보다 우선해야 한다.
셋째, 좋은 비유도 경계를 흐릴 수 있다. “암호화는 자물쇠” 같은 비유는 출발점으로 유용하지만 키 교환, 인증, 무결성을 모두 설명하지 못한다. 실제 판단이 시작되는 지점에서는 정확한 용어와 반례로 돌아와야 한다.
넷째, 시스템 모드의 품질은 사전 탐색 품질에 달려 있다. 접근할 수 없는 코드나 오래된 문서만 보고 설명하면, 간결하지만 틀린 지도를 만들 수 있다.
언제 쓰면 좋은가
새 기술의 첫 개념을 잡을 때, 낯선 코드베이스에 온보딩할 때, 이전 답변을 읽고도 “잘 모르겠다”는 반응이 나왔을 때 유용하다. 반대로 API의 모든 필드, 규격의 모든 예외, 운영 체크리스트 전체가 필요한 사람에게는 ELI5 첫 답변 뒤에 공식 레퍼런스를 연결해야 한다.
직접 요청할 때는 다음처럼 말하면 된다.
이 시스템을 ELI5 방식으로 설명해 줘.
먼저 실제 코드와 문서를 확인하고,
큰 블록 3~5개와 요청 하나의 전체 흐름만 보여 줘.
끝에는 더 깊게 볼 갈래 3개를 제시해 줘.
실제 다섯 살 수준의 비유만 원한다면 --literal-5yo 의도를 명시하고, 코드와 전문 용어를 빼 달라고 요청할 수 있다.
결론
ELI5 스킬의 본질은 “더 짧게 말하기”가 아니라 “독자가 이해할 순서로 정보를 공개하기”다. 사실은 보존하고 첫 발판만 작게 만들며, 다음 깊이는 독자가 고르게 한다. 개념에는 문제·기본 동작·예시를, 시스템에는 큰 블록과 한 번의 전체 여정을 먼저 보여 준다.
설명이 어렵다는 피드백을 자주 받는 AI 워크플로라면 이 원칙만으로도 답변의 체감 품질을 크게 바꿀 수 있다. 다만 커뮤니티 스킬의 출처와 라이선스, 사용하는 클라이언트의 호환성, 고위험 분야에서 생략하면 안 되는 정보는 별도로 확인해야 한다.
공식 참고 자료
'일반IT > AI' 카테고리의 다른 글
| Grill-with-docs 스킬: AI 질문을 CONTEXT.md와 ADR로 남기는 설계 인터뷰 (0) | 2026.08.29 |
|---|---|
| Grill-me 스킬이란? AI가 내 계획의 약점을 끝까지 캐묻게 만드는 방법 (0) | 2026.08.29 |
| Ollama란 무엇인가 — Docker 컨테이너로 로컬 LLM 설치하고 API까지 사용하기 (0) | 2026.08.01 |
| AI Gateway란 무엇인가 — 대표 오픈소스와 사실상의 표준은 누구인가 (0) | 2026.08.01 |
| AI 모델을 위한 가드레일 종류와 대표 오픈소스 — 입력부터 RAG·도구 실행까지 (0) | 2026.08.01 |