스킬이란 무엇인가요?

스킬이란 무엇인가요?

핵심 요약

• 스킬은 지침 모음 폴더로, Claude Code가 이를 발견하고 활용하여 작업을 더 정확하게 처리할 수 있게 합니다. 각 스킬은 프런트매터에 이름과 설명이 포함된 SKILL.md 파일로 존재합니다
• Claude는 설명을 사용해 스킬을 요청과 매칭합니다. 사용자가 Claude에게 무언가를 요청하면, Claude는 요청 내용을 사용 가능한 스킬 설명과 비교하여 일치하는 스킬을 활성화합니다
• 개인 스킬은 ~/.claude/skills에 위치하며 모든 프로젝트에서 함께 사용됩니다. 프로젝트 스킬은 저장소 내부의 .claude/skills에 위치하며 해당 저장소를 클론하는 모든 사람과 공유됩니다
• 스킬은 필요할 때 로드됩니다 — 모든 대화에 로드되는 CLAUDE.md나 명시적으로 호출해야 하는 슬래시 명령어와 달리, 스킬은 Claude가 상황을 인식할 때 자동으로 활성화됩니다
• 같은 내용을 Claude에게 반복해서 설명하고 있다면, 그것이 바로 스킬로 작성되어야 할 대상입니다

팀의 코딩 표준을 Claude에게 설명할 때마다 같은 말을 반복하게 됩니다. PR을 검토할 때마다 피드백을 어떻게 구성하길 원하는지 다시 설명합니다. 커밋 메시지를 작성할 때마다 선호하는 형식을 Claude에게 다시 알려줍니다. 스킬은 이 문제를 해결합니다.

스킬은 Claude에게 어떤 작업을 한 번만 가르치는 마크다운 파일입니다. 이후 Claude는 관련이 있을 때마다 그 지식을 자동으로 적용합니다.

스킬이란 무엇인가

스킬은 Claude Code가 발견하고 활용하여 작업을 더 정확하게 처리할 수 있게 하는 지침 및 리소스 모음 폴더입니다. 각 스킬은 프런트매터에 이름과 설명이 포함된 SKILL.md 파일로 존재합니다.



설명은 Claude가 해당 스킬을 사용할지 여부를 결정하는 기준입니다. 사용자가 Claude에게 PR을 검토해 달라고 요청하면, Claude는 요청 내용을 사용 가능한 스킬 설명과 매칭하여 관련된 스킬을 찾습니다. Claude는 요청을 읽고, 이를 사용 가능한 모든 스킬 설명과 비교한 뒤, 일치하는 스킬을 활성화합니다.

스킬의 프런트매터는 다음과 같은 모습입니다:

---
name: pr-review
description: Reviews pull requests for code quality. Use when reviewing PRs or checking code changes.
---

프런트매터 아래에는 실제 지침 — 검토 체크리스트, 형식 선호 사항, 또는 해당 작업을 위해 Claude가 알아야 할 내용 — 을 작성합니다.

스킬은 어디에 위치하는가

누가 필요로 하는지에 따라 스킬을 다른 위치에 저장할 수 있습니다:

• 개인 스킬은 ~/.claude/skills(홈 디렉터리)에 위치합니다. 이는 커밋 메시지 스타일, 문서 형식, 코드 설명을 선호하는 방식 등 모든 프로젝트에서 함께 사용됩니다.
• 프로젝트 스킬은 저장소의 루트 디렉터리 내부 .claude/skills에 위치합니다. 저장소를 클론하는 모든 사람이 자동으로 이 스킬을 얻게 됩니다. 이곳에는 회사의 브랜드 가이드라인, 웹 디자인에 선호하는 글꼴과 색상 등 팀 표준이 위치합니다.

Windows에서는 개인 스킬이 C:/Users/<your-user>/.claude/skills에 위치합니다.

프로젝트 스킬은 코드와 함께 버전 관리에 커밋되므로 팀 전체가 이를 공유하게 됩니다.

스킬 vs. CLAUDE.md vs. 슬래시 명령어

Claude Code에는 동작을 커스터마이징하는 여러 방법이 있습니다. 스킬은 자동으로 작동하며 작업별로 특화되어 있다는 점에서 독특합니다. 비교하면 다음과 같습니다:

• CLAUDE.md 파일은 모든 대화에 로드됩니다. Claude가 항상 TypeScript의 strict 모드를 사용하길 원한다면, 이는 CLAUDE.md에 들어갑니다.
• 스킬은 요청과 일치할 때 필요에 따라 로드됩니다. Claude는 처음에는 이름과 설명만 로드하므로 컨텍스트 윈도우 전체를 채우지 않습니다. PR 검토 체크리스트는 디버깅 중일 때는 컨텍스트에 있을 필요가 없으며, 실제로 검토를 요청할 때 로드됩니다.
• 슬래시 명령어는 명시적으로 입력해야 합니다. 스킬은 그렇지 않습니다. Claude는 상황을 인식하면 스킬을 적용합니다.

Claude가 요청에 맞는 스킬을 매칭하면, 터미널에서 로드되는 것을 확인할 수 있습니다:



스킬을 사용해야 할 때

스킬은 특정 작업에 적용되는 전문 지식에 가장 적합합니다:

• 팀이 따르는 코드 리뷰 표준
• 선호하는 커밋 메시지 형식
• 조직의 브랜드 가이드라인
• 특정 유형의 문서를 위한 문서 템플릿
• 특정 프레임워크를 위한 디버깅 체크리스트

기준은 간단합니다: 같은 내용을 Claude에게 반복해서 설명하고 있다면, 그것이 바로 스킬로 작성되어야 할 대상입니다.

레슨 되돌아보기

• Claude Code와의 최근 상호작용을 떠올려 보세요. 어떤 지침을 반복해서 설명했나요? 스킬이 있었다면 시간을 얼마나 절약할 수 있었을까요?
• 팀의 워크플로를 생각해 보세요. 어떤 표준이나 프로세스가 스킬로 인코딩되었을 때 가장 큰 이점을 얻을 수 있을까요?

다음 단계

다음 레슨에서는 처음부터 직접 스킬을 만들어 보고, Claude Code가 내부적으로 스킬을 발견하고, 매칭하고, 로드하는 방식을 배우게 됩니다.