쉽게 설명하기 스킬 (easy-explanation) — 어려운 내용을 쉽게 풀기

easy-explanation는 반복 업무를 더 안정적으로 처리하기 위한 AI 에이전트 스킬입니다.

사용자가 코드, 문서, 오류, 구조 또는 작업 결과를 “쉽게 설명해줘”, “초보자도 이해하게 알려줘”라고 요청할 때 사용한다. 사전 지식이 없는 사람도 한 번에 이해할 수 있도록 핵심과 다음 행동을 쉬운 말로 설명한다.

사용 방법

Codex나 호환되는 AI 에이전트의 스킬 폴더에 아래 SKILL.md 내용을 저장한 뒤, 설명에 포함된 트리거 문장으로 호출하세요.

사용 예:
easy-explanation 스킬 사용해줘.
이 작업은 easy-explanation 기준으로 진행해줘.

원본 위치

.codex/skills/easy-explanation/SKILL.md

SKILL.md

---
name: easy-explanation
description: 사용자가 코드, 문서, 오류, 구조 또는 작업 결과를 “쉽게 설명해줘”, “초보자도 이해하게 알려줘”라고 요청할 때 사용한다. 사전 지식이 없는 사람도 한 번에 이해할 수 있도록 핵심과 다음 행동을 쉬운 말로 설명한다.
---

# Easy Explanation

## 목적

- 대상 내용을 처음 보는 사람도 현재 상황을 이해하게 한다.
- 어려운 이름보다 무엇을 하는지, 왜 필요한지와 무엇을 하면 되는지를 전달한다.
- 정확성을 유지하면서 정보량과 전문 용어를 줄인다.

## 설명 원칙

- 코드베이스나 배경을 이미 안다고 가정하지 않는다.
- 전문 용어를 먼저 나열하지 않는다.
- 전문 용어가 꼭 필요하면 쉬운 뜻을 바로 붙인다.
- 함수명, 파일명과 의존 관계를 한 문장에 여러 개 섞지 않는다.
- 비유가 이해를 돕는 경우에만 짧게 사용한다.
- 전체 코드를 길게 복사하지 말고 필요한 한두 줄만 예시로 든다.
- 내부 구현보다 사용자가 체감하는 결과를 우선 설명한다.
- 중요한 주의점은 숨기지 않되 가능성이 낮은 예외를 길게 늘어놓지 않는다.