1. Skill(스킬)이란?
일회성 프롬프트가 아니라, 재사용되는 '업무 매뉴얼 꾸러미'
- 특정 작업의 절차·규칙·양식을 담아 두는 모듈
- 필요할 때만 자동으로 불려와 실행됨 (progressive disclosure)
- 매번 같은 지시를 길게 반복할 필요가 없음
- DRTECH에선 사내 스킬 팩(
/drtech-setup등)으로 배포됨 - 만드는 두 갈래: ① Record a skill(시연 녹화) ② SKILL.md(파일 직접 작성)
핵심: 스킬 = 한 번 만들어 계속 재사용하는 Claude용 업무 매뉴얼
2. 스킬 만들기 두 가지 방식
Record a skill (녹화) vs SKILL.md (직접 작성)
| 구분 | Record a skill (녹화) | SKILL.md (직접 작성) |
|---|---|---|
| 난이도 | 매우 쉬움 · 비개발자용 | 중간 · 파일/문법 필요 |
| 방법 | 화면·클릭·음성 시연을 녹화 | YAML + 마크다운 텍스트 작성 |
| 환경 | Claude 데스크톱 앱 (Cowork) | Claude Code / API / claude.ai |
| 플랜 | 유료 (Pro · Max · Team) | 코드 실행 가능 플랜 |
| DRTECH 용도 | 현장 GUI 반복작업 자동화 | 부서 표준 스킬 팩 배포 |
둘 다 결과물은 재사용 가능한 '스킬'로 저장된다.
3. 'Record a skill' 이란?
긴 프롬프트·스크립트 없이, 시연만으로 가르치는 기능
- 화면에서 작업을 '평소처럼' 수행하며 녹화한다
- Claude가 키보드 입력·마우스 클릭·화면·음성 설명을 함께 기록
- 녹화가 구조화된 스킬로 변환되어 라이브러리에 저장 → 이후엔 스킬만 호출
- 파일 접근·메모리·커넥터 등 Cowork 도구와 결합 가능
- 전제: 안정적 인터넷 + 유료 플랜 + 데스크톱 앱
비개발자도 '보여주기'만으로 자동화를 만들 수 있다
4. 5단계 사용법
데스크톱 앱 → Cowork → 녹화 → 저장 → 재사용
- Claude 데스크톱 앱을 연다
- Cowork 공간에 있는지 확인한다
- '+' 아이콘을 누르고 'Record a skill' 선택
- 작업을 평소처럼 수행하며 각 단계를 말로 설명 (이유·입력·출력 나레이션)
- 녹화 종료 → 스킬 이름·설명 확인 후 저장 → 다음부터 라이브러리에서 호출
핵심은 4단계의 '설명' — 클릭만 하지 말고 이유를 말하라
5. 내부 동작 원리 (알면 잘 만든다)
스킬은 3단계로 나눠 필요할 때만 로드된다
- Level 1 · 메타데이터(name/description): 항상 로드, 언제 쓸지 판단
- description이 '무엇을·언제'를 담아야 자동 호출됨
- Level 2 · 본문 지시: 스킬이 트리거될 때만 로드
- Level 3 · 리소스/스크립트: 실제 필요할 때만 읽음
설명이 부실하면 스킬이 '언제 쓸지' 몰라 호출되지 않는다
6. 부서별 반복 업무에 붙이기
녹화로 자동화하기 좋은 DRTECH 사내 업무
| 부서 | 반복 업무 예 | 녹화 스킬화 포인트 |
|---|---|---|
| 생산 | 런시트 → 일일 생산실적 전기 | 매일 같은 양식·같은 순서 |
| 품질(QA) | 입고검사 대장 엑셀 작성 | 고정 컬럼·판정 규칙 명확 |
| 영업 | 수주 내역 → 공유 시트 정리 | 포맷 통일·반복 빈도 높음 |
| 재고 | MES 재고 스냅샷 표 정리 | 동일 필드 추출·붙여넣기 |
| 공통 | 주간 보고 표 양식 채우기 | 양식 고정·데이터만 교체 |
판단·예외가 많은 업무보다 '규칙이 고정된 반복 업무'가 1순위.
7. 좋은 예 vs 나쁜 예
같은 '일일 실적 전기' 작업을 녹화하는 두 가지 태도
GOOD
생산팀 '일일 실적 전기'
- 작업 하나만 녹화: 런시트 전일 생산량 → 생산팀 공유시트
- 각 단계 설명: "여기서 라인코드 열을 복사합니다"
- 입력·출력 명시: 입력=런시트, 출력=실적시트 B열
- 판정 규칙 명확: 불량은 D열 수량, 사유는 비고
- PII 없이 사번·부서코드만 화면에
- 깨끗한 화면에서 처음~끝 한 번에 시연
- 스킬명
prod-daily-runsheet-transfer
BAD
흔한 실패 패턴
- 여러 작업 뒤섞기: 실적+메일+견적 한 번에
- 설명 없이 클릭만 반복 (조작 의도가 기록되지 않음)
- 화면에 API 키·비밀번호·고객 PII 노출 (정책 위반)
- 중간에 실수·되돌리기를 반복하여 절차에 잡음
- 일회성 작업을 녹화 (다시 안 쓸 일)
- 스킬명이
test1처럼 모호
| 항목 | 좋은 예 | 나쁜 예 |
|---|---|---|
| 범위 | 작업 1개로 한정 | 여러 작업 뒤섞음 |
| 설명 | 단계마다 이유·입출력 나레이션 | 무설명 클릭 |
| 일관성 | 처음~끝 한 번에 깔끔 | 실수·되돌리기 반복 |
| 데이터 | 사번·부서코드만, PII 없음 | API키·PII·비밀번호 노출 |
| 재사용성 | 매일 반복하는 업무 | 일회성 작업 |
| 명명 | prod-daily-runsheet-transfer | test1 |
좋은 녹화 = 좁은 범위 + 또렷한 설명 + 일정한 순서 + 민감정보 제로
8. SKILL.md 직접 작성 방식
Claude Code에서 파일로 스킬을 만든다 (부서 표준 배포용)
- 위치:
~/.claude/skills/<스킬명>/SKILL.md(개인) 또는 프로젝트.claude/skills/ - 구성: YAML 머리말(
name·description) + 마크다운 지시문 name: 소문자·숫자·하이픈만, 'claude'/'anthropic' 금지description: 무엇을 + 언제 쓰는지 (자동 호출 판단 근거)- 본문에 절차·예시·규칙, 필요 시 스크립트/참고파일 번들
- DRTECH: 사내 스킬 팩으로 묶어
install.ps1로 전 직원 배포 - 신뢰된 출처만 사용 — 외부 스킬은 감사 후 도입
녹화가 어렵거나 정밀 규칙이 필요하면 SKILL.md로 작성
9. 좋은 description vs 나쁜 description
description이 스킬 자동 호출의 성패를 가른다
| 구분 | 좋은 예 (무엇+언제) | 나쁜 예 (모호) |
|---|---|---|
| name | prod-runsheet-transfer | helper |
| description | 런시트 전일 생산실적을 생산팀 공유시트 규격으로 옮긴다. 매일 아침 실적 정리·전기 요청 시 사용. | 시트 관련 도움. |
| 결과 | 무엇+언제가 모두 있어 정확히 트리거 | 무엇도 언제도 불분명 → 호출 실패 |
description은 1024자 이내, '동작 + 사용 시점'을 반드시 포함
10. 입문자 체크리스트 & 사내 보안
녹화 전에 이것만 확인하면 실패가 준다
- [범위] 이 녹화는 '한 가지 반복 업무'인가?
- [설명] 각 단계의 이유·입력·출력을 말할 준비가 됐나?
- [화면] API 키·비밀번호·고객 PII가 화면에 없나? (필수)
- DRTECH 정책: 개인정보/결재정보 저장·전송 금지, 사번·부서코드만
- [일관성] 실수 없이 처음부터 끝까지 시연할 수 있나?
- [명명] 스킬명이 부서·업무를 알 수 있게 구체적인가?
- [재사용] 앞으로 반복해서 쓸 업무가 맞나?
문제가 지속되면 사내 AI 관리자에게 문의하십시오