CLAUDE.md · Agent Skills — 반도체 실무 예제로
매주 하는 설명을 파일 한 장으로 바꿉니다.
CSV · Excel · PPT · GDS · RTL · TCAD
같은 설명을 두 번 했다면 파일로 옮길 때입니다. 늘 지킬 규칙은 CLAUDE.md에, 순서가 있는 업무는 Agent Skill에 담습니다.
오늘 대화에서 내가 두 번 이상 지적한 것만 골라 CLAUDE.md에 10줄 이내로 추가해줘. "깔끔하게" 같은 말 대신 숫자나 금지로 판정할 수 있게 써줘.
일이 어려워서 오래 걸리는 게 아닙니다. 규칙이 내 머릿속에만 있어서 매번 다시 설명해야 하기 때문입니다.
세션이 끝나면 사라집니다.
"이번엔 CMP 데이터만 봐줘"
세션을 열 때마다 자동으로 읽힙니다.
"두께는 Å 그대로, 변환 금지"
필요할 때만 펼쳐 읽고, 다른 폴더로 들고 다닙니다.
측정 CSV → 일일 리포트 6단계
작업 폴더 맨 위에 CLAUDE.md를 두면 Claude Code가 세션을 시작할 때 먼저 읽습니다. 신입에게 주는 첫날 안내문을 AI에게 써 두는 셈입니다.
다른 에이전트 도구는 AGENTS.md 같은 이름으로 같은 역할을 합니다.
📁 yield-analysis/ ← 수율 분석 작업 폴더 ├─ CLAUDE.md ← 매 세션 자동으로 읽힘 ├─ data/ ← 측정 CSV (읽기 전용) ├─ reports/ ← 결과물은 새 파일로 └─ .claude/skills/ ← 절차는 스킬로 (뒤에서)
# CLAUDE.md — CVD/Etch 일일 수율 분석 ## 이 폴더는 - 입력: data/*.csv (설비 표준 포맷, 맨 위 3줄은 헤더) - 결과: reports/ 아래 새 파일. data/는 읽기 전용 ## 규칙 - 두께 THK_A는 Å 그대로. 단위 변환 금지 - LOT_ID는 대문자로 통일해서 집계 - 사내 .xlsx·.pptx는 office-drm 스킬을 따른다 ## 완료 기준 - 보고에 "병합 행수 = 파일별 행수 합" 검산 결과 - 확인하지 않은 것은 "미확인"이라고 쓴다 ## 하지 말 것 - 실데이터를 사외 서비스에 붙여넣지 않는다
"깔끔하게" 대신 "Å 그대로", "대문자". 지켰는지 예·아니오로 답할 수 있어야 합니다.
AI가 친절하게 바꾸려 드는 곳(단위, 원본 파일)엔 "~금지"로 못 박습니다.
규칙 목록만. 길어지면 매 세션 자리를 차지합니다 — 긴 절차는 스킬로 뺍니다.
"방금 지적한 것 CLAUDE.md에 추가해줘" — 교훈이 파일에 쌓입니다.
매일 옆에 앉아 처음부터 설명하지 않습니다. 정리된 매뉴얼 한 부를 주고, 모르면 펴 보게 합니다.
"이 일은 언제 하고, 순서는 이렇고, 이 함정을 조심해."
그 매뉴얼을 SKILL.md라는 텍스트 파일로 씁니다.
관련 요청이 오면 AI가 스스로 꺼내 읽고 그대로 일합니다. 나도, 동료도, 후임도 같은 품질.
📁 csv-report/ ├─ SKILL.md ← 매뉴얼 본문 (필수) ├─ scripts/ │ └─ merge_csv.py ← 검증된 스크립트 (선택) └─ references/ └─ spec_table.md ← 스펙 표 (선택)
--- SKILL.md 맨 위 (이름표) --- name: csv-report description: 설비 측정 CSV들을 병합해 일일 수율 리포트(HTML)를 만든다. "측정 리포트", "CSV 취합" 요청 시 사용. --- 본문 (업무 매뉴얼) --- 1. data/*.csv 를 모두 읽는다 (헤더 3줄 스킵) 2. LOT_ID 대문자 통일, THK는 Å 그대로 3. 스펙 판정: references/spec_table.md 4. 결과는 새 HTML 파일로
두는 곳: 이 폴더 전용은 .claude/skills/<이름>/, 어디서나 쓸 것은 ~/.claude/skills/<이름>/. 메모장으로 쓸 수 있는 글이라 AI가 대신 써 줄 수도 있습니다.
평소에는 이름표만 읽어 둡니다 — 매뉴얼 100권이 꽂혀 있어도 부담이 없습니다.
"D:\meas 폴더 CSV 합쳐줘. 헤더 3줄 스킵하고, LOT_ID 대문자로, THK는 Å 단위 그대로, CVD 스펙 450±30 / Etch 1200±80으로 판정하고, 엑셀은 그냥 열면 깨지니까 xlwings로, 파일명은 report_YYMMDD.html로…"
규칙 하나를 빠뜨리면 다시 설명하고 다시 돌립니다. 품질이 그날의 기억력에 달려 있습니다.
"어제 측정 리포트 뽑아줘"
AI가 csv-report 스킬을 찾아 펼치고, 그 안의 규칙대로 실행합니다. 누가 시켜도 같은 결과.
skill-creator 스킬로 새 스킬을 만들어줘. 업무: 매일 아침 설비별 측정 CSV(D:\meas\*.csv)를 병합해 일일 리포트를 만든다. 규칙: 헤더 3줄 스킵, LOT_ID 대문자, THK는 Å, 스펙 판정은 CVD 450±30. 주의: 회사 엑셀 파일은 DRM 때문에 xlwings로만 연다.
준비할 것은 코드가 아니라 업무 설명입니다. skill-creator가 없으면 /plugin install skill-creator@claude-plugins-official 로 설치하거나, "SKILL.md 형식으로 만들어줘"라고만 해도 됩니다.
"측정 리포트", "CSV 취합"처럼 내가 실제로 쓰는 말을 넣어야 AI가 알아서 꺼냅니다.
"적당히 정리" ❌ → "LOT_ID는 대문자, 소수점 1자리" ⭕
"병합 행수 = 파일별 합계, 다르면 중단" — AI가 스스로 이상을 잡고 멈춥니다.
"이 엑셀은 DRM이라 xlwings 필수", "금요일 파일은 컬럼 하나 더" — 고생한 기억이 자산이 됩니다.
| CLAUDE.md | Agent Skill | |
|---|---|---|
| 언제 읽나 | 세션을 열 때마다 항상 | 요청이 description과 맞을 때만 |
| 어디에 적용 | 그 폴더 (개인용은 ~/.claude/) | 폴더째 들고 다니며 어디서나 |
| 담는 것 | 짧은 규칙 · 금지 · 완료 기준 | 절차 + 스크립트 · 템플릿 · 참고 표 |
| 알맞은 길이 | 한 화면 이내 | 길어도 됨 — 평소엔 이름표만 읽힘 |
| 반도체 예 | "두께는 Å 그대로", "data/ 읽기 전용" | csv-report · drm-excel · weekly-ppt |
둘은 함께 씁니다. CLAUDE.md에 "사내 엑셀은 office-drm 스킬을 따른다" 한 줄을 적어 두면 규칙과 절차가 이어집니다.
MCP 연결과 예약 실행은 내 도구가 혼자 돌게에서 다룹니다. 사내망에선 사외 서비스용 MCP가 막힌 경우가 많습니다.
사내 문서는 DRM으로 암호화되어 있어, 파일을 직접 읽는 라이브러리(pandas·openpyxl)에게는 암호문 덩어리로 보입니다.
Excel·PowerPoint·Word 앱은 해독 권한이 있으니 xlwings·win32com으로 앱을 조종해 읽고 씁니다. 우회가 아니라 정식 경로입니다.
| 대상 | 상황 | 쓸 도구 | 메모 |
|---|---|---|---|
| 📊 엑셀 (.xlsx) | 기존 파일 읽기·수정 | xlwings 또는 win32com | Excel 앱이 DRM 해독 |
| 🖼️ 파워포인트 (.pptx) | 기존 파일 읽기·수정 | win32com | PowerPoint 앱 경유 |
| 📄 워드 (.docx) | 기존 파일 읽기·수정 | win32com | Word 앱 경유 |
| ✨ 위 문서들 | 새로 만들기 | 라이브러리 자유 | openpyxl · python-pptx · python-docx |
| 🧩 레이아웃 (.gds) | 읽기·검사·수정 | klayout (pya) | GDSII/OASIS 표준 도구 |
| 📈 CSV · 로그 · 텍스트 | 모두 | pandas 등 자유 | DRM 없음 |
외우실 필요 없습니다 — 이 표를 그대로 스킬에 넣습니다.
# office-drm/SKILL.md (발췌) name: office-drm description: 사내 엑셀/PPT/워드 파일을 읽거나 수정할 때의 필수 규칙. Office 문서 작업 전 참조. ## 철칙 - 기존 .xlsx: xlwings 또는 win32com만. pandas.read_excel / openpyxl로 열기 금지 - 기존 .pptx/.docx: win32com만 - 새 파일 생성: 라이브러리 자유 - 작업 후 반드시 앱 종료(quit) — 잠금 해제 - DRM 해제·변환 시도 금지
누가 "수율 엑셀 정리해줘"라고 하든 AI가 처음부터 xlwings 경로를 탑니다. 실패 후 재시도가 없습니다.
"그거 pandas로 열면 안 돼요" — 선배에게 듣던 요령이 버전 관리되는 파일이 됩니다.
표준 CSV → 일일 수율·트렌드 리포트
pandas · 자유수율 관리 대장 읽고 기입
xlwings지난주 장표 복제 + 표·차트 갱신
win32com변경점 반영 + 개정 이력 추가
win32com셀·레이어 통계, 밀도, 간단 룰 체크
klayout포트 요약, 테스트벤치 초안
텍스트 · iverilog입력덱 스윕 + I-V 추출
텍스트 덱 · CSV실습 시간에 직접 만듭니다
skill-creator모든 예제는 agent-skills/skills/ 폴더에 완성본으로 들어 있습니다. 값·경로는 연습용 가상 값입니다.
설비가 내보내는 표준 포맷 CSV(랏, 웨이퍼, 두께, 균일도…)를 병합해 스펙 판정 + 트렌드 차트를 담은 HTML 리포트를 만듭니다.
# csv-report/SKILL.md (발췌) description: 표준 측정 CSV 병합→일일 리포트. "측정 리포트", "CSV 취합", "수율 정리" 시 사용 ## 절차 1. 대상 폴더의 *.csv 로드 — 헤더 3줄 스킵 2. LOT_ID 대문자, 날짜는 YYYY-MM-DD 통일 3. 스펙 판정: references/spec_table.md 4. 산출물: report_YYMMDD.html (새 파일 → 자유) ## 검증 - 병합 행수 = 파일별 행수 합 (다르면 중단·보고)
"헤더 3줄", "대문자" 같은 규칙이 코드가 아니라 한국어 문장으로 들어 있습니다.
행수 검산이 스킬에 있어서 AI가 스스로 이상을 잡고 멈춥니다.
# ❌ 스킬이 없을 때 AI가 하는 실수 import pandas as pd df = pd.read_excel("수율대장.xlsx") → 에러 또는 깨진 값: DRM 암호문을 직접 읽으려다 실패
# ✅ drm-excel 스킬이 시키는 방법 import xlwings as xw app = xw.App(visible=False) wb = app.books.open(r"수율대장.xlsx") # Excel이 해독 data = wb.sheets["주간"].range("A1").expand().value ... wb.save(); wb.close(); app.quit() # 잠금 해제
# drm-excel/SKILL.md 핵심 규칙 (발췌)
- 기존 사내 xlsx는 xlwings(또는 win32com)로 Excel 앱을 거쳐 연다
- 끝나면 반드시 quit() — 안 하면 파일이 잠긴 채 남는다
- 셀은 range().expand().value로 한 번에 (한 칸씩 루프 금지 — 매우 느림)
- 저장 전 백업 사본, 수정한 셀 주소를 로그로 남긴다
지난주 파일 복사 → 날짜 바꾸기 → 표 숫자 갱신 → 차트 데이터 교체. 양식은 그대로, 내용만 이번 주.
# weekly-ppt/SKILL.md (발췌) description: 주간보고 PPT 갱신. "주간보고", "위클리 장표" 요청 시. 기존 pptx는 win32com만 ## 절차 1. 지난주 파일을 이번 주 이름으로 복사 (원본 불변) 2. win32com으로 PowerPoint 열기 3. 슬라이드 2 제목의 주차 갱신 (W29 → W30) 4. 슬라이드 3 표: 이번 주 집계로 교체 5. 슬라이드 4 차트: 내장 엑셀도 COM으로 갱신 ## 검증 - 표 합계 = 원본 CSV 집계와 일치 확인
디자인을 코드로 다시 만들지 않습니다. 복사 후 값만 교체하니 팀 양식이 그대로 남습니다.
PPT 차트 안에는 작은 엑셀이 숨어 있습니다. 이것도 COM으로 — 이런 디테일이 스킬에 적혀 있어야 합니다.
# spec-doc/SKILL.md (발췌) description: 공정 사양서(.docx) 개정. "사양서 업데이트", "스펙 문서 반영" 시 사용 ## 절차 1. 원본 복사 → _revN 파일로 작업 (원본 보존) 2. win32com으로 Word 열기 3. 바꿀 파라미터를 표에서 찾아 값 교체 — 찾아 바꾸기가 아니라 표 위치로 (오치환 방지) 4. '개정 이력' 표에 행 추가: 날짜/항목/사유/작성자 5. 바뀐 문장은 강조 표시 (검토자용) ## 검증 - 바뀐 곳 목록을 보고 → 사람이 승인한 뒤 저장
개정 이력, 강조 표시, 승인 후 저장 — 팀의 문서 관리 규정이 그대로 스킬 절차가 됩니다.
"보고 → 승인 → 저장"을 적어 두면 AI가 묻고 나서 저장합니다. 스킬은 지시일 뿐이니, 확실히 막으려면 권한 설정도 함께.
레이아웃 .gds는 엑셀로도 메모장으로도 못 엽니다. 오픈소스 KLayout의 파이썬 모듈이 정답입니다.
# gds-inspect/SKILL.md (발췌) description: GDS/OASIS 레이아웃 검사·통계. "GDS 열어줘", "레이어 면적", "밀도 체크" 시 사용 ## 절차 (pip install klayout) import klayout.db as db ly = db.Layout(); ly.read("chip.gds") - 셀 트리·인스턴스 수 요약 (top cell부터) - 레이어별 도형 수·면적 → 표로 - 좌표 단위는 dbu! ly.dbu를 곱해 µm로 변환 ## 금지 - GDS 바이너리를 직접 파싱하는 코드 작성 금지
테스트 패턴 면적 집계, 레이어 커버리지 리포트, 룰 위반 후보 거르기, 리비전 간 레이아웃 비교.
KLayout 좌표는 정수 dbu(흔히 1nm). µm로 착각하면 천 배 틀립니다 — 스킬에 적을 1순위.
※ CMOS 인버터를 단순화한 그림 — 레이어 번호(layer/datatype)별로 도형이 쌓인 파일이 GDS입니다. 스킬은 이 도형들을 숫자(면적·개수·밀도)로 바꿔 줍니다.
# rtl-helper/SKILL.md (발췌) description: Verilog RTL 분석·문서화·TB 생성. "포트 요약", "테스트벤치 만들어줘", "린트" 시 사용 ## 할 수 있는 일 1. 모듈 포트/파라미터 표 추출 → 설계 문서용 2. 셀프체킹 테스트벤치 뼈대 생성 - clk/rst 생성, 시나리오 주석 자리 3. 사내 코딩룰 체크: references/lint_rules.md - latch 추론 금지, always @(*) 누락, 폭 불일치 ## 검증 - iverilog가 있으면 컴파일까지 돌려 문법 확인 - 합성·타이밍 판단은 하지 않는다 — EDA 툴 영역
수백 줄 RTL에서 포트 표를 뽑아 사양서(예제 4)로 — 스킬은 서로 이어 쓸 수 있습니다.
귀찮은 클럭·리셋·파형 덤프 뼈대는 AI가. 시나리오 설계는 여전히 엔지니어의 일.
"타이밍 판단 금지" — AI가 하지 말아야 할 일도 매뉴얼에 적습니다.
# tcad-sweep/SKILL.md (발췌) description: TCAD 입력덱 파라미터 스윕 생성과 결과(I-V) 추출·요약. "스플릿 돌려줘", "Vth 뽑아줘" 시 사용 ## 규칙 - 템플릿 복사 후 자리표시자만 치환 (물리 모델 줄은 수정 금지) - 스윕 조건은 sweep_plan.csv 한 곳에서만 · 결과 파일명 = 조건 조합 (tox12_nd5e17.csv) - Vth 추출법은 정전류법(Id=100nA×W/L)으로 통일 — 사람마다 다르면 비교 불가 - 라이선스·큐 제출 명령은 references/cluster.md 참조
시뮬레이터는 그대로 씁니다. 스킬이 맡는 건 그 앞뒤의 덱 생성과 결과 정리입니다.
시뮬 출력에서 Vg, Id를 뽑아 표준 CSV로 — 예제 1이 그대로 받는 형식입니다.
tox별 Vth·SS·Ion/Ioff를 표로 만들어 엑셀 대장(예제 2)에 기입합니다.
TCAD 스윕 → CSV 리포트 → 엑셀 대장 → 주간 PPT. 낱개 스킬이 업무 한 줄이 됩니다.
pip install pandas matplotlib # 미션 1·2는 이것만 # DRM 엑셀·PPT 예제까지: Windows + Office PC에서 pip install xlwings pywin32 # GDS 예제: pip install klayout
📁 내 작업 폴더/ ├─ .claude/skills/csv-report/ ← 스킬 폴더째 └─ sample_data/ ← CSV 3개 (36행)
지금 쓸 수 있는 스킬 목록을 보여줘.
연습 데이터는 모두 가짜 값입니다 — 사내 데이터 없이 실습합니다.
배우는 것: 스킬 발동 → 실행 → 검산의 한 바퀴
sample_data 폴더 측정 CSV로 일일 리포트 뽑아줘
배우는 것: 스킬은 코드가 아니라 고칠 수 있는 문서
csv-report/references/spec_table.md에서 균일도 상한 3.0 → 3.5로 바꾸고 같은 요청을 다시 합니다.
🔁 반복되나요?매일·매주·랏마다 다시 하는 일인가
📜 규칙을 말로 설명할 수 있나요?신입에게 문서로 가르칠 수 있는 절차가 있는가
🗃️ 입력과 출력이 파일·데이터인가요?CSV, 엑셀, PPT, GDS, 로그, 코드… (회의·협상은 아님)
버튼을 눌러 보세요
규칙 몇 줄 → CLAUDE.md · 순서 있는 절차 → 스킬
skill-creator로 새 스킬을 만들어줘. 내가 매주 하는 일은 ○○이야. 입력 파일은 ○○, 결과물은 ○○이야. 빠진 규칙은 나한테 하나씩 물어봐줘.
실데이터 대신 sample_data나 가짜 값으로 만듭니다.
텍스트라 git에 그대로 올라갑니다. "왜 이 규칙이 생겼나"가 커밋으로 남아 담당자가 바뀌어도 살아남습니다.
코드 리뷰는 어려워도 매뉴얼 리뷰는 누구나 합니다 — "이 스펙 바뀌었어요", "이 함정도 추가해요".
Claude Code의 /plugin 마켓플레이스, skills.sh 같은 공개 목록(제3자 · Anthropic 공식 아님), GitHub 저장소.
SKILL.md는 AI가 그대로 따르는 지시문이고, scripts/는 실제로 실행되는 코드입니다. 출처 불명 스킬은 프롬프트 인젝션의 통로가 됩니다.
브레인스토밍·체계적 디버깅 같은 검증된 작업 절차를 모은 스킬 모음 (제3자 · obra/superpowers).
💸 다단계 절차·서브에이전트를 불러 작업당 토큰 ↑
내 노하우를 SKILL.md로 뽑아내는 스킬. 오늘 미션 3에서 쓴 것.
🟢 만들 때만 잠깐 — 평소 비용은 거의 없음
웹 화면을 직접 열고 보며 검증합니다. 이 덱의 화면 검사도 이 방식입니다.
💸 조작마다 화면 정보가 대화에 들어가 토큰 ↑↑
쓴 만큼 내는 요금제라면 필요할 때만 켜고, 끝나면 끕니다. 그래도 핵심은 같습니다 — 생각하고 → 만들고 → 눈으로 확인.
회사 기밀·실데이터는 사내 승인 도구에서만 — 애매하면 넣지 않는다.
API 키·비밀번호는 코드·대화·커밋에 남기지 않는다 — 새어 나갔다면 삭제가 아니라 재발급.
회사 정책이 이 자료보다 우선한다.
DRM은 우회 대상이 아닙니다. xlwings·win32com은 권한 있는 앱을 통한 정식 경로입니다. 해제·변환 시도는 스킬에 '금지'로 적어 둡니다.
보고서에 서명하는 건 사람입니다. 스킬이 검산을 해도 결과물은 눈으로 확인한 뒤 냅니다.
자세한 내용은 → 사내 환경에서의 AI — 보안과 거버넌스
코드는 AI가 씁니다. 일하는 법을 아는 사람이 매뉴얼을 쓰면 됩니다.
함께 보기: AI에게 일 시키는 법 · 컨텍스트 · 내 도구가 혼자 돌게 · 슬라이드 자료 만들기 · 보안과 거버넌스