[Claude Code] Skills

/context 명령을 통해 확인할 수 있는 정보들 중 Skills라는 것이 있는데 본 포스팅에서는 Skills에 대해 알아볼 것이다.

 

1. Skills란?

커스텀 명령어와 유사한 개념이지만, 다음과 같은 차이점이 있다.

- 사용자가 직접 실행하지 않아도 클로드 코드가 요청의 성격을 파악해서 자동으로 적합한 스킬을 불러와 실행한다.

- .claude/skills/[스킬명]/ 디렉토리에 SKILL.md 파일로 설정

- SKILL.md의 프론트매터에 name, description가 있어야 한다. ---로 감싸인 메타데이터 블록을 프론트매터라고 한다.

 

스킬이 나온지 얼마 안돼서 그런지 모르겠지만..

필자가 '코드를 자동으로 리뷰하는 스킬을 만들어 줘' 라고 요청했을 때, 클로드 코드가 한 번에 제대로된 형식으로 만들어주지 않았다. 다음과 같은 실수들이 있었다.

• 스킬을 만들어달라고 했는데 .claude/commands/ 디렉토리에 생성
• .claude/skills/[스킬명].md 으로 생성
• SKILL.md의 프론트매터에 name, description가 없음

이 셋을 모두 어기면 스킬이 정상적으로 등록되지 않는다. 물론 스킬 목록에도 뜨지도 않는다.

그래서 위와 같은 룰을 어느정도 알려줘야할 수도 있다.

 

어쨌든 정상적으로 스킬이 만들어졌다면, 해당 스킬이 스킬 목록(/skills)에 잘 보일 것이다.

 

전체 코드를 리뷰해달라고 하니 'code-review' 라는 스킬을 사용할 것인지 물어보는 모습이다. 

 

 

 

2. 다른 사람이 만들어 놓은 스킬 사용하기

스킬 검색 사이트들 중 하나를 가져와봤다. 여기서 다른 사람들이 만들어 놓은 스킬을 카테고리, 작성자, 인기도별로 확인할 수도 있다.

https://skillsmp.com/ko/search

Agent Skills 검색 - 카테고리 및 작성자별 필터 | SkillsMP

 

1) 스킬 검색

code review라고 검색해보니 인기도순으로 정렬이 되었다.

 

가장 별이 많은 스킬로 들어가보니, SKILL.md 파일의 내용과 스킬 추가 방법도 잘 안내가 되어있다.

 

 

2) PowerShell 실행 정책 변경 (PowerShell의 경우에만)

터미널에 설치 명령어를 입력하면 되는데, PowerShell을 사용한다면 아래와 같은 오류가 발생하는 경우가 있다.

 

스크립트 실행 권한이 제한되어 있는 상태라 그럴 확률이 높다. 일단 터미널을 관리자 권한으로 실행 후

 

get-ExecutionPolicy로 실행 정책을 조회해보니 역시다 제한(Restricted) 상태다.

Set-ExecutionPolicy RemoteSigned를 통해 실행 정책을 원격 허용 상태로 변경해주자.

 

 

3) 스킬 설치

이제 정말로 스킬을 설치할 준비가 된 것 같다.

안내에 따르면 아래 명령어로 설치를 하라고 했는데

npx skills add Shubhamsaboo/awesome-llm-apps

 

본인은 뒤에 --skill code-reviewer 옵션을 주었다. 위 명령어대로 하면 스킬셋 레포지토리에 진입하는데, 이후에 code-reviewer 스킬을 직접 선택해야 한다.

npx skills add Shubhamsaboo/awesome-llm-apps --skill code-reviewer

 

설치 완료된 화면이다.