로드 중
이 레슨에서이 레슨을 마치면
  • Claude Code skills가 무엇이며 어떻게 작동하는지 정의합니다
  • skills가 어디에 위치하는지 설명합니다(개인 디렉터리 대 프로젝트 디렉터리)
  • skills, CLAUDE.md, 슬래시 명령어의 차이를 구분합니다
  • skills가 적절한 커스터마이징 도구가 되는 상황을 파악합니다

Skills란 무엇인가요?

로드 중

Skills란 무엇인가요? · 3 min

요약스크립트

이 영상에서는 skills를 소개합니다 — 특정 작업을 자동으로 처리하는 방법을 Claude Code에 알려주는 재사용 가능한 마크다운 파일입니다. PR을 검토하거나 커밋 메시지를 작성해 달라고 Claude에게 요청할 때마다 지침을 반복해서 설명하는 대신, skill을 한 번만 작성해 두면 해당 작업이 발생할 때마다 Claude가 이를 적용합니다. 이 영상에서는 skills가 무엇인지, 어디에 위치하는지, 그리고 다른 Claude Code 커스터마이징 옵션과 어떻게 비교되는지 다룹니다.

핵심 요약

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

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

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

Skills란 무엇인가

Skills는 지침과 리소스로 이루어진 폴더로, Claude Code가 이를 발견하고 사용하여 작업을 더 정확하게 처리할 수 있습니다. 각 skill은 프런트매터에 이름과 설명이 포함된 SKILL.md 파일로 구성됩니다.

코드 에디터에서 열린 pr-review SKILL.md. 하드코딩된 시크릿 금지, Pydantic 스키마 등의 검토 항목이 보입니다.

설명은 Claude가 해당 skill을 사용할지 결정하는 기준입니다. Claude에게 PR 검토를 요청하면, Claude는 여러분의 요청을 사용 가능한 skill 설명과 비교하여 관련된 skill을 찾습니다. Claude는 여러분의 요청을 읽고 이를 사용 가능한 모든 skill 설명과 비교한 뒤, 일치하는 것을 활성화합니다.

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

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

프런트매터 아래에는 실제 지침 — 검토 체크리스트, 포맷 선호도, 또는 Claude가 해당 작업을 위해 알아야 할 그 밖의 모든 것 — 을 작성합니다.

Skills는 어디에 위치하는가

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

  • 개인 skills는 ~/.claude/skills(홈 디렉터리)에 위치합니다. 이는 여러분의 모든 프로젝트에서 함께 사용됩니다 — 커밋 메시지 스타일, 문서 포맷, 코드 설명 방식을 선호하는 방식대로요.
  • 프로젝트 skills는 저장소의 루트 디렉터리 안에 있는 .claude/skills에 위치합니다. 저장소를 클론하는 사람은 누구나 이러한 skills를 자동으로 얻게 됩니다. 이곳은 회사의 브랜드 가이드라인, 선호하는 폰트, 웹 디자인용 색상 등 팀 표준이 위치하는 곳입니다.

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

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

Skills vs. CLAUDE.md vs. 슬래시 명령어

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

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

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

sg-221 브랜치의 풀 리퀘스트를 검토해 달라는 요청 후, Skill pr-review 라인에 "Successfully loaded skill"이라고 표시됩니다.

Skills를 언제 사용해야 하는가

Skills는 특정 작업에 적용되는 전문 지식에 가장 효과적입니다:

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

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

레슨 되돌아보기

  • 최근 Claude Code와의 상호작용을 떠올려 보세요. 어떤 지침을 반복해서 설명했나요? skill이 있었다면 시간을 얼마나 절약할 수 있었을까요?
  • 팀의 워크플로우를 생각해 보세요. 어떤 표준이나 프로세스를 skills로 만들면 가장 큰 도움이 될까요?

다음 단계

다음 레슨에서는 처음부터 여러분만의 skill을 만들고, Claude Code가 내부적으로 skills를 어떻게 발견하고, 매칭하고, 로드하는지 배우게 됩니다.