[클로드 시리즈_07] Skill은 무엇을 저장하는가?

핵심 결론: Claude Skill은 이름(name), 설명(description), 역할, 목표, 작업 순서, 출력 형식, 기준·주의사항 — 이 7가지를 SKILL.md 파일에 저장한다. 이 7가지가 채워지는 순간, Claude는 매번 새로 설명하지 않아도 나만의 방식으로 일하는 AI 비서가 된다.

---

1. Skill 파일이 저장하는 것은 '코드'가 아니다

많은 분들이 Skill 파일을 처음 접하면 이렇게 생각한다. "개발자가 만드는 거 아닌가요?"

그렇지 않다. Claude Skill은 복잡한 코드가 아니다. 핵심은 단 하나다.

"Claude가 일을 할 때 참고할 기준을 정리하는 것"

비유하자면 이렇다. 새로운 직원이 입사했을 때 건네주는 업무 매뉴얼 문서가 바로 SKILL.md다. 어떤 상황에서 이 업무를 처리해야 하는지, 어떤 순서로 일하는지, 결과물은 어떤 형식이어야 하는지, 절대 하면 안 되는 것은 무엇인지 — 이것들을 Markdown 형식으로 적어두는 것이 전부다.

---

2. Skill이 저장하는 7가지 핵심 요소

Claude Skill에 들어가는 구성 요소를 정리하면 다음과 같다.

구성요소	의미	예시
이름 (name)	Skill의 고유 이름	lecture-summary
설명 (description)	언제 이 Skill을 사용할지	강의 내용이나 수업 필기를 요약할 때
역할	Claude가 어떤 전문가처럼 행동할지	대학생을 위한 강의 요약 비서
목표	어떤 결과를 만들어야 하는지	복습과 시험 준비에 쓸 수 있게 정리
작업 순서	어떤 단계로 일할지	읽기 → 핵심 추출 → 정리 → 질문 생성
출력 형식	결과가 어떤 구조로 나올지	요약, 핵심 개념, 시험 포인트
기준 & 주의사항	좋은 결과의 조건 / 피해야 할 것	쉽고 간결하게 / 추측 금지

이 7가지가 채워진 파일 하나가, 매번 길게 설명해야 했던 프롬프트를 완전히 대체한다.

---

3. Skill 파일의 기본 구조 — 직접 보면 바로 이해된다

말보다 직접 보는 게 빠르다. 아래가 SKILL.md의 표준 구조다.

--name: skill-name
description: 이 Skill을 언제 사용할지 설명합니다.
--

# 역할
Claude가 어떤 전문가처럼 행동해야 하는지 적습니다.

# 목표
이 Skill이 어떤 결과를 만들어야 하는지 적습니다.

# 작업 순서
1. 먼저 무엇을 확인할지 적습니다.
2. 그다음 무엇을 분석할지 적습니다.
3. 마지막에 어떤 결과를 만들지 적습니다.

# 출력 형식
결과물이 어떤 구조로 나와야 하는지 적습니다.

# 좋은 결과 기준
좋은 답변과 나쁜 답변의 차이를 적습니다.

# 주의사항
하지 말아야 할 것, 피해야 할 표현을 적습니다.

-- 사이에 이름과 설명을 적고, 그 아래에 # 제목으로 구역을 나눠 내용을 채우면 된다. Markdown 기호 두 개만 알면 누구나 만들 수 있는 구조다.

---

4. 핵심 구조 — "이름표 + 업무 지시서"

Skill 파일을 더 쉽게 이해하는 방법이 있다. 크게 두 부분으로만 나눠서 보는 것이다.

부분	역할	해당 요소
이름표	Claude가 이 Skill을 언제 꺼내 쓸지 판단하는 부분	name, description
업무 지시서	Claude가 어떤 방식으로 일해야 하는지 적은 부분	역할, 목표, 작업 순서, 출력 형식, 기준, 주의사항

여기서 특히 중요한 것이 description이다. Claude는 사용자의 요청과 description을 비교해서 어떤 Skill을 꺼내 쓸지 판단한다. description이 불명확하면 엉뚱한 Skill이 실행되거나 아예 Skill이 작동하지 않는다. Skill 성패의 절반이 description에 달려 있다고 봐도 과언이 아니다.

좋은 description 작성 원칙:

