스킬이란 무엇인가

학습목표

• 예상 학습 시간: 15 분

• 이 수업을 마치면 다음을 할 수 있습니다.

  • Claude Code 스킬이 무엇이며 어떻게 작동하는지 정의하기
  • 스킬이 어디에 저장되는지(개인 디렉터리 vs. 프로젝트 디렉터리) 설명하기
  • 스킬, CLAUDE.md, 슬래시 명령어의 차이 구분하기
  • 스킬이 적합한 커스터마이징 도구인 상황 파악하기

스킬이란 무엇인가요?

(3분)

이 영상은 스킬(skills)을 소개합니다. 스킬은 Claude Code가 특정 작업을 더 정확하게 자동 처리할 수 있도록 가르치는 재사용 가능한 마크다운 파일입니다. Pull Request 리뷰를 하거나 커밋 메시지를 작성해 달라고 요청할 때마다 같은 지시를 반복하는 대신, 스킬을 한 번 작성해 두면 Claude가 해당 상황이 생길 때마다 자동으로 적용합니다. 영상에서는 스킬이 무엇인지, 어디에 저장되는지, 그리고 Claude Code의 다른 커스터마이징 옵션과 어떻게 다른지를 다룹니다.

핵심 요약

• 스킬은 지침이 담긴 폴더 그 자체입니다. Claude Code는 폴더에서 지침을 찾아 작업을 더 정확하게 수행하도록 돕습니다. 각 스킬은 프론트매터에 이름과 설명이 들어있는 SKILL.md 파일로 구성됩니다.
• Claude는 설명(description)을 보고 사용자의 요청과 스킬을 매칭합니다. Claude에게 무언가를 요청하면, Claude는 사용 가능한 스킬들의 설명을 읽고 사용자 요청과 비교해 일치하는 스킬을 자동으로 활성화합니다.
• 개인 계정 전체에서 활성화되는 스킬은 ~/.claude/skills에 저장되어 모든 프로젝트에 따라다닙니다. 프로젝트 전용 스킬은 저장소 루트의 .claude/skills에 저장되며, 저장소를 클론하는 사람 누구에게나 공유됩니다.
• 스킬은 필요할 때만 로드됩니다. CLAUDE.md(모든 대화에 로드됨)나 슬래시 명령어(명시적으로 호출해야 함)와 달리, 스킬은 Claude가 상황을 인식하면 자동으로 활성화됩니다.
• Claude에게 같은 설명을 반복하고 있다면, 그건 곧 스킬로 만들 여지가 있다는 뜻입니다.

팀의 코딩 표준을 Claude에게 설명할 때마다 같은 말을 반복하고 있다면, 매번 PR 리뷰를 할 때마다 어떤 형식으로 피드백을 받고 싶은지 다시 설명하고 있다면, 매번 커밋 메시지를 만들 때마다 원하는 포맷을 상기시키고 있다면, 스킬이 이 반복을 줄여 줍니다.

스킬은 Claude에게 어떤 일을 하는 법을 한 번만 설명해도 되게 해주는 마크다운 파일입니다. Claude는 스킬에 담긴 지식을 관련 상황에서 자동으로 적용합니다.

스킬이 하는 일

스킬은 Claude Code가 찾아서 사용할 수 있는 지침과 리소스의 묶음입니다. 각 스킬은 프론트매터에 이름과 설명이 들어있는 SKILL.md 파일에 담깁니다.

설명(description)은 Claude가 해당 스킬을 사용할지 결정하는 기준이 됩니다. 예를 들어 PR 리뷰를 요청하면, Claude는 자기가 사용 가능한 스킬에 있는 설명과 요청 내용을 비교해, 적합한 스킬을 찾아 활성화합니다.

• 사용자가 작업 요청을 보냄 → Claude가 사용자의 요청을 읽음 → Claude는 모든 스킬 설명을 읽고 사용자 요청과 일치하는 스킬을 찾음 → Claude가 해당 스킬을 자동 로드해 사용함

스킬의 프론트매터 예시는 다음과 같습니다.

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

프론트매터 아래에는 실제 지시사항을 작성하게 됩니다. 예를 들어 리뷰 체크리스트, 출력 형식 선호, 해당 작업에 필요한 기준 등을 적어두면 됩니다.

스킬 저장 위치

누가 스킬을 쓸 수 있는지에 따라 스킬의 저장 위치가 다릅니다.

• 개인 스킬(Personal skills): ~/.claude/skills(홈 디렉터리)에 저장됩니다. 커밋 메시지 스타일, 문서 포맷, 코드 설명 방식 같은 개인 선호가 여기에 들어갑니다.
  • Windows에선 C:/Users/<your-user>/.claude/skills에 저장됩니다.
• 프로젝트 스킬(Project skills): 저장소 루트의 .claude/skills에 저장됩니다. 프로젝트 스킬은 버전 관리에 커밋되어 코드와 함께 공유되므로, 팀 전체가 동일한 기준을 사용할 수 있습니다. 저장소를 클론하는 사람은 누구나 같은 스킬을 자동으로 갖게 됩니다. 팀 표준이나 조직의 가이드라인이 여기에 들어갑니다.

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

Claude Code에는 여러 가지 커스터마이징 방법이 있지만, 스킬은 자동으로 활성화되며 작업별로 특화되어 있다는 점이 특징입니다.

• CLAUDE.md: 모든 대화에서 로드됩니다. 예를 들어 "항상 TypeScript strict 모드를 사용해라" 같은 상시 규칙은 CLAUDE.md에 적합합니다.

• Skills(스킬): 요청과 매칭될 때만 필요에 따라 로드됩니다. Claude는 처음에는 이름과 설명만 로드하므로, 컨텍스트를 불필요하게 많이 차지하지 않습니다. PR 리뷰 체크리스트는 디버깅 중에는 필요 없고, 리뷰를 요청했을 때만 로드되면 됩니다.

• 슬래시 명령어: 사용자가 명시적으로 입력해야 합니다. 스킬은 그렇지 않고, Claude가 상황을 인식하면 자동으로 적용됩니다.

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

언제 스킬을 쓰면 좋을까?

스킬은 특정 작업에 적용되는 전문 지식이나 기준을 담기에 좋습니다.

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

기준은 단순합니다. Claude에게 같은 설명을 반복하고 있다면, 그건 스킬로 만들 차례입니다.

학습 후 돌아보기

• 최근 Claude Code와의 상호작용에서 반복해서 설명했던 지시사항은 무엇이었나요? 스킬이 있었다면 어떻게 시간을 절약할 수 있었을까요?
• 팀의 워크플로에서 어떤 표준이나 프로세스를 스킬로 담아두면 가장 도움이 될까요?