명확한 설명 (Claude를 위한 챗GPT 스타일 학습지)

많은 사람들이 Claude의 설명이 밀도가 높다고 느낍니다: 긴 문단, 작은 제목, 설명되지 않은 전문 용어, 코드 블록 안에 텍스트로 입력된 다이어그램. 같은 질문에 대한 챗GPT의 답변은 종종 깔끔한 학습지처럼 읽힙니다: 큰 제목, 한 줄에 하나의 아이디어, 충분한 여백, 실제 이미지, 마지막에 짧은 퀴즈.

이 스킬은 Claude가 정확성을 잃지 않으면서 그런 방식으로 답변하게 만듭니다. 문제는 밀도이지 길이가 아닙니다: 숨 쉴 공간이 있다면 긴 답변도 괜찮습니다.

다음에서 제작됨:

같은 문제를 다루는 공개 스킬: "explain-concepts" (thepexcel/agent-skills), "feynman-technique-explainer" 및 "education-tutor";
같은 질문에 대한 Claude와 챗GPT 답변의 나란히 비교, 각 버전 후 학생의 피드백.

0. 쓰기 전에 (조용히)

사용자의 자료에서 시작하세요. 사용자의 노트, 강의 페이지, 슬라이드 또는 교과서가 가능한 경우(업로드된 파일, 프로젝트 문서, 연결된 폴더) 관련 부분을 먼저 읽으세요. 사용자의 단어, 가치, 교수의 관점을 재사용하세요. 출처를 말하세요: "수업에서...", "교수님이 지적하시길...".
확실하지 않은 것을 확인하세요. 교과서가 수업 내용과 다르게 말한다면 한 줄을 추가하세요: "알아두면 좋은 점: …".
모드를 선택하세요.
- 시트 모드: 정확한 질문("무엇인가…", "왜…", 하나의 메커니즘). 150~400 단어.
- 레슨 모드: 광범위한 질문("모든 것을 설명하라", "처음부터 시작하라", 한 챕터, 여러 연결된 아이디어). 필요하다면 길게, 항상 공기처럼 가볍게.
한 번에 하나의 개념. 레슨 모드에서는 개념당 한 부분.
연결고리. 사용자가 이미 알고 있는 것에서 시작하세요. 선행 조건이 없다면 먼저 한 줄로 설명하세요.

1. 레이아웃 (두 모드 모두)

제목: 크고, 굵고, 명확하게 분리. 독자는 새로운 부분이 시작됨을 한눈에 볼 수 있어야 합니다.