• 언제(When) 사용하는지를 명확히 서술한다
• 키워드를 구체적으로 포함한다
• "~할 때 사용합니다" 형식으로 마무리한다

나쁜 예: 이메일을 정리할 때 좋은 예: 오늘 받은 Gmail 이메일을 요약하고, 답장이 필요한 메일과 우선 처리해야 할 메일을 정리할 때 사용합니다

---

5. 실전 예시 — 이메일 정리 Skill 전체 구조

실제로 어떻게 작동하는지 '오늘 받은 이메일 정리 Skill'로 구체적으로 살펴보자.

이 Skill의 이름표는 다음과 같다:

--name: daily-email-briefing
description: 오늘 받은 Gmail 이메일을 요약하고, 답장이 필요한 메일과
             우선 처리해야 할 메일을 정리할 때 사용합니다.
--

그리고 업무 지시서에는 이런 내용이 담긴다:

역할: 바쁜 사용자를 돕는 이메일 비서

목표: 오늘 받은 이메일을 확인하고, 사용자가 바로 판단할 수 있도록 핵심 내용과 필요한 액션 정리

작업 순서:

1. 오늘 날짜 기준으로 받은 이메일 검색
2. 각 이메일의 발신자, 제목, 핵심 내용을 짧게 요약
3. 답장이 필요한 이메일을 따로 분류
4. 긴급하거나 중요한 이메일을 우선순위로 표시
5. 광고, 알림, 자동 발송 메일은 별도 분리
6. 답장해야 하는 이메일에는 추천 답장 방향 제안

출력 형식(표 형태로 자동 생성):

번호	발신	제목	핵심 내용	분류
1	...	...	...	답장 필요

판단 기준(답장 필요 이메일 조건):

• 상대방이 질문이나 요청을 한 경우
• 일정 조율이 필요한 경우
• 견적, 제안, 계약, 미팅 관련 내용이 있는 경우
• 사용자의 결정이나 확인이 필요한 경우

주의사항:

• 이메일 내용을 과도하게 추측하지 않는다
• 민감한 개인정보는 불필요하게 노출하지 않는다
• 답장을 직접 보내기 전에는 반드시 사용자 확인을 받는다

이 Skill이 등록되면, 이후에는 "오늘 이메일 정리해줘" 한 마디로 위 전체 프로세스가 자동 실행된다. Gmail 커넥터와 연결되어 있다면 실제로 받은 메일함을 읽고, 표 형태로 요약까지 완성해서 보여준다.

---

6. Skill 직접 등록하는 방법 (3단계)

Claude.ai에서 Skill을 등록하는 방법은 복잡하지 않다. 아래 순서를 따르면 10분 안에 완성된다.

Step 1. Claude 대화창 좌측 메뉴 → 사용자 지정 클릭
Step 2. 스킬 선택하기 → 스킬 만들기 → 스킬 지침 작성
Step 3. 이름(name), 설명(description), 지침 내용을 각각 입력한 후 [만들기] 클릭

등록 후에는 대화창에서 /를 입력하면 등록된 Skill 목록이 나타나며, 원하는 Skill을 선택해 바로 실행할 수 있다.

⚠️ 이메일 Skill 사용 전 선행 조건: 커넥터 메뉴에서 Gmail을 추가해야 한다. 외부 도구와 연동이 필요한 Skill은 반드시 해당 커넥터를 먼저 활성화해야 한다.

---

7. 이미 만들어진 Skill을 찾아 쓰는 방법

처음부터 직접 만들기가 어렵다면, 이미 공개된 고품질 Skill을 가져다 쓰는 방법도 있다.

• ClaWhub — clawhub.ai : 커뮤니티가 공유한 다양한 Skill 모음
• Andrej Karpathy Skill — OpenAI 공동 창립자 안드레이 카파시가 공개한 Skill 파일
• Context7 Skill — context7.com/skills
• Awesome Claude Skills — github.com/ComposioHQ/awesome-claude-skills

공개된 Skill을 가져온 후 description과 주의사항을 내 업무 방식에 맞게 수정하는 것만으로도 바로 실무에 활용 가능하다. 코딩 지식은 전혀 필요 없다.

---

8. Claude Skill Q&A — 수강생이 가장 자주 묻는 것

