Claude를 처음 쓸 때는 그냥 채팅하듯 질문하면 됐지만, 좀 더 쓰다 보면 “이 기능을 항상 똑같이 동작하게 할 수는 없나?”라는 생각이 드실 거예요. 그럴 때 필요한 게 바로 Claude Skills예요. 스킬을 제대로 쓸 줄 알면 Claude가 완전히 다른 도구가 돼요.
이 글은 Claude Skills를 처음 접하는 분들을 위해 기초부터 차근차근 설명해요. 스킬이 뭔지, 어떻게 설치하는지, 어떻게 호출하는지, 그리고 직접 만드는 법까지 다 알려드릴게요.
Claude Skills 기본 개념 잡기
사용 방법을 익히기 전에 스킬이 어떤 존재인지 이해하는 게 먼저예요.
스킬 = 저장된 전문가 설정
Claude Skills는 Claude에게 특정 전문가처럼 동작하도록 미리 설정해 둔 파일이에요. “너는 지금부터 엄격한 코드 리뷰어야. 보안 취약점을 최우선으로 찾고, 발견한 문제마다 심각도를 H/M/L로 표시해”라는 지시를 파일로 저장해 두고, 필요할 때마다 `/code-review`라고 입력해서 불러오는 방식이에요.
스킬 파일의 위치
스킬 파일은 마크다운(.md) 형식으로 저장돼요. 저장 위치에 따라 범위가 달라져요.
- 프로젝트 전용: `.claude/skills/` 디렉터리 (해당 프로젝트에서만 사용)
- 전역 공유: `~/.claude/skills/` 디렉터리 (모든 프로젝트에서 사용)
- 팀 공유: Git 저장소에 포함해서 팀원과 공유
왜 스킬이 필요한가요?
매번 긴 지시를 입력하는 건 번거롭고 일관성도 떨어져요. 스킬을 사용하면 짧은 명령어 하나로 복잡한 작업을 시작할 수 있고, 결과물의 품질과 형식이 항상 동일하게 유지돼요. 팀에서 사용하면 표준화 효과도 생겨요.
기존 스킬 설치하고 사용하기
남이 만들어 놓은 스킬을 가져다 쓰는 것부터 시작해 봐요. 가장 빠르게 효과를 볼 수 있어요.
Anthropic 공식 스킬 가져오기
Anthropic과 커뮤니티에서 만들어 둔 스킬들이 있어요. GitHub 저장소나 Claude Skills 마켓플레이스에서 스킬 파일을 찾아볼 수 있어요. 마음에 드는 스킬 파일을 다운로드해서 `.claude/skills/` 디렉터리에 넣으면 설치 완료예요. 별도의 설치 명령어가 필요하지 않아요.
슬래시 명령어로 스킬 호출하기
스킬 파일이 준비되면 Claude Code 채팅창에서 `/`를 입력하면 사용 가능한 스킬 목록이 자동완성으로 나타나요. 원하는 스킬 이름을 선택하거나 직접 입력하면 돼요.
- `/code-review` — 코드 리뷰 스킬 실행
- `/deep-research 검색할 주제` — 심층 리서치 스킬 실행
- `/translate 영어로 번역해줘` — 번역 스킬 실행
스킬마다 인자를 받는 방식이 다를 수 있으니, 스킬 파일 내 설명을 읽어보는 게 좋아요.
스킬 목록 확인하기
현재 사용 가능한 스킬을 확인하려면 채팅창에 `/`만 입력해 보세요. 프로젝트 전용 스킬과 전역 스킬이 모두 목록에 나타나요. 또는 `.claude/skills/` 디렉터리를 직접 열어서 파일 목록을 확인할 수도 있어요.
나만의 커스텀 스킬 만들기
기존 스킬로 부족하다면 직접 만들어 보세요. 생각보다 어렵지 않아요.
스킬 파일 기본 구조
스킬 파일은 frontmatter와 본문으로 구성돼요. frontmatter에는 스킬의 메타 정보를, 본문에는 Claude에게 줄 상세 지시를 작성해요. frontmatter 필드 중 꼭 필요한 것들이 있어요.
- name: 슬래시 명령어로 사용할 이름 (예: `my-skill`이면 `/my-skill`로 호출)
- description: 스킬이 무엇을 하는지, 언제 사용하는지 설명
- tools: 사용할 도구 목록 (예: Read, Edit, WebSearch 등)
본문 작성 팁
스킬 본문은 Claude에게 주는 지시문이에요. 좋은 지시문을 쓰는 몇 가지 원칙이 있어요.
- 역할을 명확히 정의해요 (“너는 ~~~ 전문가야”로 시작)
- 작업 절차를 단계별로 나열해요
- 출력 형식을 구체적으로 지정해요 (마크다운, JSON, 표 등)
- 하지 말아야 할 것도 명시해요 (금지 사항)
스킬 파일 저장하고 테스트하기
파일을 `.claude/skills/나의스킬.md`로 저장한 다음, Claude Code를 열고 `/나의스킬`을 입력해 보세요. 잘 동작하는지 확인하고, 결과물이 기대와 다르면 지시문을 수정해요. 스킬 개발은 이렇게 시도 → 확인 → 개선을 반복하는 과정이에요.
스킬 활용 수준 높이기
기본 사용법을 익혔다면 조금 더 고급 기능을 활용해 봐요.
스킬에 컨텍스트 전달하기
스킬을 호출할 때 추가 컨텍스트를 함께 전달할 수 있어요. `/code-review src/auth/login.js`처럼 파일 경로를 지정하거나, `/translate 다음 텍스트를 영어로: 안녕하세요`처럼 처리할 내용을 바로 이어 붙일 수 있어요. 스킬 파일에 인자 처리 방식을 명시해 두면 더욱 유연하게 활용할 수 있어요.
스킬 체이닝
여러 스킬을 연결해서 워크플로우를 만드는 것도 가능해요. 예를 들어 리서치 스킬로 정보를 수집한 뒤, 그 결과를 입력으로 작성 스킬에 전달하는 방식이에요. 이런 파이프라인을 잘 설계하면 복잡한 작업도 자동화할 수 있어요.
격리 모드 활용하기
스킬 파일에 `isolation: worktree`를 설정하면, 스킬이 실행될 때 별도의 Git 작업 공간(worktree)에서 동작해요. 파일을 변경하거나 실험적인 작업을 할 때 원본 코드를 건드리지 않아도 되는 안전망이 생겨요. 실험적인 작업이나 리팩터링 스킬에 특히 유용해요.
스킬 관리와 유지보수
스킬이 많아지면 정리와 관리가 중요해져요.
스킬 버전 관리
스킬 파일을 Git으로 관리하면 변경 이력을 추적할 수 있어요. “이 스킬이 왜 이렇게 됐지?”라는 의문이 생길 때 커밋 로그를 보면 맥락을 파악할 수 있어요. 팀 스킬이라면 PR 리뷰 과정을 통해 스킬 품질도 관리할 수 있어요.
스킬 이름 짓는 법
스킬 이름은 짧고 직관적으로 지어야 해요. 너무 길면 타이핑하기 번거롭고, 너무 줄이면 의미가 모호해져요. `cr`보다는 `code-review`, `tr`보다는 `translate`처럼 의미가 명확한 이름을 권장해요. 카테고리가 다른 스킬끼리는 접두사로 구분하는 것도 좋아요 (예: `dev-review`, `dev-test`, `write-blog`, `write-email`).
사용하지 않는 스킬 정리하기
스킬도 코드처럼 쌓이면 지저분해져요. 주기적으로 어떤 스킬이 실제로 쓰이고 있는지 점검해 보세요. 잘 안 쓰이는 스킬은 삭제하거나 다른 스킬에 통합하는 것이 좋아요. 스킬이 적을수록 자동완성 목록도 깔끔해지고 선택하기도 쉬워요.
자주 묻는 질문
스킬을 처음 쓸 때 자주 부딪히는 질문들을 모아봤어요.
스킬을 호출했는데 아무것도 안 나타나요
파일이 올바른 위치에 있는지 먼저 확인해요. `.claude/skills/` 디렉터리인지, 파일 확장자가 `.md`인지 체크해 보세요. frontmatter 형식이 맞는지도 확인이 필요해요. YAML은 들여쓰기 오류가 있으면 파싱이 안 돼요.
스킬이 너무 엉뚱한 결과를 냈어요
지시문이 모호하거나 충돌하는 경우에 이런 일이 자주 생겨요. 지시를 구체적으로 다듬고, 원하는 출력 예시를 직접 스킬 파일에 포함시켜 보세요. “이런 형식으로 출력해줘”와 함께 예시를 보여주면 훨씬 정확해져요.
스킬을 다른 사람과 공유하려면?
스킬 파일을 GitHub에 올리거나, 팀 저장소에 포함시키면 공유할 수 있어요. `.claude/` 디렉터리를 프로젝트 저장소에 커밋하면 팀원 모두가 같은 스킬을 쓸 수 있어요. 민감한 정보가 스킬에 포함돼 있다면 `.gitignore`로 제외하는 것을 잊지 마세요.
Claude Skills는 처음엔 낯설게 느껴질 수 있지만, 한번 익숙해지면 없이는 일하기 불편할 정도로 유용해요. 오늘 당장 하나의 작은 스킬부터 만들어 보는 것을 추천해요. 매일 반복하는 작업을 스킬로 만들어 두면, 그 시간이 쌓일수록 얼마나 큰 효율인지 실감하게 될 거예요.