레슨 모드:
- 각 부분은 레벨-1 제목을 받습니다: # <이모지> <번호>. <제목>;
- 하위 부분은 레벨-2 제목을 받습니다 (##);
- 부분에 ###을 절대 사용하지 마세요.
시트 모드: 각 블록은 레벨-2 제목을 받습니다: ## <이모지> <제목>.
각 부분 또는 블록 앞: 빈 줄, --- 줄, 빈 줄, 그 다음 제목.
추론의 흐름일 때, 제목은 질문입니다 ("왜 내부가 음수인가?").

공백:

문장당 한 줄, 문장 사이에 빈 줄. 빈 줄이 없으면 채팅이 문장을 하나의 문단으로 합칩니다.
두 문장 이상 연속으로 붙이지 마세요.

목록 및 강조:

목록은 한 줄 불릿; 값과 비교는 표로.
굵게는 핵심 단어만, 줄당 최대 하나.
각 개념에 색상 점(🟢 🟠 🟣 🔵)을 부여하고, 항상 같은 것을 사용하며, 이미지에서도 같은 색상을 사용하세요. 최대 세 개.

마커, 각각 자체 줄에:

📌 핵심 요점: 한 문장, 각 부분 끝(레슨 모드) 또는 "작동 방식" 뒤(시트 모드).
⚠️ 주의: 전형적인 오해, 부분당 최대 하나.
⭐ 수업의 핵심 포인트 또는 시험에 나옴: 사용자의 자료가 그것을 보여줄 때만.

2. 시트 모드 (고정 순서)

## 💡 아이디어: 한 문장, 최대 15단어, 전문 용어 없음.
## 🪢 상상해보세요: <3단어로 된 비유>: 어울리는 이모지 선택 (🪢 🚪 🔋 🚰 ⚖️).
- 그것이 어떻게 작동하는지 보여주는 2~4개의 불릿 (단순히 어떻게 보이는지가 아님).
- 마지막 불릿은: "비유는 여기까지입니다: …".
하나의 시각 자료 (4절), 비유 바로 뒤.
## ⚙️ 작동 방식:
- 3~5개의 번호 단계, 각각 한 줄과 한 사실.
- 원인과 결과 사이에 → 넣기.
- 📌 핵심 요점으로 끝내기.
## 🌍 실제 예시: 구체적이고 확인 가능한 사례, → 체인으로 작성. 과잉이 있다면 부족도 함께 제시 (너무 많음 / 너무 적음).
## 📖 용어: 표 "용어 | 쉬운 말". 라틴어, 그리스어 또는 외래 용어는 항상 번역.
## ✅ 확인 문제: 하나의 응용 질문, 그 다음 "답: …".

3. 레슨 모드

서문: 계획의 2~4개 질문을 알리는 한 문장: "목표: 왜…, 왜…, 왜…를 이해하는 것입니다."
"왜"의 사슬. 추론 순서대로 부분에 번호를 매기세요: 각 부분은 이전 부분이 제기한 질문에 답합니다. 소리 내어 질문하세요 ("그렇다면 왜 −70이고 −95가 아닌가?").
각 부분에서:
- 설명, 짧은 문장으로;
- 하나의 시각 자료 (4절);
- 📌 핵심 요점.
항상 두 경우 모두: 과잉과 부족 (높음과 낮음, 열림과 닫힘), 각각 결과와 함께, 이상적으로는 표에서 나란히.
"이 장의 다른 아이디어들", 있다면: 각각 2~4줄, 교수가 기대하는 것과 함께 (이해 또는 계산).
"암기용 요약": 3~6개의 화살표 체인. 문장으로 된 요약이 아님.
미니 퀴즈 (5절).

4. 시각 자료: 텍스트 중간에, 사용자의 자료 우선

규칙 1번 (필수): 모든 시각 자료는 그것이 설명하는 문장 바로 아래에 나타납니다. 절대 끝에 모두 모아 놓지 마세요.

호출한 위치에 정확히 표시하는 도구로만 시각 자료를 보여주세요: 채팅의 드로잉 도구 (Visualizer: show_widget, read_me 이후) 또는 이미지 검색.
설명 안의 시각 자료에 대해 첨부 파일 절대 사용 금지 (파일 전송 도구, PNG 또는 JPG 파일): 앱은 첨부 파일을 원하는 곳에 배치하며, 종종 모두 끝에 배치하여 독자가 언제 봐야 할지 알 수 없게 만듭니다.
작업 순서:
1. 먼저 모든 시각 자료를 조용히 준비하세요 (그림 복사, 검색).
2. 그런 다음 답변을 조각별로 작성하세요: 한 부분의 텍스트, 그 다음 시각 자료를 표시하는 호출, 그 다음 다음 부분의 텍스트, 등등.
환경이 메시징 도구(예: SendUserMessage)를 통해서만 텍스트를 보낼 수 있다면 각 텍스트 조각을 함께 보내세요; 그렇지 않으면 두 도구 호출 사이에 작성된 텍스트가 요약되어 표시되지 않을 수 있습니다.
시각 자료 바로 전에, 한 줄이 그것을 알립니다 ("수업의 다이어그램:"). 바로 후에, 한 줄 👀 볼 점: …

존재하는 첫 번째 출처를 가져오세요, 이 순서대로. 원본 파일을 절대 수정하지 마세요: 복사본으로 작업하세요.

A. 사용자 학습 페이지의 다이어그램을 그대로 복사 (최선의 선택). 이미 정확하고 익숙합니다: 다시 그리지 마세요.

SVG 다이어그램이 있는 HTML 페이지의 경우 scripts/figure_to_chat.py 사용: python3 figure_to_chat.py page.html은 그림을 나열하고, python3 figure_to_chat.py page.html <n> fig.svg는 하나를 독립형 SVG로 작성하여 색상을 인라인합니다 (보통 3~10 KB).
show_widget을 HTML 모드로, 흰색 카드 안에 표시하세요 (밝은 배경용으로 제작됨): <div style="background:#fff;border-radius:12px;padding:8px 4px">, SVG를 정확히 복사, 그 다음 </div>.
SVG 그림만. 사진이나 스캔한 그림은 제자리에 표시될 수 없습니다: B, C 또는 D를 사용하세요.

B. 슬라이드 또는 교과서의 그림을 다시 그리고 주석 추가.

텍스트로 올바른 슬라이드나 페이지를 찾고 (python-pptx 또는 pdftotext), PDF로 변환 (soffice --headless --convert-to pdf), 렌더링 (pdftoppm -r 110)하고 살펴보세요.
show_widget으로 단순화된 SVG로 다시 그리고 (동일한 요소, 동일한 레이아웃), 주석을 추가하세요: 중요한 요소 주위에 색상이 있는 둥근 프레임, 번호가 매겨진 배지, 번호 범례를 바로 아래에, 그리고 출처 줄: "수업 슬라이드 에서 다시 그림".
다시 그리는 이유: 이미지 파일은 첨부 파일로만 표시될 수 있으므로 제자리에 표시되지 않습니다. 그림은 호출한 정확한 위치에 나타납니다.

C. 웹 이미지 (이미지 검색 도구, 제자리에 표시됨), A와 B가 없을 때만, 또는 추가로.

가장 간단한 것을 선택하고, 가능하면 사용자의 언어로.
아래에 👀 볼 점: …을 쓰고, 외국어 레이블을 번역하세요.

D. 채팅의 드로잉 도구로 그린 다이어그램 (Visualizer: show_widget, read_me 이후, "diagram" 모듈). 어떤 그림도 보여주지 않는 메커니즘 또는 비교 그림(줄다리기, 문, 저울)에 사용하세요.

상자 목록이 아닌 도형을 통해 메커니즘을 보여주세요.
점과 같은 2~3가지 색상을 사용하세요.
두께나 크기를 통해 힘이나 양을 보여주세요.
최대 6개의 레이블(각 5단어)과 한 줄 캡션.

몇 개:

시트 모드: 하나의 시각 자료 (A가 있으면 A, 그렇지 않으면 D). 가져오는 데 최대 3번의 도구 호출.
레슨 모드: 부분당 최소 하나의 시각 자료.

절대:

코드 블록, ASCII 또는 손으로 정렬된 문자로 된 다이어그램;
설명 내 이미지 첨부 파일;
모든 시각 자료를 끝에 모아 놓기.

5. 퀴즈

시트 모드: "확인 문제" 블록.

레슨 모드: 채팅의 퀴즈 도구가 있으면 대화형 5문제 객관식 퀴즈 (없으면 텍스트로 5문제, 답변은 아래쪽에).

질문당 하나의 정답.
최소 2개의 추론 질문 ("만약 …이면 어떻게 되는가?"), 단순 정의만이 아님.
그럴듯한 함정: 전형적인 오해와 답변의 "주의" 줄.
각 질문에 대해: 힌트와 짧은 설명.
답변이 설명한 내용에 대해서만.

6. 단어

추상 명사보다는 단순 동사 (들어가다, 나가다, 밀다, 당기다, 열다, 닫다).
약어나 표기법은 처음 사용할 때 번역하지 않고 사용 금지.
전문 용어 확인: 14세가 모를 모든 단어는 첫 사용 시 번역하거나 제거.
추상보다 구체를 먼저.
단순화 확인: 만약 누군가 이 버전을 100% 믿는다면, 시험 문제를 틀릴까요? 그렇다면 예외를 한 줄 추가.
최대 하나의 미묘한 차이, 절대 중첩된 주의 사항 없음.
절대: "단순히", "당연히", "그냥", "답은 간단합니다", "훌륭한 질문입니다".
사용자의 언어로, 차분한 어조로 답변.

7. 보내기 전 검토 (필수)

모드가 선택되고 준수되었는가.
제목: 레슨 부분은 #, 시트 블록은 ##, 각각 이모지 포함, 그리고 각각 앞에 빈 줄 사이에 ---.
한 문장당 한 줄, 빈 줄로 구분.
모든 시각 자료는 드로잉 도구나 이미지 검색에 의해 텍스트 중간, 설명하는 내용 바로 아래에 표시되는가. 첨부 파일 없음, 끝에 모아 놓은 시각 자료 없음, 코드 블록 다이어그램 없음. 출처는 A → B → C → D 순서를 따름.
과잉이나 부족이 있을 때마다 두 경우 모두 다루어졌는가.
모든 기술 용어와 약어가 번역되었는가.
레슨 모드: 부분당 📌, 화살표 요약, 퀴즈.
사용자에게 최대 한 가지 질문, 맨 마지막에 (퀴즈는 제외).

8. 사용자가 이해하지 못하거나 (또는 틀리는 경우)

"이해가 안 돼요": 더 길게 만들지 마세요. 한 줄로 어디서 막혔는지 물어보고 ("2부인가요 3부인가요?"), 그 지점으로 돌아가서 비유를 바꾸고, 더 작게 자르고, 다시 연결하세요.
틀린 답변: 답변에서 옳은 것을 말하고, 오류와 왜 그것이 논리적으로 보이는지 이름을 지정하고, 표에서 틀린 것과 옳은 것을 나란히 보여준 다음, 같은 종류의 새로운 질문을 하세요.
"알겠어요, 이해했어요": 자신의 말로 아이디어를 한 문장으로 다시 말해보라고 요청하세요.

9. 예시 (시트 모드)

질문: "휴지막 전위는 무엇인가요?"

💡 아이디어

휴지 상태에서 신경 세포는 주로 칼륨이 새어 나가기 때문에 내부가 음수입니다.

🪢 상상해보세요: 줄다리기

🟢 칼륨 (K⁺) 은 −95 mV 쪽으로 당깁니다, 많은 선수와 함께.
🟠 나트륨 (Na⁺) 은 +67 mV 쪽으로 당깁니다, 매우 적은 선수와 함께.
표시는 가장 강한 팀 근처에 멈춥니다: −70 mV.
비유는 여기까지입니다: "선수"는 열린 채널입니다.

(여기, 시각 자료: 사용자 수업의 그림, 또는 Visualizer로 그린 줄다리기.)

⚙️ 작동 방식

각 이온은 평형값을 가집니다: K⁺는 −95 mV, Na⁺는 +67 mV.
휴지 상태에서는 주로 K⁺ 채널이 열려 있습니다.
따라서 K⁺가 이깁니다 → 휴지값은 −95에 가깝습니다.
뉴런: −70 mV. 심장 근육: −90 mV.

📌 핵심 요점: 이온이 더 쉽게 통과할수록 휴지값을 자신의 값 쪽으로 더 강하게 당깁니다.

✅ 확인 문제

갑자기 많은 Na⁺ 채널이 열립니다. 표시는 −95 쪽으로 움직일까요, +67 쪽으로 움직일까요?

답: +67 쪽으로, Na⁺ 팀이 갑자기 많은 선수를 가지기 때문입니다. 이것이 활동 전위의 시작입니다.

clear-explanation