Q1. description을 짧게 써도 되나요?
A. 되도록 구체적으로 쓰는 것이 좋습니다. Claude는 사용자 요청과 description을 비교해서 Skill을 선택하기 때문에, description이 모호하면 잘못된 Skill이 호출되거나 아예 Skill이 작동하지 않을 수 있습니다. "~할 때 사용합니다"처럼 상황을 명확히 적어주세요.

Q2. 역할(role)이 꼭 있어야 하나요?
A. 필수는 아니지만, 있을 때 결과물 품질이 크게 높아집니다. "이메일 비서", "강의 요약 전문가"처럼 Claude에게 페르소나를 부여하면 답변의 톤, 깊이, 형식이 해당 역할에 맞게 일관되게 유지됩니다.

Q3. 주의사항 섹션은 왜 중요한가요?
A. 결과물에서 반드시 피해야 하는 것을 명시하는 공간입니다. "추측하지 않는다", "답장을 직접 보내기 전에 사용자 확인을 받는다"처럼 실수를 방지하는 안전장치 역할을 합니다. 특히 외부 도구(Gmail, 캘린더 등)와 연동되는 Skill일수록 주의사항을 꼼꼼히 작성해야 합니다.

Q4. 하나의 Skill이 여러 도구를 동시에 쓸 수 있나요?
A. 가능합니다. Gmail로 이메일을 읽고, 캘린더에서 일정을 확인한 뒤 통합 브리핑을 만드는 Skill도 만들 수 있습니다. 다만 처음에는 도구 하나짜리 Skill부터 만들어 익숙해진 뒤에 확장하는 것을 권장합니다.

Q5. Skill을 만든 뒤 수정할 수 있나요?
A. 네, 언제든지 수정 가능합니다. 실제로 Skill은 처음부터 완벽하게 만들려 하지 않는 것이 좋습니다. 일단 기본 구조로 만들어 써보고, 결과물이 기대와 다를 때 해당 섹션(출력 형식, 판단 기준 등)을 조금씩 수정하면서 완성도를 높여가는 방식이 실무에서 가장 효과적입니다.

---

마무리 — Skill은 나의 업무 DNA를 저장하는 파일이다

다시 정리하면, Claude Skill이 저장하는 것은 다음 7가지다.

1. 이름 — Claude가 Skill을 인식하는 고유 ID
2. 설명 — Claude가 Skill을 꺼내 쓸 시점을 판단하는 기준
3. 역할 — Claude가 어떤 전문가로 행동할지
4. 목표 — 이 Skill이 만들어야 하는 최종 결과
5. 작업 순서 — 단계별 처리 방식
6. 출력 형식 — 결과물의 구조와 형태
7. 기준 & 주의사항 — 좋은 결과와 나쁜 결과의 차이, 절대 하면 안 되는 것

이 7가지를 제대로 작성한 Skill 파일 하나가, 매번 반복해 입력하던 수백 글자의 프롬프트를 완전히 대체한다. 그리고 대화가 끝나면 사라지던 나의 업무 노하우가 파일로 남아 누적되고 팀과 공유된다.

여러분이 AI에게 가장 자주 반복하는 지시는 무엇인가요? 그것이 곧 첫 번째 Skill의 소재입니다. 아직 만들지 않으셨다면, 지금 바로 / 를 눌러 skill-creator를 시작해보세요. 댓글로 어떤 Skill을 만드셨는지 공유해 주시면 함께 발전시켜 보겠습니다. 🙏

---

작성자 : 강호종 AI 길라잡이 강사
생성형 AI 활용 업무 효율화 전문강사 | 디지털융합교육원 지도강사 & AI 전문강사 | 젠스파크 AI 전문강사 | (사)한국AINFT협회 이사
저서 : 『생성형 AI 활용 업무혁신』(2026.1) · 『이것이 GEO마케팅이다』(2026) 외
📞 010-9912-9934 | 📧 art386@naver.com | Ⓑ blog.naver.com/art386 | Ⓣ aiart386.tistory.com

---

#ClaudeSkill #클로드스킬 #SKILL파일 #SKILLmd #AI업무자동화 #생성형AI활용 #AI비서만들기 #프롬프트엔지니어링 #업무효율화 #Claude활용법 #이메일자동화 #AI강의 #강호종강사 #디지털전환 #GEO마케팅 #AI도구 #업무혁신 #AIliteracy #클로드활용 #나만의AI비서