모듈 2 · CH04 클로드 스킬

4-3. 같이 해보기 — 전처리 스킬 만들고 돌리기

CH04 강의 영상 · 전체 10:44 · 이 페이지는 6:45부터

이제 직접 합니다. 데이터 전처리 스킬을 하나 만들고, 실제 데이터에 돌리고, 한 장 리포트까지 발급받습니다. 사람이 하는 일은 매뉴얼 적기와 프롬프트 두 줄뿐이에요.


1. 전처리 스킬 만들기 — 마크다운 한 장

우리 팀의 전처리 기준을 글로 적어 .claude/skills/data-preprocess/SKILL.md에 저장합니다. 이게 전부예요.

---
name: data-preprocess
description: raw CSV를 분석 가능한 상태로 다듬고, 무엇을 했는지 보고서로 남긴다.
---

# 전처리 규칙

1. CSV는 utf-8-sig 인코딩으로 읽고 저장한다
2. 날짜·숫자 컬럼은 타입을 변환한다 — 명세와 실제 포맷이 다르면 로그에 남긴다
3. 컬럼별 결측 비율을 계산해 기록한다
4. 분석 단위에 맞춰 요일·평일/주말·월 파생 컬럼을 만든다
5. 변환 로그와 before/after 통계를 preprocessing_report.html로 남긴다

다섯 줄짜리 규칙이지만, 이걸 적어두는 순간 누가 어떤 데이터를 가져와도 같은 기준으로 전처리가 돌아갑니다. 폴더 이름이 곧 명령어가 돼서 /data-preprocess로 직접 부를 수도 있고, 파일을 저장하면 Claude Code를 재시작하지 않아도 현재 세션에 바로 적용됩니다.

2. 데이터 준비 — 한국관광 데이터랩

데이터는 한국관광 데이터랩 (datalab.visitkorea.or.kr)에서 받습니다. 회원가입하면 지역별 방문자·체류 데이터를 CSV로 다운로드할 수 있어요. 라이브에서는 동해시 방문자 데이터를 씁니다. 가입이 늦어지면 자료실의 같은 파일로 바로 따라오세요.

3. 한 줄로 돌리기

"다운받은 동해시 방문자 CSV 전처리해줘."

이 한 줄에 스킬이 발동하고, Claude Code가 알아서 처리합니다:

1

인코딩·날짜 타입 — utf-8-sig로 읽고, 202411 같은 정수 기준년월을 날짜 타입으로

2

포맷 불일치 잡기 — 인원수가 873446.0처럼 소수로 온 것을 정수로 바꾸고 로그에 남김

3

결측 점검 + 파생 컬럼 — 결측 비율 기록. 월 단위 데이터라 요일 대신 연도·월·분기 컬럼 생성 — 이 판단도 스킬이 알아서

4

자동 보고서 — 변환 로그와 before/after가 담긴 preprocessing_report.html + 재실행 가능한 preprocess.py

4. 결과 확인 — 사람의 일

pandas 문법을 몰라도 됩니다. preprocessing_report.html을 열어 변환 로그를 읽고, "맞게 다듬었나"만 확인하면 돼요. 이상하면 한 줄 더 — "토요일만 따로 집계해줘" — 던지면 됩니다.

🧰
작은 스킬에서 큰 스킬로
오늘 만든 전처리 스킬이 파이프라인의 한 칸이 됩니다. 같은 방식으로 규칙을 쌓아가면, "동해시 분석해줘" 한 줄에 수집부터 리포트까지 돌아가는 스킬이 돼요.

5. 리포트까지 — 한 줄 더

전처리는 중간 결과물입니다. 4-2에서 플러그인으로 설치한 data-analysis-pipeline·4-report(예전 이름 popcorn-report) 스킬이 있으니, 한 줄만 더 던지면 끝까지 갑니다.

"전처리된 데이터로 분석하고, popcorn-report 스타일로 한 장 리포트 만들어줘."

함정 체크리스트를 거친 분석과 함께 매거진 리포트(report_*.html)가 나옵니다 — 4-2에서 봤던 그 끝그림을, 이번엔 여러분 데이터로 받은 거예요. 헤드라인·KPI 4개·차트·액션 카드까지 한 장에.

6. 스킬이 발동하지 않을 때

실습에서 막히면 공식 문서의 문제 해결 순서대로:

① 직접 호출

/data-preprocess로 이름을 직접 입력 — 가장 확실한 방법

② 등록 확인

"어떤 스킬을 쓸 수 있어?"라고 물어 목록에 나오는지 확인

③ description 보강

설명에 내가 실제로 말할 키워드("전처리", "CSV 다듬기")가 들어 있는지 확인

★ 핵심. 매뉴얼은 한 번 적고, 실행은 한 줄로. 코드 작성·실행·기록은 AI가, 기준과 확인은 사람이 — 이게 스킬로 일하는 방식입니다.

모듈 2 끝 · 다음 모듈
5-1 꼬리 질문으로 깊게 보기 — 첫 답은 출발점
이어보기 →