Claude Academy
로그인

스킬이란 무엇인가요?

강의 19분
이 레슨에서이 레슨을 마치면
  • Claude Code 스킬이 무엇이며 어떻게 작동하는지 정의합니다
  • 스킬이 어디에 위치하는지 설명합니다 (개인용 vs. 프로젝트 디렉터리)
  • 스킬, CLAUDE.md, 슬래시 명령어를 구분합니다
  • 스킬이 적합한 커스터마이징 도구인 상황을 식별합니다
Sign in to save your progressYou can keep reading without an account, but completed lessons won't be saved.
Sign in

스킬이란 무엇인가요?

스킬이란 무엇인가요? · 3분

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

한국어 대본
  • 00:00팀의 코딩 표준을 Claude에게 설명할 때마다 같은 설명을 반복합니다.
  • 00:08PR을 검토할 때마다 원하는 피드백 구조를 다시 설명합니다.
  • 00:13커밋 메시지를 작성할 때마다 선호하는 형식을 Claude에게 다시 알려 줍니다.
  • 00:17그리고 Skills가 이를 해결합니다.
  • 00:20Skill은 Claude에게 어떤 일을 한 번 가르치는 Markdown 파일이고,
  • 00:24Claude는 관련이 있을 때마다 그 지식을 자동으로 적용합니다.
  • 00:30AgentSkills는 에이전트가 찾아내
  • 00:37더 정확하고 효율적으로 작업하는 데 사용할 수 있는 지침, 스크립트, 리소스가 담긴 폴더입니다.
  • 00:41Claude Code에는 skill.md 파일이 있습니다.
  • 00:45설명은 Claude가 Skill을 사용할지 결정하는 기준입니다.
  • 00:49Claude에게 이 PR을 검토해 달라고 요청하면, 사용 가능한 Skill
  • 00:53설명과 요청을 대조해 이 Skill을 찾아냅니다.
  • 00:57요청을 읽고 모든 사용 가능한 Skill 설명과 비교한 뒤 일치하는 Skill을 활성화합니다.
  • 01:02필요한 사람에 따라 Skill을 몇 곳에 저장할 수 있습니다. 개인 Skill은
  • 01:11홈 디렉터리의 .claude/skills에 저장되며 모든 프로젝트에서 함께 사용할 수 있습니다. 이것들은
  • 01:18개인 선호, 커밋 메시지 스타일, 문서 형식, 코드를 설명하는 방식입니다.
  • 01:24프로젝트 Skill은 저장소 루트 디렉터리 안의 .claude/skills에 저장됩니다.
  • 01:30저장소를 클론하는 사람은 누구나 이 Skill을 자동으로 받습니다.
  • 01:33여기에 회사의 브랜드 가이드라인, 선호하는 폰트와 웹 디자인에 사용하는 색상 같은 팀 표준이 들어갑니다.
  • 01:42Claude Code에는 동작을 사용자 지정하는 여러 방법이 있습니다.
  • 01:46Skills가 특별한 이유는 자동으로, 작업별로 적용되기 때문입니다.
  • 01:51CLAUDE.md 파일은 모든 대화에 로드됩니다.
  • 01:54Claude가 항상 TypeScript의 strict 모드를 사용하게 하려면 CLAUDE.md 파일에 넣습니다.
  • 01:59반면 Skills는 요청과 일치할 때 필요에 따라 로드됩니다.
  • 02:03이름과 설명만 로드하므로 전체 컨텍스트 창을 채우지 않습니다.
  • 02:08디버깅할 때 PR 검토 체크리스트까지 컨텍스트에 들어 있을 필요는 없습니다.
  • 02:13실제로 검토를 요청하면 로드됩니다.
  • 02:17슬래시 명령은 직접 입력해야 합니다.
  • 02:19Skills는 그렇지 않습니다.
  • 02:21Claude는 상황을 인식하면 Skills를 적용합니다.
  • 02:27Skills는 특정 작업에 적용되는 전문 지식에 가장 적합합니다.
  • 02:32팀이 따르는 코드 검토 표준,
  • 02:34선호하는 커밋 메시지 형식,
  • 02:37조직의 브랜드 가이드라인 같은 것입니다.
  • 02:42같은 내용을 Claude에게 반복해서 설명하고 있다면,
  • 02:46그 내용은 작성할 Skill이 있다는 뜻입니다.
Watch on YouTube

핵심 요약

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

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

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

스킬이란 무엇인가

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

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

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

yaml
---
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가 스킬을 발견하고, 매칭하고, 로드하는 방식을 배우게 됩니다.