AI-07 · Tool과 Skill 이해하기
Claude Desktop의 Code 탭에서 Tool(도구)는 Claude가 호출해 파일을 읽거나 명령을 실행하는 기능입니다. 호출할 때 실제 작업이 일어나고, 결과가 Claude에게 돌아옵니다. Skill(절차 기술서)는 특정 업무를 어떻게 처리할지 적은 SKILL.md와 필요한 참고 파일의 묶음입니다. 언제 사용할지, 어떤 순서와 기준으로 검토할지 알려 주지만, Skill 파일 자체가 문서를 읽거나 명령을 실행하지는 않습니다.
| 구분 | 하는 일 | 전표 검토 예시 |
|---|---|---|
| Tool | 파일을 읽거나 명령을 실행합니다. | 회사 규정과 전표·증빙 파일을 읽습니다. |
| Skill | 언제 무엇을 확인하고 어떤 결과를 낼지 안내합니다. | 규정을 먼저 읽고 모든 증빙을 대조한 뒤 전표별로 승인·반려·확인 필요를 판정하게 합니다. |
예를 들어 “전표 5건을 검토해 줘”라고 하면 voucher-review Skill은 회사 규정부터 읽고 모든 증빙을 대조한 뒤 판정하라고 안내합니다. Claude는 그 절차를 따라 파일 읽기 Tool로 규정과 증빙을 열고, 읽은 결과에 기준을 적용합니다. 도구가 무엇을 할 수 있는지, 절차 기술서가 어떻게 할지를 정하는 관계입니다.
voucher-review Skill 안을 살펴보기
제공된 Voucher_Review.zip을 풀면 다음 파일을 볼 수 있습니다.
.claude/skills/voucher-review/
├── SKILL.md
└── references/
├── data/ # 실습용 규정(rule.md)과 전표·증빙 예시
└── rules/ # 회사 규정 원본 PDFSKILL.md의 앞머리는 그대로, 본문은 줄여 쓰면 다음과 같습니다. name은 Skill 이름이고, description은 Claude가 관련 요청을 받았을 때 이 Skill을 고르는 단서입니다. --- 아래 본문은 실제 검토 순서와 판정 기준을 적습니다.
---
name: voucher-review
description: 회사 규정과 전표·영수증·지출결의서 증빙을 대조해 전표를 승인, 반려 또는 확인 필요로 판정한다. 전표 검토, 비용 정산, 도서비, 접대비, 업무추진비 검토 요청에는 반드시 이 스킬을 사용한다.
---
# Voucher Review
## 검토 절차
1. 회사 규정을 먼저 읽고 현재 검토의 유일한 판정 기준으로 삼는다.
2. 검토 대상의 최상위 전표번호 폴더를 전부 나열한다.
3. 각 전표의 전표 파일과 증빙을 모두 읽는다. …
## 판정 기준
승인·반려·확인 필요 중 하나로 판정한다. …| 부분 | 뜻 | 이 Skill에서 볼 내용 |
|---|---|---|
SKILL.md 앞머리(frontmatter) | 맨 위 --- 사이의 이름과 사용 상황 설명 | name: voucher-review, 전표 검토 요청에 사용한다는 description |
SKILL.md 본문(content) | 실제 작업 순서와 판단 기준 | 규정 읽기 → 증빙 대조 → 전표별 판정 → 결과 표 작성 |
references/ | 필요할 때 읽는 보조 자료 | 실습용 회사 규정과 전표·증빙 예시 |
SKILL.md가 핵심 파일입니다. 다른 Skill은 필요에 따라 scripts/에 실행할 코드를, assets/에 결과 템플릿을 둘 수도 있습니다. 예를 들어 다음 실습의 monthly-close-brief Skill에는 Excel을 만드는 Python 스크립트가 들어 있습니다.
직접 확인하려면 Voucher_Review.zip의 .claude/skills/voucher-review/SKILL.md를 열어 --- 사이의 두 항목과 본문의 검토 절차, 판정 기준, 출력 계약을 찾아보세요. 이어서 Voucher Review Skill 실습에서 같은 규정과 증빙으로 결과를 확인합니다.