SHAP 모델 해석 스킬
SHAP으로 머신러닝 예측의 기여도를 올바르게 계산·검증·시각화하도록 Claude를 안내하는 스킬.
데이터·분석고급★ 33,030⑂ 3,248AI 점수 9/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
머신러닝 모델의 예측을 SHAP으로 설명할 때 흔히 틀리는 지점을 정리해 잡아주는 스킬입니다.
- 모델 종류(트리, 선형, 신경망, 임의 콜러블)에 맞는 익스플레이너와 마스커 선택 결정표 제공
- 최신
shap.ExplanationAPI 기준 코드 패턴, 다중 출력(다중 클래스) 슬라이싱 규칙(exp[..., 1]) base_values + values.sum()이 실제 모델 출력과 일치하는지 확인하는 가법성 검증 절차- 확률/로그오즈/로그로스 등 설명 대상 출력 공간을 명시하도록 강제
- 분석 질문별 시각화 매핑(bar, beeswarm, waterfall, scatter, heatmap, text/image)
- 오류 진단 순서, 리포트에 반드시 포함할 한계 항목(비인과성 명시 등)
- 신뢰할 수 없는 pickle/joblib 모델 로드 금지 등 안전 규칙
이런 분께 추천
- 모델 해석 결과를 보고서·심사·규제 문서에 제출해야 하는 데이터 사이언티스트
- 다중 클래스 분류에서 SHAP 배열 shape 때문에 매번 헤매는 분
- 트리 모델의 확률 공간 설명, interventional vs tree-path-dependent 차이를 정확히 다루고 싶은 분
- 텍스트/이미지 모델에 SHAP을 적용하려는 NLP·비전 엔지니어
활용 예시
- "RandomForest 이진 분류기의 테스트셋 SHAP 값을 계산하고, 양성 클래스만 골라 beeswarm과 개별 waterfall을 그려줘. 가법성 검증도 포함해서."
- "XGBoost 모델을 확률 공간에서 설명하고 싶은데 배경 데이터와 feature_perturbation 설정을 어떻게 해야 하는지 알려줘."
- "다중 클래스 모델의 SHAP 결과를 코호트별로 비교하고, 공정성 판단으로 오해되지 않도록 한계 문단까지 같이 작성해줘."
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/shap 폴더를 내 ~/.claude/skills/shap/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/shap ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 스킬 폴더가 없으면 만듭니다:
mkdir -p ~/.claude/skills - 저장소를 내려받습니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills - SHAP 스킬만 복사합니다:
cp -r /tmp/scientific-agent-skills/skills/shap ~/.claude/skills/ ls ~/.claude/skills/shap로 SKILL.md와 references 폴더가 있는지 확인합니다.- Python 환경을 준비합니다(권장):
uv venv --python 3.12 && source .venv/bin/activate && uv pip install "shap[plots]"— 문서가 지정한 0.52.0이 아직 없다면pip index versions shap로 실제 최신 버전을 확인해 설치하세요. - Claude Code를 다시 실행하고 "SHAP으로 이 모델 예측을 설명해줘"처럼 요청하면 스킬이 활성화됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT