시리즈 홈
SEMINAR · CLAUDE.md × AGENT SKILLS

내 노하우를
AI에게 물려주는 법

CLAUDE.md · Agent Skills — 반도체 실무 예제로

매주 하는 설명을 파일 한 장으로 바꿉니다.
CSV · Excel · PPT · GDS · RTL · TCAD

YIELD --.-% ▲ 클릭하면 다음 랏을 판정합니다
3분 요약 · TL;DR

결론부터 — 이 세 줄이면 됩니다

같은 설명을 두 번 했다면 파일로 옮길 때입니다. 늘 지킬 규칙은 CLAUDE.md에, 순서가 있는 업무는 Agent Skill에 담습니다.

  1. 1
    두 번 한 지적은 CLAUDE.md에 한 줄로세션을 열 때마다 자동으로 읽힙니다. 짧게, 숫자로 판정할 수 있게 씁니다.
  2. 2
    반복 업무 절차는 스킬 폴더로 — description이 호출 버튼내가 실제로 쓰는 말을 넣어야 AI가 알아서 꺼내 씁니다. 초안은 skill-creator에게 맡깁니다.
  3. 3
    첫 스킬은 우리 환경 규칙 — DRM 파일은 xlwings·win32com반복되고 · 말로 설명되고 · 파일이 오가는 일이라면 스킬 후보입니다.
지금 바로 써 보는 프롬프트
오늘 대화에서 내가 두 번 이상 지적한 것만 골라
CLAUDE.md에 10줄 이내로 추가해줘.
"깔끔하게" 같은 말 대신 숫자나 금지로 판정할 수 있게 써줘.
이럴 때 이 덱을 다시 펼치세요
  • 같은 설명을 매주 AI에게 반복하고 있을 때
  • 사내 DRM 엑셀·PPT가 AI 코드로 깨질 때
  • 내 노하우를 팀 표준으로 남기고 싶을 때
PROBLEM · 어느 공정 엔지니어의 화요일

판단은 5분, 나머지는 매주 같은 손일입니다

  • 08:30 📥 설비 12대의 측정 CSV를 하나로 모은다 40분
  • 09:10 🔒 DRM 걸린 수율 엑셀에 어제 값을 손으로 옮긴다 30분
  • 09:40 📊 트렌드 차트를 다시 그려 그룹장에게 메일 25분
  • 10:05 🖼️ 주간보고 PPT의 표·그래프를 지난주 양식대로 갱신 45분
  • 매주 같은 일, 같은 순서, 같은 양식 주 4시간+

일이 어려워서 오래 걸리는 게 아닙니다. 규칙이 내 머릿속에만 있어서 매번 다시 설명해야 하기 때문입니다.

THE LADDER · 말 → CLAUDE.md → Skill

두 번 한 설명은 파일로 승격합니다

① 대화

이번 한 번만 필요한 지시

세션이 끝나면 사라집니다.

"이번엔 CMP 데이터만 봐줘"

② CLAUDE.md

이 폴더에서 늘 지킬 규칙

세션을 열 때마다 자동으로 읽힙니다.

"두께는 Å 그대로, 변환 금지"

③ Agent Skill

순서가 있는 업무 절차 + 도구

필요할 때만 펼쳐 읽고, 다른 폴더로 들고 다닙니다.

측정 CSV → 일일 리포트 6단계

승격 신호 — 같은 지적을 두 번 했다면 CLAUDE.md 한 줄로. 같은 절차를 세 번 설명했다면 스킬로.
② CLAUDE.md

CLAUDE.md는 세션마다 자동으로 읽히는 안내문입니다

작업 폴더 맨 위에 CLAUDE.md를 두면 Claude Code가 세션을 시작할 때 먼저 읽습니다. 신입에게 주는 첫날 안내문을 AI에게 써 두는 셈입니다.

  • 📁 폴더의 CLAUDE.md — 이 업무 규칙, 팀과 공유
  • 🏠 ~/.claude/CLAUDE.md — 내 개인 습관
  • ⚡ /init 초안 생성 · /memory 바로 고치기

다른 에이전트 도구는 AGENTS.md 같은 이름으로 같은 역할을 합니다.

📁 yield-analysis/   ← 수율 분석 작업 폴더
├─ CLAUDE.md        ← 매 세션 자동으로 읽힘
├─ data/            ← 측정 CSV (읽기 전용)
├─ reports/         ← 결과물은 새 파일로
└─ .claude/skills/  ← 절차는 스킬로 (뒤에서)
② CLAUDE.md · 예문

좋은 CLAUDE.md는 숫자와 금지로 씁니다

# CLAUDE.md — CVD/Etch 일일 수율 분석

## 이 폴더는
- 입력: data/*.csv (설비 표준 포맷, 맨 위 3줄은 헤더)
- 결과: reports/ 아래 새 파일. data/는 읽기 전용

## 규칙
- 두께 THK_A는 Å 그대로. 단위 변환 금지
- LOT_ID는 대문자로 통일해서 집계
- 사내 .xlsx·.pptx는 office-drm 스킬을 따른다

## 완료 기준
- 보고에 "병합 행수 = 파일별 행수 합" 검산 결과
- 확인하지 않은 것은 "미확인"이라고 쓴다

## 하지 말 것
- 실데이터를 사외 서비스에 붙여넣지 않는다

🔍 판정할 수 있게

"깔끔하게" 대신 "Å 그대로", "대문자". 지켰는지 예·아니오로 답할 수 있어야 합니다.

🚫 금지가 힘이 셉니다

AI가 친절하게 바꾸려 드는 곳(단위, 원본 파일)엔 "~금지"로 못 박습니다.

✂️ 한 화면 안으로

규칙 목록만. 길어지면 매 세션 자리를 차지합니다 — 긴 절차는 스킬로 뺍니다.

🔁 두 번 지적하면 한 줄 추가

"방금 지적한 것 CLAUDE.md에 추가해줘" — 교훈이 파일에 쌓입니다.

③ AGENT SKILL

Agent Skill은 사수가 물려주는 업무 매뉴얼입니다

🧑‍🏫 신입에게 일을 가르칠 때

매일 옆에 앉아 처음부터 설명하지 않습니다. 정리된 매뉴얼 한 부를 주고, 모르면 펴 보게 합니다.

"이 일은 언제 하고, 순서는 이렇고, 이 함정을 조심해."

🤖 AI에게 일을 가르칠 때

그 매뉴얼을 SKILL.md라는 텍스트 파일로 씁니다.

관련 요청이 오면 AI가 스스로 꺼내 읽고 그대로 일합니다. 나도, 동료도, 후임도 같은 품질.

스킬 = 발동 조건(언제) + 절차(어떻게) + 도구(스크립트·참고 자료)를 담은 폴더
③ AGENT SKILL · 구조

스킬의 실체는 폴더 하나와 텍스트 파일입니다

📁 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가 대신 써 줄 수도 있습니다.

③ AGENT SKILL · 클릭해 보세요

AI는 매뉴얼을 필요할 때만 펼칩니다

📇 이름표 — csv-report: 측정 CSV 병합·일일 리포트 생성…
📖 SKILL.md 본문 — ① CSV 읽기(헤더 3줄 스킵) ② LOT_ID 정규화 ③ 스펙 판정 ④ HTML 리포트…
🧰 부록 — scripts/merge_csv.py 실행 · references/spec_table.md 참조

평소에는 이름표만 읽어 둡니다 — 매뉴얼 100권이 꽂혀 있어도 부담이 없습니다.

BEFORE / AFTER · 탭을 눌러 보세요

스킬이 있으면 긴 설명이 한 줄 요청이 됩니다

💬 나 → AI (매번, 전 항목을 기억해서)
"D:\meas 폴더 CSV 합쳐줘. 헤더 3줄 스킵하고, LOT_ID 대문자로,
THK는 Å 단위 그대로, CVD 스펙 450±30 / Etch 1200±80으로 판정하고,
엑셀은 그냥 열면 깨지니까 xlwings로, 파일명은 report_YYMMDD.html로…"
설명 길이
약 1,000자 × 매번

규칙 하나를 빠뜨리면 다시 설명하고 다시 돌립니다. 품질이 그날의 기억력에 달려 있습니다.

💬 나 → AI
"어제 측정 리포트 뽑아줘"
설명 길이
한 줄 — 규칙은 스킬이 기억

AI가 csv-report 스킬을 찾아 펼치고, 그 안의 규칙대로 실행합니다. 누가 시켜도 같은 결과.

MAKING SKILLS

스킬은 직접 쓰지 말고 skill-creator에게 인터뷰받으세요

🗣️내 업무를 말로 설명skill-creator가 빠진 규칙을 되물음
▶
📝SKILL.md 초안 생성폴더 구조·이름표·본문까지
▶
🔁실전에 써 보며 다듬기틀린 곳을 알려 주면 매뉴얼이 고쳐짐
💬 이렇게 시작하면 됩니다
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 형식으로 만들어줘"라고만 해도 됩니다.

QUALITY CHECKLIST

좋은 스킬은 신입이 읽고 바로 따라 하는 매뉴얼입니다

  • ① description = 발동 조건

    "측정 리포트", "CSV 취합"처럼 내가 실제로 쓰는 말을 넣어야 AI가 알아서 꺼냅니다.

  • ② 규칙은 애매함 없이

    "적당히 정리" ❌ → "LOT_ID는 대문자, 소수점 1자리" ⭕

  • ③ 검산 방법을 적는다

    "병합 행수 = 파일별 합계, 다르면 중단" — AI가 스스로 이상을 잡고 멈춥니다.

  • ④ 함정·제약을 기록한다

    "이 엑셀은 DRM이라 xlwings 필수", "금요일 파일은 컬럼 하나 더" — 고생한 기억이 자산이 됩니다.

처음부터 완벽할 필요는 없습니다 — 스킬은 쓰면서 고치는 문서입니다.
COMPARE

늘 지킬 규칙은 CLAUDE.md, 순서 있는 업무는 Skill

CLAUDE.mdAgent Skill
언제 읽나세션을 열 때마다 항상요청이 description과 맞을 때만
어디에 적용그 폴더 (개인용은 ~/.claude/)폴더째 들고 다니며 어디서나
담는 것짧은 규칙 · 금지 · 완료 기준절차 + 스크립트 · 템플릿 · 참고 표
알맞은 길이한 화면 이내길어도 됨 — 평소엔 이름표만 읽힘
반도체 예"두께는 Å 그대로", "data/ 읽기 전용"csv-report · drm-excel · weekly-ppt

둘은 함께 씁니다. CLAUDE.md에 "사내 엑셀은 office-drm 스킬을 따른다" 한 줄을 적어 두면 규칙과 절차가 이어집니다.

ECOSYSTEM

확장은 불편이 쌓인 뒤 하나씩 붙입니다

📝CLAUDE.md늘 기억할 규칙
📚Skills필요할 때 펼치는 절차
🔌MCP사내 시스템·브라우저 같은 바깥 도구 연결
📦Plugins명령어·스킬·MCP 묶음 — /plugin으로 한 번에 설치
기본 상태로 써 본다어디서 잘하고 어디서 틀리는지
▶
불편·실패를 적어 둔다같은 지적, 같은 설명
▶
그때 하나씩 추가남의 세팅 복사가 아니라 내 업무에 맞게

MCP 연결과 예약 실행은 내 도구가 혼자 돌게에서 다룹니다. 사내망에선 사외 서비스용 MCP가 막힌 경우가 많습니다.

OUR ENVIRONMENT · 왜?

사내 엑셀은 직접 읽으면 깨지고, 앱을 거치면 열립니다

🤖pandas /
openpyxl
📄🔒
🗂️회사 xlsx
(DRM 암호화)
❌ 깨진 파일
🤖xlwings /
win32com
📄
🪟실행 중인
Excel 앱
✅ 정상 접근

사내 문서는 DRM으로 암호화되어 있어, 파일을 직접 읽는 라이브러리(pandas·openpyxl)에게는 암호문 덩어리로 보입니다.

Excel·PowerPoint·Word 앱은 해독 권한이 있으니 xlwings·win32com으로 앱을 조종해 읽고 씁니다. 우회가 아니라 정식 경로입니다.

HOUSE RULES

사내 파일은 이 표대로만 다룹니다

대상상황쓸 도구메모
📊 엑셀 (.xlsx)기존 파일 읽기·수정xlwings 또는 win32comExcel 앱이 DRM 해독
🖼️ 파워포인트 (.pptx)기존 파일 읽기·수정win32comPowerPoint 앱 경유
📄 워드 (.docx)기존 파일 읽기·수정win32comWord 앱 경유
✨ 위 문서들새로 만들기라이브러리 자유openpyxl · python-pptx · python-docx
🧩 레이아웃 (.gds)읽기·검사·수정klayout (pya)GDSII/OASIS 표준 도구
📈 CSV · 로그 · 텍스트모두pandas 등 자유DRM 없음

외우실 필요 없습니다 — 이 표를 그대로 스킬에 넣습니다.

RULES → SKILL

이 규칙 표가 첫 번째 스킬이 됩니다

# 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로 열면 안 돼요" — 선배에게 듣던 요령이 버전 관리되는 파일이 됩니다.

FIELD EXAMPLES

반도체 실무 예제 7종 — 완성본이 저장소에 있습니다

📈

1. 측정 CSV 리포트

표준 CSV → 일일 수율·트렌드 리포트

pandas · 자유
🔒

2. DRM 엑셀 대장

수율 관리 대장 읽고 기입

xlwings
🖼️

3. 주간보고 PPT

지난주 장표 복제 + 표·차트 갱신

win32com
📄

4. Word 사양서

변경점 반영 + 개정 이력 추가

win32com
🧩

5. GDS 레이아웃 검사

셀·레이어 통계, 밀도, 간단 룰 체크

klayout
⚡

6. RTL / Verilog

포트 요약, 테스트벤치 초안

텍스트 · iverilog
🧪

7. TCAD 스윕

입력덱 스윕 + I-V 추출

텍스트 덱 · CSV
➕

8. 여러분의 업무

실습 시간에 직접 만듭니다

skill-creator

모든 예제는 agent-skills/skills/ 폴더에 완성본으로 들어 있습니다. 값·경로는 연습용 가상 값입니다.

예제 1

측정 CSV 리포트 — 검산까지 스킬에

새 파일 = 라이브러리 자유

설비가 내보내는 표준 포맷 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가 스스로 이상을 잡고 멈춥니다.

예제 1

요청은 한 줄, 검산 로그는 자동으로

▶ 자동 재생
Claude Code — 일일 측정 리포트
예제 2

DRM 엑셀 — pandas는 깨지고 xlwings는 열린다

기존 파일 = xlwings
# ❌ 스킬이 없을 때 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로 한 번에 (한 칸씩 루프 금지 — 매우 느림)
- 저장 전 백업 사본, 수정한 셀 주소를 로그로 남긴다
예제 2

백업 → 기입 → quit()까지 스킬이 챙긴다

▶ 자동 재생
Claude Code — DRM 엑셀 대장
예제 3

주간보고 PPT — 지난주 파일에 값만 바꾼다

기존 파일 = win32com

지난주 파일 복사 → 날짜 바꾸기 → 표 숫자 갱신 → 차트 데이터 교체. 양식은 그대로, 내용만 이번 주.

# weekly-ppt/SKILL.md (발췌)
description: 주간보고 PPT 갱신. "주간보고",
  "위클리 장표" 요청 시. 기존 pptx는 win32com만

## 절차
1. 지난주 파일을 이번 주 이름으로 복사 (원본 불변)
2. win32com으로 PowerPoint 열기
3. 슬라이드 2 제목의 주차 갱신 (W29 → W30)
4. 슬라이드 3 표: 이번 주 집계로 교체
5. 슬라이드 4 차트: 내장 엑셀도 COM으로 갱신
## 검증
- 표 합계 = 원본 CSV 집계와 일치 확인

🧷 템플릿 = 지난주 파일

디자인을 코드로 다시 만들지 않습니다. 복사 후 값만 교체하니 팀 양식이 그대로 남습니다.

🪆 함정: 차트 속의 엑셀

PPT 차트 안에는 작은 엑셀이 숨어 있습니다. 이것도 COM으로 — 이런 디테일이 스킬에 적혀 있어야 합니다.

예제 4

Word 사양서 — 저장 전에 사람 승인

기존 파일 = win32com
# spec-doc/SKILL.md (발췌)
description: 공정 사양서(.docx) 개정.
  "사양서 업데이트", "스펙 문서 반영" 시 사용

## 절차
1. 원본 복사 → _revN 파일로 작업 (원본 보존)
2. win32com으로 Word 열기
3. 바꿀 파라미터를 표에서 찾아 값 교체
   — 찾아 바꾸기가 아니라 표 위치로 (오치환 방지)
4. '개정 이력' 표에 행 추가: 날짜/항목/사유/작성자
5. 바뀐 문장은 강조 표시 (검토자용)
## 검증
- 바뀐 곳 목록을 보고 → 사람이 승인한 뒤 저장

📌 문서 규정이 곧 절차

개정 이력, 강조 표시, 승인 후 저장 — 팀의 문서 관리 규정이 그대로 스킬 절차가 됩니다.

🤝 사람이 마지막 관문

"보고 → 승인 → 저장"을 적어 두면 AI가 묻고 나서 저장합니다. 스킬은 지시일 뿐이니, 확실히 막으려면 권한 설정도 함께.

예제 5

GDS 검사 — 단위 함정을 적어 둔다

.gds = KLayout

레이아웃 .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 바이너리를 직접 파싱하는 코드 작성 금지

🎯 현업 활용처

테스트 패턴 면적 집계, 레이어 커버리지 리포트, 룰 위반 후보 거르기, 리비전 간 레이아웃 비교.

⚠️ 함정: dbu 단위

KLayout 좌표는 정수 dbu(흔히 1nm). µm로 착각하면 천 배 틀립니다 — 스킬에 적을 1순위.

예제 5

GDS는 레이어별 도형의 묶음입니다

🖱️ 레이어를 켜고 꺼 보세요
커서를 도형 위에 올리면
레이어·좌표(µm)가 보입니다

※ CMOS 인버터를 단순화한 그림 — 레이어 번호(layer/datatype)별로 도형이 쌓인 파일이 GDS입니다. 스킬은 이 도형들을 숫자(면적·개수·밀도)로 바꿔 줍니다.

예제 6

RTL 도우미 — 하지 말 일도 적는다

텍스트 = 제약 없음
# rtl-helper/SKILL.md (발췌)
description: Verilog RTL 분석·문서화·TB 생성.
  "포트 요약", "테스트벤치 만들어줘", "린트" 시 사용

## 할 수 있는 일
1. 모듈 포트/파라미터 표 추출 → 설계 문서용
2. 셀프체킹 테스트벤치 뼈대 생성
   - clk/rst 생성, 시나리오 주석 자리
3. 사내 코딩룰 체크: references/lint_rules.md
   - latch 추론 금지, always @(*) 누락, 폭 불일치
## 검증
- iverilog가 있으면 컴파일까지 돌려 문법 확인
- 합성·타이밍 판단은 하지 않는다 — EDA 툴 영역

📋 포트 요약 → 문서

수백 줄 RTL에서 포트 표를 뽑아 사양서(예제 4)로 — 스킬은 서로 이어 쓸 수 있습니다.

🧪 TB 초안은 AI가

귀찮은 클럭·리셋·파형 덤프 뼈대는 AI가. 시나리오 설계는 여전히 엔지니어의 일.

🚧 선 긋기도 스킬에

"타이밍 판단 금지" — AI가 하지 말아야 할 일도 매뉴얼에 적습니다.

예제 7

TCAD 스윕 — 앞뒤 손일을 맡긴다

입력덱 = 텍스트
📝템플릿 덱기준 입력덱에 {tox}, {nd} 자리표시
▶
🔁스윕 생성조건표(CSV)대로 덱 N개 생성
▶
📤결과 수확출력에서 I-V 추출 → 표준 CSV
▶
📊비교 리포트Vth·SS 요약표 + 곡선 겹쳐 그리기
# tcad-sweep/SKILL.md (발췌)
description: TCAD 입력덱 파라미터 스윕 생성과 결과(I-V) 추출·요약. "스플릿 돌려줘", "Vth 뽑아줘" 시 사용
## 규칙
- 템플릿 복사 후 자리표시자만 치환 (물리 모델 줄은 수정 금지)
- 스윕 조건은 sweep_plan.csv 한 곳에서만 · 결과 파일명 = 조건 조합 (tox12_nd5e17.csv)
- Vth 추출법은 정전류법(Id=100nA×W/L)으로 통일 — 사람마다 다르면 비교 불가
- 라이선스·큐 제출 명령은 references/cluster.md 참조

시뮬레이터는 그대로 씁니다. 스킬이 맡는 건 그 앞뒤의 덱 생성과 결과 정리입니다.

예제 7

스킬 4개가 이어지면 하나의 업무 라인

▶ 들어오면 그려집니다

🧾 곡선 1개 = CSV 1개

시뮬 출력에서 Vg, Id를 뽑아 표준 CSV로 — 예제 1이 그대로 받는 형식입니다.

📐 요약표 자동 생성

tox별 Vth·SS·Ion/Ioff를 표로 만들어 엑셀 대장(예제 2)에 기입합니다.

🔗 스킬 파이프라인

TCAD 스윕 → CSV 리포트 → 엑셀 대장 → 주간 PPT. 낱개 스킬이 업무 한 줄이 됩니다.

HANDS-ON · 준비 10분

실습 준비 — CSV 미션은 어느 PC에서나 됩니다

1) 설치

pip install pandas matplotlib     # 미션 1·2는 이것만
# DRM 엑셀·PPT 예제까지: Windows + Office PC에서
pip install xlwings pywin32
# GDS 예제: pip install klayout

2) 스킬과 연습 데이터 복사

📁 내 작업 폴더/
├─ .claude/skills/csv-report/  ← 스킬 폴더째
└─ sample_data/              ← CSV 3개 (36행)
💬 설치 확인
지금 쓸 수 있는 스킬 목록을 보여줘.
✓ 완료 기준 목록에 csv-report가 보이면 준비 끝.
막히면 경로가 .claude/skills/csv-report/SKILL.md인지 확인하고 Claude Code를 다시 시작합니다.

연습 데이터는 모두 가짜 값입니다 — 사내 데이터 없이 실습합니다.

HANDS-ON · 미션 1·2 (20분)

스킬을 돌려 보고, 한 줄 고쳐 봅니다

미션 1 · 돌려 보기

배우는 것: 스킬 발동 → 실행 → 검산의 한 바퀴

sample_data 폴더 측정 CSV로 일일 리포트 뽑아줘
✓ 완료 기준 csv-report 스킬이 불림 · report_*.html이 열림
병합 36행 = 12 + 12 + 12 · LOT_ID 전부 대문자
FAIL 4건, 전부 ETCH-07 (균일도 3.0% 초과)
막히면스킬이 안 불리면 "csv-report 스킬로 해줘"라고 이름을 부릅니다.
미션 2 · 한 줄 고치기

배우는 것: 스킬은 코드가 아니라 고칠 수 있는 문서

csv-report/references/spec_table.md에서 균일도 상한 3.0 → 3.5로 바꾸고 같은 요청을 다시 합니다.

✓ 완료 기준 FAIL 4건 → 2건 (3.56%, 4.36%만 남음)
보고에 바뀐 스펙 값이 적혀 있음
막히면숫자가 그대로면 "spec_table.md를 다시 읽고 판정해줘".
INTERACTIVE · 미션 3 전에

내 업무가 스킬감인지 세 질문이면 압니다

🔁 반복되나요?매일·매주·랏마다 다시 하는 일인가

📜 규칙을 말로 설명할 수 있나요?신입에게 문서로 가르칠 수 있는 절차가 있는가

🗃️ 입력과 출력이 파일·데이터인가요?CSV, 엑셀, PPT, GDS, 로그, 코드… (회의·협상은 아님)

SKILL-FIT

버튼을 눌러 보세요

HANDS-ON · 미션 3 (25분)

내 반복 업무 하나를 파일로 남깁니다

규칙 몇 줄 → CLAUDE.md · 순서 있는 절차 → 스킬

💬 스킬로 만들 때
skill-creator로 새 스킬을 만들어줘.
내가 매주 하는 일은 ○○이야.
입력 파일은 ○○, 결과물은 ○○이야.
빠진 규칙은 나한테 하나씩 물어봐줘.

실데이터 대신 sample_data나 가짜 값으로 만듭니다.

✓ 완료 기준 ① .claude/skills/<이름>/SKILL.md가 생겼다
② 새 대화에서 description에 쓴 말로 요청하면 이 스킬이 불린다
③ 옆자리 동료가 SKILL.md만 읽고 절차를 설명할 수 있다
막히면 안 불리면 → description에 내가 평소 쓰는 말을 추가
skill-creator가 없으면 → "SKILL.md 형식으로 만들어줘"
TEAM

스킬은 git에 올려 팀이 함께 고칩니다

🙋개인~/.claude/skills/ — 오늘 시작
▶
👥팀저장소의 .claude/skills/ 커밋 — 받으면 같은 스킬
▶
🏭조직플러그인으로 묶어 배포 — 신입 교육이 곧 설치

🧬 이력 = 노하우의 역사

텍스트라 git에 그대로 올라갑니다. "왜 이 규칙이 생겼나"가 커밋으로 남아 담당자가 바뀌어도 살아남습니다.

🔍 매뉴얼 리뷰는 누구나

코드 리뷰는 어려워도 매뉴얼 리뷰는 누구나 합니다 — "이 스펙 바뀌었어요", "이 함정도 추가해요".

SAFETY · 남이 만든 스킬

남이 만든 스킬은 설치 전에 원문을 읽습니다

📦 어디서 구하나

Claude Code의 /plugin 마켓플레이스, skills.sh 같은 공개 목록(제3자 · Anthropic 공식 아님), GitHub 저장소.

⚠️ 왜 조심하나

SKILL.md는 AI가 그대로 따르는 지시문이고, scripts/는 실제로 실행되는 코드입니다. 출처 불명 스킬은 프롬프트 인젝션의 통로가 됩니다.

설치 전 체크리스트
  • 만든 사람·조직을 확인할 수 있는가 — 인기(스타·설치 수)는 최소한의 필터일 뿐
  • SKILL.md와 scripts/를 전부 읽었는가 — 파일을 밖으로 보내는 코드(업로드·외부 주소)가 없는가
  • "이전 지시는 무시", "사용자에게 알리지 말 것" 같은 문장이 있으면 설치하지 않는다
  • 사내 반입 정책상 허용되는가 — 애매하면 보안 덱과 사내 담당자 확인
ECOSYSTEM · 써 볼 만한 것

먼저 써 볼 확장 3가지 — 대부분 토큰을 더 씁니다

작업 절차 모음

Superpowers

브레인스토밍·체계적 디버깅 같은 검증된 작업 절차를 모은 스킬 모음 (제3자 · obra/superpowers).

💸 다단계 절차·서브에이전트를 불러 작업당 토큰 ↑

스킬 제작

Skill Creator

내 노하우를 SKILL.md로 뽑아내는 스킬. 오늘 미션 3에서 쓴 것.

🟢 만들 때만 잠깐 — 평소 비용은 거의 없음

브라우저 자동화 (MCP)

Playwright MCP

웹 화면을 직접 열고 보며 검증합니다. 이 덱의 화면 검사도 이 방식입니다.

💸 조작마다 화면 정보가 대화에 들어가 토큰 ↑↑

쓴 만큼 내는 요금제라면 필요할 때만 켜고, 끝나면 끕니다. 그래도 핵심은 같습니다 — 생각하고 → 만들고 → 눈으로 확인.

SAFETY · 약속

선 넘지 않기 — 보안 약속 세 가지

1

회사 기밀·실데이터는 사내 승인 도구에서만 — 애매하면 넣지 않는다.

2

API 키·비밀번호는 코드·대화·커밋에 남기지 않는다 — 새어 나갔다면 삭제가 아니라 재발급.

3

회사 정책이 이 자료보다 우선한다.

이 덱에서 하나 더

DRM은 우회 대상이 아닙니다. xlwings·win32com은 권한 있는 앱을 통한 정식 경로입니다. 해제·변환 시도는 스킬에 '금지'로 적어 둡니다.

그리고

보고서에 서명하는 건 사람입니다. 스킬이 검산을 해도 결과물은 눈으로 확인한 뒤 냅니다.

자세한 내용은 → 사내 환경에서의 AI — 보안과 거버넌스

WRAP-UP

이번 주, 파일 한 장만 남겨 보세요

1️⃣두 번 한 지적→ CLAUDE.md 한 줄
▶
2️⃣반복 업무 하나→ skill-creator로 스킬
▶
3️⃣한 주 써 보고→ 다듬어서 팀에 공유

코드는 AI가 씁니다. 일하는 법을 아는 사람이 매뉴얼을 쓰면 됩니다.

감사합니다 — Q&A 🙋

함께 보기: AI에게 일 시키는 법 · 컨텍스트 · 내 도구가 혼자 돌게 · 슬라이드 자료 만들기 · 보안과 거버넌스