4-3. 같이 해보기 — 전처리 스킬 만들고 돌리기
이제 직접 합니다. 데이터 전처리 스킬을 하나 만들고, 실제 데이터에 돌리고, 한 장 리포트까지 발급받습니다. 사람이 하는 일은 매뉴얼 적기와 프롬프트 두 줄뿐이에요.
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가 알아서 처리합니다:
인코딩·날짜 타입 — utf-8-sig로 읽고, 202411 같은 정수 기준년월을 날짜 타입으로
포맷 불일치 잡기 — 인원수가 873446.0처럼 소수로 온 것을 정수로 바꾸고 로그에 남김
결측 점검 + 파생 컬럼 — 결측 비율 기록. 월 단위 데이터라 요일 대신 연도·월·분기 컬럼 생성 — 이 판단도 스킬이 알아서
자동 보고서 — 변환 로그와 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가, 기준과 확인은 사람이 — 이게 스킬로 일하는 방식입니다.