Communitygithub.com

설명 인포그래픽

복잡한 개념을 실생활 비유, 시각적 다이어그램, 점진적 공개를 통해 설명하는 애니메이션 인터랙티브 HTML 페이지를 생성합니다.

설명 인포그래픽란 무엇인가요?

이 스킬은 사용자가 복잡한 개념을 시각적이고 인터랙티브한 형태로 이해할 수 있도록 단일 HTML 파일을 생성합니다. 스크롤 기반 애니메이션, 슬라이더, 토글, 클릭 공개 등의 인터랙티브 요소를 활용하여 금융, 기술, 과학, 비즈니스 등 다양한 주제를 설명합니다. 이 도구는 Bartosz Ciechanowski, The Pudding, distill.pub과 같은 시각적 설명 스타일을 모방하여 스마트하지만 전문가가 아닌 독자도 5분 이내에 복잡한 개념을 이해할 수 있도록 설계되었습니다. 주요 기능으로는 개념 연결고리(훅), 직관적 비유, 단계별 메커니즘 설명, 일반적인 오해 해소, 최종 요약 등 5단계 구조를 제공합니다. 기술적으로는 외부 의존성 없이 단일 파일로 저장되며, 모바일 친화적이고 접근성을 고려한 시맨틱 HTML과 인라인 SVG 다이어그램을 사용합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 호환되며, 사용자가 요청할 때마다 즉시 생성할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chalhoub120-png/opencode-skills-curated/tree/HEAD/skills/explainer-infographic

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

설명 인포그래픽은(는) 무엇을 하나요?

당신은 위대한 시각적 설명가(Bartosz Ciechanowski, The Pudding, distill.pub)처럼 개념을 스크롤, 인터랙티브 다이어그램, 실생활 비유, 점진적 깊이를 통해 설명하는 단일 HTML 페이지를 만듭니다. 결과물은 스마트하지만 전문가가 아닌 독자가 5분 이내에 복잡한 주제를 이해할 수 있도록 해야 합니다.

시작하기 전에

필수 요소를 파악하세요:

  1. 개념 — 무엇을 설명할 것인가?
  2. 독자 — 누가 읽을 것인가? (기본값: 스마트하지만 전문가가 아닌 독자)
  3. "왜 지금인가" — 미팅, 수업, 영상, 블로그 글, 개인 학습 중 무엇을 위한 것인가?
  4. 깊이 — 빠른 직관(한 화면)인가, 더 깊은 탐구(긴 스크롤)인가?

지정되지 않은 경우 기본값은: 스마트하지만 전문가가 아닌 독자, 3-5분 스크롤할 수 있을 정도의 깊이, 특정 용도 없음.

구조

대부분의 개념은 5단계로 설명할 수 있습니다. 다음 순서로 페이지를 만드세요:

1. 훅 (한 화면)

개념을 이해할 가치가 있게 만드는 질문이나 놀라운 사실로 시작하세요. "X가 무엇인가"가 아니라 — "왜 물 위에 지어진 다리는 빈 상자로 시작할까?" 또는 "왜 30년 모기지 비용이 집값의 2배 이상이 될까?"와 같은 방식으로요.

2. 비유

익숙하지 않은 개념을 독자가 이미 알고 있는 것에 연결하세요. 비유는 페이지 전체에 걸쳐 유지되어야 하며, 도입 후 버려지면 안 됩니다. 예시:

  • LLM을 "스테로이드를 맞은 예측 텍스트"에 비유
  • 현금 흐름을 "파이프를 통한 물"에 비유
  • DNS를 "인터넷의 전화번호부"에 비유

강력한 비유 하나를 선택하고 그것에 집중하세요. 비유를 혼합하면 독자를 혼란스럽게 합니다.

3. 메커니즘 (3-7개 섹션)

실제로 어떻게 작동하는지 순서대로 설명하세요. 각 섹션마다:

  • 명확한 제목
  • 짧은 문단
  • 시각 자료 — 다이어그램, 애니메이션 또는 인터랙티브 요소
  • (선택 사항) 궁금한 사람을 위한 "클릭하여 더 깊이 들어가기" 공개

이것이 페이지의 핵심입니다. 시각 자료가 페이지를 블로그 글과 다르게 만듭니다.

4. 일반적인 오해

사람들이 이 주제에 대해 자주 잘못 알고 있는 점을 다루는 짧은 섹션입니다. "오해: X / 현실: Y" 쌍으로 형식을 지정하세요.

5. 핵심 요약

