특정 업무를 위한 Claude Code Skill 만들기

[주인장]

특정 업무를 위한 Claude Code Skill 만들기

특정 업무를 위한 Skill을 만들 때는 먼저 “Claude에게 무엇을 시킬 것인가?”보다 **“이 업무를 사람이 한다면 어떤 절차로 처리하는가?”**를 정리하는 것이 중요합니다.

예를 들어 회의록 정리, 보고서 검토, 데이터 분석, 코드 리뷰, 문서 작성처럼 일정한 처리 순서가 있는 업무는 Skill로 만들기 좋습니다.

● 1. 먼저 업무 하나를 명확하게 정한다

처음부터 너무 큰 업무를 하나의 Skill로 만들지 않는 것이 좋습니다.

예를 들어 보고서 업무 전체 처리 보다는 보고서 초안 검토 처럼 범위를 좁히는 것이 좋습니다.

Skill 하나가 하나의 명확한 업무를 담당하도록 만드는 것이 관리하기 쉽습니다.

● 2. 업무 처리 순서를 적어본다

Skill을 만들기 전에 사람이 이 업무를 처리한다면 어떤 순서로 하는지 먼저 적어봅니다.

예를 들어 보고서 검토 업무라면 다음과 같이 정리할 수 있습니다.

1. 보고서의 목적을 확인한다.

2. 주요 내용을 요약한다.

3. 논리적으로 맞지 않는 부분을 찾는다.

4. 빠진 내용이 있는지 확인한다.

5. 수정이 필요한 부분을 제안한다.

6. 최종 검토 결과를 정리한다.

이 절차가 나중에 SKILL.md의 핵심 내용이 됩니다.

● 3. Skill 폴더를 만든다

프로젝트에서 사용할 Skill이라면 다음과 같이 만듭니다.

.claude/skills/report-review/SKILL.md

구조는 다음과 같습니다.

.claude
└─ skills
　└─ report-review
　　└─ SKILL.md

여기서 report-review가 Skill 이름입니다.

Claude Code에서는 Skill 폴더 안의 SKILL.md에 업무 지침을 작성하며, 필요할 때 Claude가 자동으로 사용할 수도 있고 /report-review처럼 직접 실행할 수도 있습니다.

● 4. description을 구체적으로 작성한다

SKILL.md의 앞부분에는 이 Skill이 어떤 업무에 사용되는지 작성합니다.

예를 들면 다음과 같습니다.

---

description: "보고서 초안을 검토하고 내용의 누락, 논리적 문제, 개선이 필요한 부분을 찾아 수정 의견을 제안한다."

---

여기서 description은 매우 중요합니다.

Claude는 description을 보고

“지금 사용자가 요청한 업무에 이 Skill이 필요한가?”

를 판단할 수 있습니다. 공식 문서에서도 description은 Claude가 Skill을 자동으로 선택할 때 사용하는 중요한 정보라고 설명합니다.

따라서 보고서 관련 Skill 처럼 애매하게 적기보다는 보고서 초안을 검토하고 누락 내용과 논리적 문제를 찾아 개선안을 제시한다 처럼 구체적으로 적는 것이 좋습니다.

● 5. 실제 업무 절차를 작성한다

description 아래에는 Claude가 따라야 할 작업 순서를 작성합니다.

예를 들어 다음과 같이 만들 수 있습니다.

---

description: "보고서 초안을 검토하고 내용의 누락, 논리적 문제, 개선이 필요한 부분을 찾아 수정 의견을 제안한다."

---

보고서 초안을 다음 순서로 검토한다.

1. 보고서의 목적과 주요 주제를 확인한다.

2. 핵심 내용을 3~5문장으로 요약한다.

3. 내용의 흐름이 자연스러운지 확인한다.

4. 근거가 부족하거나 논리적으로 연결되지 않는 부분을 찾는다.

5. 필요한 내용이 누락되어 있는지 확인한다.

6. 수정이 필요한 부분을 구체적으로 제안한다.

최종 결과는 다음 형식으로 작성한다.

보고서 요약

보고서의 핵심 내용을 간단히 정리한다.

문제점

수정이 필요한 부분을 설명한다.

개선 제안

어떻게 수정하면 좋은지 구체적으로 제안한다.

이렇게 하면 Claude가 매번 같은 기준과 순서로 보고서를 검토하게 할 수 있습니다.

● 6. 실제로 실행해 본다

Skill을 만든 다음 Claude Code에서 다음과 같이 입력합니다.

/report-review

그리고 검토할 보고서를 지정하면 됩니다.

예를 들어

/report-review @docs/report.md

처럼 사용할 수 있습니다.

또는 Claude에게 자연스럽게

“이 보고서 초안을 검토하고 부족한 부분을 찾아줘.”

라고 요청할 수도 있습니다. Skill의 description과 요청 내용이 잘 맞으면 Claude가 관련 Skill을 자동으로 사용할 수 있습니다.

● 7. 업무 자료가 많으면 별도 파일로 분리한다

실제 업무 Skill을 만들다 보면 규칙이나 참고자료가 많아질 수 있습니다.

이럴 때 SKILL.md 하나에 모든 내용을 넣기보다는 다음처럼 나누는 것이 좋습니다.

.claude
└─ skills
　└─ report-review
　　├─ SKILL.md
　　├─ checklist.md
　　├─ report-template.md
　　└─ examples.md

SKILL.md

업무 처리 순서

checklist.md

검토 체크리스트

report-template.md

보고서 표준 양식

examples.md

잘 작성된 보고서 예제

Claude Code의 Skill은 이런 추가 참고 파일을 함께 구성할 수 있는 구조를 지원합니다. 그래서 단순한 프롬프트보다 복잡한 업무 매뉴얼을 만들기에 적합합니다.

● 업무 Skill을 만들 때 가장 중요한 구조

특정 업무 Skill을 만들 때는 다음 6가지를 생각하면 됩니다.

업무 목적
→ 무엇을 처리하는 Skill인가?

입력 자료
→ 어떤 문서나 데이터를 받는가?

업무 절차
→ 어떤 순서로 처리하는가?

판단 기준
→ 무엇을 기준으로 확인하는가?

결과 형식
→ 어떤 형태로 결과를 작성하는가?

검증 방법
→ 결과가 제대로 만들어졌는지 어떻게 확인하는가?

이 구조만 잘 만들어도 상당히 실용적인 Skill을 만들 수 있습니다.

● 가장 중요한 포인트

특정 업무 Skill은 단순히 “보고서를 잘 검토해줘.” 라고 만드는 것보다 “어떤 순서로 검토하고, 무엇을 확인하고, 어떤 형식으로 결과를 만들어야 하는가” 를 구체적으로 정의하는 것이 중요합니다. 즉, 

일반 프롬프트 → 무엇을 해달라고 요청

업무 Skill → 무엇을 + 어떤 절차로 + 어떤 기준으로 + 어떤 결과물로 만들 것인지 정의라고 이해하면 됩니다.