1. Skills란?

Skills는 Claude가 특정 작업을 더 잘 수행할 수 있도록 도와주는 모듈형 기능입니다. 즉, AI가 특정 업무를 진행할 때 따라야 하는 작업 매뉴얼입니다. 2025년 10월 16일에 출시된 기능으로, Claude에게 도메인별 전문 지식, 워크플로우, 베스트 프랙티스를 제공하여 범용 에이전트를 전문가로 변환시킵니다.

1.1 Skills의 특징

Skills의 핵심 특징은 다음과 같습니다.

2. Skill 생성하기

2.1 SKILL.md 기본 구조

SKILL.md 파일은 YAML frontmatter와 마크다운 본문으로 구성됩니다. 기본 구조는 다음과 같습니다.

---
name: your-skill-name
description: 이 Skill이 무엇을 하고 언제 사용하는지 설명
---

# Your Skill Name

## Instructions
Claude가 따를 명확한 단계별 지침을 작성합니다.

## Examples
이 Skill 사용의 구체적인 예시를 보여줍니다.

name과 description은 Skill을 식별하고 설명하는 데 중요합니다. 특히 description은 사용자가 언제 이 Skill을 사용해야 하는지 이해하는 데 도움을 줍니다.

2.2 Skill 직접 생성하기

claude code에서는 정확한 위치에 SKILL.md 파일을 생성해주기만 하면 자동으로 해당 skill이 등록됩니다.

.claude > skills > 원하는 skill의 디렉토리 > SKILL.md 이 위치에 정확히 파일을 생성해야 합니다.

2.3 skill-creator를 활용하여 생성하기

Anthropic에서 제공하는 확장 스킬인 skill-creator를 활용하면 보다 쉽게 skill을 생성할 수 있습니다. skill-creator는 스킬을 새롭게 생성하거나, 기존에 생성된 스킬을 수정할 수 있도록 도와주는 스킬입니다.

2.3.1 skill-creator 설치하기

skill-creator는 claude code의 플러그인 마켓플레이스에서 설치할 수 있습니다.

마켓플레이스에서 skills 리포지토리를 먼저 추가하겠습니다.

# 마켓플레이스 등록
/plugin marketplace add anthropics/skills

리포지토리를 추가했으면 /plugin 명령어를 입력하고 Marketplace 탭으로 이동합니다.

여기서 anthropic-agent-skills 리포지토리를 선택하고 Browse plugins 옵션을 선택합니다.

그러면 아래와 같이 설치할 수 있는 플러그인 목록이 나타납니다. document-skills는 excel, word, pptx, pdf 등 문서 작업 관련 스킬을 제공하는 플러그인이고, example-skills는 skill-creator 스킬을 포함한 예시 스킬들을 제공하는 플러그인입니다.

여기서 엔터를 눌러 설치를 진행해도 되고, 터미널에서 아래 명령어로도 설치할 수 있습니다.

# 플러그인 설치
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

example-skills 플러그인 안에 skill-creator가 포함되어 있습니다. 플러그인 설치 후 claude code를 재시작하면 skill-creator를 사용할 수 있습니다.

/skills 명령어를 입력하면 설치된 skills 플러그인 목록이 나타납니다. skill-creator가 정상적으로 설치된 것을 확인할 수 있습니다.

이제 skill-creator 스킬을 활용해서 원하는 스킬을 생성해달라는 명령어를 입력합니다.

skill-creator가 정상적으로 설치되었다면 클로드 코드가 skill-creator를 성공적으로 로드하고 스킬 생성에 skill-creator를 활용합니다.

3. Skill 사용 예시

3.1 commit-message-generator

스킬 직접 생성 방식으로 commit message를 생성하고 commit까지 진행하는 스킬을 만들어보겠습니다.

3.1.1 SKILL.md 작성하기

프로젝트 내에 .claude/skills/commit-message-generator/SKILL.md 파일을 생성하고 아래와 같이 작성합니다.

---
name: commit-message-generator
description: git diff에서 명확한 커밋 메시지를 생성하고 커밋을 진행합니다.
---

# Commit Message Generator

## Instructions

1. `git diff --staged`를 실행하여 스테이징된 변경사항 확인
2. 변경사항이 없으면 `git status`로 현재 상태를 확인하고 사용자에게 안내
3. 다음 형식으로 커밋 메시지 생성:
   - 50자 이하의 요약 (첫 줄)
   - 빈 줄
   - 상세 설명 (무엇을, 왜 변경했는지)
   - 영향받는 컴포넌트 목록
4. 생성된 커밋 메시지를 사용자에게 보여주고 확인 요청
5. 사용자가 승인하면 해당 메시지로 `git commit` 실행
6. 사용자가 수정을 원하면 수정된 메시지로 커밋 진행

## Commit Message Format

<type>: <한국어 요약>

<한국어 상세 설명>

영향 범위: <컴포넌트 목록>


### Types
- feat: 새로운 기능
- fix: 버그 수정
- refactor: 코드 리팩토링
- docs: 문서 변경
- style: 코드 포맷팅
- test: 테스트 추가/수정
- chore: 기타 변경사항

## Best Practices
- 커밋 메시지는 반드시 한국어로 작성
- 첫 줄 요약은 50자 이하로 작성
- 무엇을, 왜 변경했는지 명확하게 설명
- 첫 줄은 명령형으로 작성 (예: "기능 추가", "버그 수정")

## 예시

feat: Todo 리스트 컴포넌트 추가

할 일 목록을 관리할 수 있는 기능 구현
- 할 일 추가/삭제/완료 기능
- 로컬 스토리지 연동

영향 범위: TodoList, TodoItem, TodoForm

❗️ 이 스킬은 예시일 뿐이며, 파일 내용은 사용자의 필요에 따라 자유롭게 수정할 수 있습니다.

3.1.2 Skill 사용하기

이제 생성한 스킬을 사용해서 커밋 메시지를 생성하고 커밋까지 진행해보겠습니다.

입력한 명령어: 커밋 메시지를 생성하고 커밋하세요.

스킬 사용에 대해 언급하지 않아도 클로드 코드가 자동으로 commit-message-generator 스킬을 인식하고 실행합니다.

커밋 메시지를 생성한 후 사용자에게 보여주고 승인을 요청합니다. 승인을 하면 해당 메시지로 커밋이 진행됩니다.

4. 제공되는 기본 Skills

Anthropic에서 제공하는 사전 빌드된 Agent Skills입니다.

5. Skills 관리

5.1 설치된 Skills 확인

# Claude에게 직접 물어보기
> 어떤 Skills가 사용 가능한가요?

# 파일 시스템에서 확인
ls ~/.claude/skills/          # 개인 Skills
ls .claude/skills/            # 프로젝트 Skills
cat ~/.claude/skills/my-skill/SKILL.md  # 특정 Skill 내용 확인

5.2 Skills 업데이트 및 삭제

• Skills 업데이트: SKILL.md 파일을 수정한 후 Claude Code 재시작이 반드시 필요합니다.

• Skills 삭제: 아래 명령어로 특정 스킬 디렉토리를 삭제합니다.

# 삭제
rm -rf ~/.claude/skills/my-skill