소개
Claude Code ELI5라는 스킬이 X에서 눈에 들어왔습니다. 복잡한 주제를 배경지식이 없는 사람에게 큰 그림과 적은 글의 HTML로 설명해 주는 스킬이에요. 설치 방법보다 먼저 든 생각은 하나였습니다.
“이 정도로 짧은 스킬이라면 Claude Code에만 둘 필요가 있을까?”
그래서 원본을 Claude와 Codex가 함께 쓸 수 있게 바꾸고, 팀의 AITK에 배포해 봤습니다. 완성된 예시까지 공개 링크로 남겼어요.
Anthropic 직원이 공유한 10줄짜리 스킬
2026년 8월 21일, Claude Code 팀의 Thariq Shihipar가 Anthropic 내부에서 최근 자주 쓰던 스킬이라며 ELI5를 소개했습니다. 모듈의 동작 방식, 특정 선택을 한 이유, 장애 의 원인을 설명받을 때 활용한다고 했어요.
https://x.com/trq212/status/2090884854590382515
후속 게시물에서는 공식 플러그인으로 만들지 고민 중이며, 우선 Anthropic 커뮤니티 마켓에서 설치할 수 있다고 안내했습니다. Anthropic 직원이 공개한 스킬이지만 현재 기준 first-party 공식 플러그인으로 단정하면 안 됩니다. 설치 안내 게시물
공개된 SKILL.md는 10줄, 321바이트입니다. 별도의 MCP 서버나 실행 스크립트 없이 설명 대상과 출력 형식만 정해 둡니다. 핵심은 “이 주제를 처음 접하는 사람에게 큰 그림과 적은 글의 HTML로 설명한다”는 규칙이에요. Anthropic 커뮤니티 저장소
짧기 때문에 오히려 다른 AI 도구에도 옮길 수 있겠다고 봤습니다.
그대로 복사하면 두 군데에서 똑같이 작동할까
처음에는 원본 파일을 Codex 스킬 폴더에 복사하는 방법부터 살펴봤습니다. 하지만 원본에는 Claude Code에서 주제를 전달하는 $ARGUMENTS가 있고, 결과물도 Claude의 HTML artifact를 전제로 합니다.
파일 형식은 같아도 실행 환경이 달랐습니다. 두 플랫폼에 각각 다른 파일을 두면 업데이트할 때마다 내용이 갈라질 가능성도 있었어요.
제가 원한 건 복사본 두 개가 아니었습니다. 팀이 관리하는 원본 하나를 Claude Code와 Codex가 함께 불러오는 구조였습니다.
1단계 — Claude 전용 표현을 걷어냈습니다
실제로 Codex에 보낸 요청은 이랬습니다.
코덱스와 클로드 모두 사용할 수 있고, 우리 팀의 aitk로 배포할 수 있는 방법이 있는지 알아봐줘.원본의 역할은 유지하되 플랫폼에 묶인 부분만 바꿨습니다.
$ARGUMENTS대신 현재 사용자의 요청에서 주제를 가져옵니다.Claude artifact 대신 외부 패키지가 필요 없는 단일 HTML 파일을 만듭니다.
inline CSS와 SVG를 사용해 파일 하나만 공유해도 화면이 보이게 했습니다.
데스크톱과 모바일에서 읽을 수 있도록 반응형 검사를 규칙에 넣었습니다.
원저자, 출처, MIT 라이선스도
SKILL.md에 남겼습니다.
새 스킬 이름은 eli5-visual로 정했습니다. 기존 AITK에 있던 baby-education은 긴 비유와 단계별 설명에 더 가까웠기 때문에 바꾸지 않았어요. 한 장짜리 시각 설명은 별도 역할로 분리했습니다.
2단계 — AITK 원본 하나를 두 AI에 연결했습니다
AITK에는 플랫폼을 claude_code,codex로 지정해 팀 전용 private 스킬로 배포했습니다. 두 AI에 파일을 따로 복사하는 대신, 각 환경의 skill-suggest가 같은 AITK 원본을 검색해서 불러옵니다.
흐름은 단순합니다.
Claude ELI5 → 공용 SKILL.md → AITK 팀 도구함 → Claude Code·Codex배포된 스킬은 v1.0.0, published 상태입니다. 자연어 검색도 확인했습니다.
검색 문구 검색 점수 자동 추천 기준
eli5 visual html 0.637 0.40
그림으로 쉽게 설명해줘 0.538 0.40두 문구 모두 기준선을 넘었습니다. AITK 방식에서는 Claude의 /eli5나 Codex의 $eli5처럼 네이티브 명령을 기대하기보다 자연어로 요청하는 편이 안정적이었습니다.
3단계 — 배포한 스킬로 자기 자신을 설명시켰습니다
배포 성공만 확인하고 끝내면 실제로 쓸 만한지 알기 어렵습니다. 이번에는 AITK에서 eli5-visual을 다시 불러와 방금 한 작업을 설명해 달라고 했어요.
aitk의 eli5 사용해서 지금 진행한 내용을 설명해줘.결과는 한 장짜리 반응형 HTML이었습니다. 데스크톱 1440px과 모바일 390px에서 카드, 화살표, 플랫폼 영역을 확인했고 가로 넘침은 없었습니다.
그림이 잘 나왔다고 내용까지 자동으로 맞는 것은 아닙니다. ELI5는 전체 흐름을 잡는 첫 화면으로 쓰고, 세부 수치와 예외 조건은 원본 코드나 문서로 다시 확인하는 편이 맞습니다.
배포 구조가 어떻게 달라졌나
항목 이전 구조 공용 스킬 배포 후
원본 Claude 전용 프롬프트 공급자 중립 SKILL.md
주제 전달 $ARGUMENTS 현재 사용자 요청
결과물 Claude artifact 중심 자체 포함형 HTML 파일
지원 환경 Claude Code Claude Code·Codex
팀 관리 플랫폼별 복사 가능성 AITK 정본 한 개
검증 설치 여부 확인 검색 점수와 반응형 화면 확인소요 시간이 줄었다는 수치는 측정하지 않았습니다. 확실히 달라진 부분은 관리 방식입니다. 같은 설명 규칙을 두 AI에서 쓰면서 원본은 한 곳에서 관리할 수 있게 됐어요.
따라 할 때 먼저 알아둘 점
스킬 파일이 Markdown이라고 해서 모든 플랫폼에 그대로 복사하면 끝나는 건 아니었습니다. $ARGUMENTS, artifact, 전용 도구 이름처럼 특정 환경에 묶인 표현부터 찾아야 합니다.
AITK처럼 검색해서 불러오는 방식이라면 스킬 설명과 태그도 실행 조건의 일부입니다. 사람들이 실제로 말할 법한 “그림으로 쉽게”, “큰 그림과 적은 글”, “5살도 이해하게” 같은 표현을 넣어야 잘 찾아옵니다.
기존에 비슷한 스킬이 있는지도 먼저 확인해 보세요. 이름이 비슷하더라도 긴 튜토리얼과 한 장짜리 시각 설명은 쓰임이 다를 수 있습니다. 하나의 스킬에는 하나의 역할을 주는 편이 관리하기 편했습니다.
AI 활용 팁!
이 방식은 ELI5뿐 아니라 회의록 정리, 코드 리뷰, 장애 회고처럼 여러 AI 도구에서 같은 결과 형식을 유지하고 싶은 작업에도 적용할 수 있습니다. 공급자 전용 변수를 현재 요청이나 일반적인 파일 출력 규칙으로 바꾼 뒤, 팀 카탈로그에 정본을 두는 방식이에요.
바로 쓸 수 있는 프롬프트
Claude Code용
[스킬 이름]의SKILL.md를 읽고 Claude 전용 변수, artifact, 도구 의존성을 찾아줘. 핵심 역할은 유지하면서 Claude Code와 Codex가 함께 쓸 수 있는 공급자 중립 스킬로 바꾸고, AITK에 두 플랫폼용으로 배포해줘. 기존에 비슷한 팀 스킬이 있으면 역할이 겹치는지도 먼저 확인해줘.
[스킬 이름], 팀 공개 범위, 지원 플랫폼은 본인 환경에 맞게 바꾸세요.
