스킬이란 무엇인가요?
학습할 내용
예상 소요 시간: 15분
이 강의가 끝날 때쯤이면 다음을 수행할 수 있게 됩니다.
- Claude Code 스킬이 무엇이며 어떻게 작동하는지 정의
- 스킬이 위치하는 곳(개인 디렉터리 vs. 프로젝트 디렉터리) 설명
- 스킬, CLAUDE.md, 슬래시 명령어 구분
- 스킬이 올바른 사용자 지정 도구인 시나리오 식별
스킬이란 무엇인가요?
(3분)
Claude Code가 특정 작업을 자동으로 처리하는 방법 재사용 가능한 마크다운 파일 Claude에게 요구사항 검토나 커밋 메시지 작성을 요청할 때마다 지침을 반복
주요 요점
- 스킬은 Claude Code가 검색하여 작업을 더 정확하게 처리하는 데 사용할 수 있는 지침 폴더입니다.
스킬은 프런트매터에 이름과 설명이 있는
SKILL.md파일 내에 존재합니다. - Claude는 설명을 사용하여 스킬을 요청과 일치시킵니다. Claude에게 작업을 요청하면, 사용자의 요청을 사용 가능한 스킬 설명과 비교하여 일치하는 스킬을 활성화합니다.
- User 스킬은
~/.claude/skills에 위치하며 모든 프로젝트에서 사용됩니다. - 프로젝트 스킬은 리포지터리 내
.claude/skills에 위치하며 이를 복제하는 모든 사람과 공유됩니다. - 스킬은 필요할 때 로드됩니다. 모든 대화에 로드되는 CLAUDE.md나 명시적 호출이 필요한 슬래시 명령어와 달리, Claude가 상황을 인식하면 스킬이 자동으로 활성화됩니다.
- Claude에게 반복적으로 동일한 내용을 설명하고 있다고 느낀다면, 작성해야 할 스킬이 있다는 의미입니다.
팀의 코딩 표준을 Claude에게 설명할 때마다 반복하고 있는 것입니다. PR 검토를 할 때마다 피드백 구조를 원하는 방식을 다시 설명합니다. 커밋 메시지를 작성할 때마다 선호하는 형식을 Claude에게 상기시킵니다. 스킬은 이러한 문제를 해결합니다.
스킬은 Claude에게 한 번에 무언가를 수행하는 방법을 가르치는 마크다운 파일입니다. 그러면 Claude는 관련될 때마다 해당 지식을 자동으로 적용합니다.
스킬이란 무엇인가
스킬은 Claude Code가 검색하여 작업을 더 정확하게 처리하는 데 사용할 수 있는 지침 및 리소스 폴더입니다. 각 스킬은 프런트매터에 이름과 설명이 있는 SKILL.md 파일 내에 존재합니다.
설명은 Claude가 스킬을 사용할지 여부를 결정하는 방법입니다. Claude에게 PR 검토를 요청하면, 요청을 사용 가능한 스킬 설명과 일치시켜 관련 스킬을 찾습니다. Claude는 요청을 읽고, 사용 가능한 모든 스킬 설명과 비교하여 일치하는 스킬을 활성화합니다.
다음은 스킬의 프런트매터 모양입니다.
---
name: pr-review
description: 코드 품질에 대해 풀 리퀘스트를 검토합니다. PR을 검토하거나 코드 변경 사항을 확인할 때 사용합니다.
---
프런트매터 아래에는 실제 지침, 즉 검토 체크리스트, 서식 기본 설정 또는 해당 작업을 위해 Claude가 알아야 할 모든 것을 작성합니다.
스킬이 위치하는 곳
스킬이 필요한 대상에 따라 스킬을 다른 위치에 저장할 수 있습니다.
- 개인 스킬은 홈 디렉터리인
~/.claude/skills에 위치합니다. 이는 모든 프로젝트에서 사용자를 따라다니며, 커밋 메시지 스타일, 문서화 형식, 코드를 설명하는 방식 등에 적용됩니다. - 프로젝트 스킬은 리포지터리 루트 디렉터리 내의
.claude/skills에 위치합니다. 리포지토리를 복제하는 모든 사람이 이러한 스킬을 자동으로 받습니다. 팀 표준, 회사 브랜드 가이드라인, 웹 디자인용 기본 글꼴, 색상 등이 여기에 포함됩니다.
Windows에서는 개인 스킬이 C:/Users/<사용자 이름>/.claude/skills에 위치합니다.
프로젝트 스킬은 코드와 함께 버전 관리에 커밋되므로 팀 전체에서 공유됩니다.
스킬 vs. CLAUDE.md vs. 슬래시 명령어
Claude Code에는 동작을 사용자 지정하는 몇 가지 방법이 있습니다. 스킬은 자동적이며 작업별이라는 점에서 고유합니다. 다음은 그 비교입니다.
- CLAUDE.md 파일은 모든 대화에 로드됩니다. Claude가 항상 TypeScript의 엄격 모드를 사용하도록 하려면 CLAUDE.md에 넣습니다.
- 스킬은 요청과 일치할 때 필요에 따라 로드됩니다. Claude는 처음에 이름과 설명만 로드하므로 전체 컨텍스트 창을 채우지 않습니다. 디버깅 중에는 PR 검토 체크리스트가 컨텍스트에 있을 필요가 없으며, 실제로 검토를 요청할 때 로드됩니다.
- 슬래시 명령어는 명시적으로 입력해야 합니다. 스킬은 그렇지 않습니다. Claude가 상황을 인식하면 자동으로 적용합니다.
Claude가 요청과 스킬을 일치시키면 터미널에 로드되는 것을 볼 수 있습니다.
스킬을 사용해야 하는 경우
스킬은 특정 작업에 적용되는 전문 지식에 가장 적합합니다.
- 팀이 따르는 코드 검토 표준
- 선호하는 커밋 메시지 형식
- 조직의 브랜드 가이드라인
- 특정 유형의 문서에 대한 문서 템플릿
- 특정 프레임워크에 대한 디버깅 체크리스트
간단한 경험 법칙은 다음과 같습니다. Claude에게 반복적으로 동일한 내용을 설명하고 있다면, 작성해야 할 스킬이 있다는 의미입니다.
강의 성찰
- Claude Code와의 최근 상호 작용을 생각해 보세요. 어떤 지침을 반복적으로 설명하고 있었나요? 스킬이 어떻게 시간을 절약해 줄 수 있었을까요?
- 팀의 워크플로를 고려해 보세요. 어떤 표준이나 프로세스가 스킬로 인코딩될 때 가장 큰 이점을 얻을 수 있을까요?
다음 단계
다음 강의에서는 첫 번째 스킬을 처음부터 만들고 Claude Code가 백그라운드에서 스킬을 검색, 일치 및 로드하는 방법을 알아봅니다.
피드백
강의를 진행하면서 작업에서 스킬을 어떻게 사용하고 있는지, 그리고 제공할 피드백이 있다면 기꺼이 듣고 싶습니다. 여기에서 피드백을 공유해 주세요.