# 워크북: 반복 업무 하나를 스킬로 승격하기

> 이름·설명·호출 정책·배포 경로를 한 장으로 정리

- Canonical: https://learning.reopt.ai/en/courses/claude-code-automation/lessons/ccau-m4-workbook
- Language: en
- HTML: https://learning.reopt.ai/en/courses/claude-code-automation/lessons/ccau-m4-workbook

---

[Automation and extensions](/en/courses/claude-code-automation) 4. 스킬과 플러그인 배포 8 / 9

# 워크북: 반복 업무 하나를 스킬로 승격하기

이름·설명·호출 정책·배포 경로를 한 장으로 정리
Workbook 70 XP 12 min

## 실무 워크북

최근 2주간 세 번 이상 반복한 프롬프트를 하나 고르고, 그대로 팀에 배포할 수 있는 스킬 사양으로 옮기세요.
작성 내용 자동 저장
승격 대상과 경계 필수
어떤 반복 작업을 스킬로 만들 것인지, 이 스킬이 하지 않을 일은 무엇인지 적으세요. 본문에 남길 절차와 별도 레퍼런스 파일로 뺄 내용을 나누세요.

호출 이름과 충돌 점검 필수
디렉터리 이름을 정하고, 팀원의 개인 스코프나 플러그인에 같은 이름이 있는지 확인한 결과를 적으세요. 충돌 시 이름 변경과 플러그인 네임스페이스 중 무엇을 쓸지 결정하세요.

자동 선택을 노린 설명 필수
description과 when_to_use를 작성하되, 이 스킬이 선택되어야 할 상황 표현을 앞쪽에 배치하세요. 반대로 선택되면 안 되는 상황도 함께 적으세요.

호출 주체와 도구 경계 필수
모델 자동 호출을 허용할지 결정하고 근거를 적으세요. allowed-tools에 사전 허용할 최소 집합과, 실제로 막아야 해서 disallowed-tools나 퍼미션 deny로 처리할 도구를 구분하세요.

완성도 점검 기준

- 이름 정합성 호출 이름이 디렉터리에서 온다는 규칙을 반영했고 충돌 확인 결과가 적혀 있다.
- 선택 가능성 설명만 읽고도 언제 이 스킬이 쓰여야 하는지 판정할 수 있다.
- 권한 정확성 사전 허용과 실제 차단을 혼동하지 않고 각각 맞는 수단에 배치했다.

작성한 사양으로 스킬을 만든 뒤 /skills에서 실제 선택된 소스를 확인하고, 샘플 인수로 한 번 호출해 검증하세요.
산출물 완성 · 계속

---

Site guide for agents: https://learning.reopt.ai/llms.txt · Sitemap: https://learning.reopt.ai/sitemap.xml · Contact: https://learning.reopt.ai/contact