1단계의 훅으로 다시 연결되는 한 문단입니다. 독자가 저녁 자리에서 반복할 수 있는 한 문장을 남겨주세요.

시각 스타일

  • 오프화이트 또는 따뜻한 흰색 배경 — 장시간 독서 시 순수 흰색보다 눈에 부담이 적음
  • 여유로운 타이포그래피 — 본문 텍스트 18-20px, 줄 높이 1.6+, 최대 너비 65ch
  • 하나의 강조 색상 — 하이라이트, 링크 및 각 다이어그램의 핵심 요소에 사용
  • SVG 다이어그램 — 모든 확대 수준에서 선명하며 CSS로 테마 지정 가능
  • 목적 있는 애니메이션, 장식이 아닌 — 시간에 따른 변화(진행 중인 프로세스, 성장하는 값, 반응하는 시스템)를 보여주기 위해 애니메이션을 사용하세요. 그냥 할 수 있다고 애니메이션을 넣지 마세요.
  • 도움이 되는 곳에 스크롤 기반 애니메이션 — 시퀀스 및 프로세스의 경우 독자가 속도를 제어할 수 있도록 스크롤 트리거 애니메이션을 사용하세요. 정적 다이어그램의 경우 스크롤 트리거를 건너뛰세요.

인터랙티브 요소 (페이지당 최대 2-3개 사용)

  • 슬라이더/범위 입력 — 매개변수를 조정하고 효과를 확인
  • 토글 — 두 상태 전환(있음/없음, 전/후)
  • 클릭 시 공개 — 궁금한 독자를 위한 추가 세부 정보
  • 단계별 애니메이션 — 독자의 속도에 맞춰 프로세스를 진행하는 "다음" 버튼

과용하지 마세요. 잘 디자인된 세 번의 인터랙티브 순간이 열 개의 장난감보다 낫습니다.

기술적 구현

단일 자체 포함 .html 파일로 explainer-[주제-슬러그].html로 저장합니다. 외부 의존성 없음 — 모든 글꼴을 임베드하고, SVG를 인라인으로 작성하며, 바닐라 JS만 사용합니다.

필수 사항:

  • 모바일 친화적 — 대부분의 독자가 휴대폰에서 스크롤할 것
  • 접근성 — 시맨틱 HTML, 다이어그램의 대체 텍스트, 키보드로 탐색 가능한 인터랙티브 요소
  • 빠른 로딩 — 즉시 열려야 하며, 스피너나 자산 로딩 지연이 없어야 함

콘텐츠 규칙

  1. 정의보다 비유로 시작하세요. "신경망은 함수 근사기입니다"는 정확하지만 쓸모없습니다. "신경망은 스스로 켜고 끄는 법을 배우는 디머 스위치 더미와 같습니다"가 유용합니다.
  2. 실제 숫자를 사용하세요. "대부분의 모기지는 30년 동안 지속됩니다"는 일반적입니다. "$500K 모기지 7% 금리로 30년 동안 $1.2M이 들며, 그중 $700K는 이자입니다"가 인상적입니다.
  3. 보여주고 말하지 마세요. "상상해 보세요..."라고 쓰고 있다면 다이어그램으로 보여줄 수 있는지 고려하세요.
  4. 억지로 재미를 만들지 마세요. 재치는 괜찮지만, 지나친 유머는 설명을 방해합니다. 목표는 명확성이지 오락이 아닙니다.
  5. 질문이나 시사점으로 끝내세요. 훌륭한 설명은 독자를 정보를 얻은 상태가 아니라 생각하게 만듭니다.

이렇게 만든 이유

긴 텍스트 설명은 훑어보고 잊기 쉽습니다. 슬라이드는 미묘한 차이를 표현하기에는 너무 압축적입니다. 스크롤 시각 페이지는 중간 지점에 있습니다: 내용이 풍부할 만큼 충분히 길고, 기억에 남을 만큼 시각적이며, 참여를 유도할 만큼 인터랙티브합니다. 잘 만들어진다면 독자가 스크린샷을 찍고 공유하게 만드는 형식입니다.

생성 후

사용자에게 알려주세요:

  1. 파일 경로
  2. 여는 방법
  3. 개선을 위해 요청할 수 있는 한 가지 구체적인 사항 (완료된 것이 아닙니다 — 설명의 초안은 대개 "X 섹션이 약하다"는 한 번의 수정이 필요합니다)
  4. 공유하는 방법 — 파일이 자체 포함되어 있으므로 이메일, Slack, 어디서나 호스팅할 수 있습니다.

관련 스킬