클로드 스킬을 슬래시 명령처럼 부르는 법

스킬은 필요한 순간 알아서 불려 나오지만, 내가 원할 때 바로 부르고 싶다면 user-invocable 을 쓰면 됩니다.

스킬이 알아서 나올 때와 안 나올 때

스킬은 description 에 언제 쓰는지 적어 두면 그 상황에서 클로드가 알아서 꺼냅니다. 그런데 항상 그게 맞지는 않습니다. 제가 만든 블로그 초안 스킬이 그랬습니다. description 에 '블로그 글을 쓸 때'라고 적어 두었는데, 정작 글을 쓰자고 하면 다른 스킬을 먼저 집어 들었습니다. description 이 모호하면 클로드도 헷갈립니다. 그럴 때는 스킬을 자동으로 불러내는 대신, 제가 직접 이름을 불러서 쓰는 게 낫습니다.

위 사진은 스킬 폴더에 SKILL.md 가 들어 있는 모습입니다. 이 파일 머리말에 한 줄만 추가하면 됩니다.

user-invocable 한 줄이면 됩니다

SKILL.md 머리말의 name 과 description 아래에 `user-invocable: true` 를 넣으면 됩니다. 이 한 줄이 있으면 대화창에서 `/스킬이름` 을 입력했을 때 그 스킬이 바로 실행됩니다. 저는 이걸 모르고 한동안 '스킬을 실행해 줘'라고 말로 시켰습니다. 그런데 말로 시키면 클로드가 또 다른 스킬을 집어 들거나, 그냥 대화로 처리해 버립니다. user-invocable 을 켜 두면 그런 일이 없습니다. 버전에 따라 화면이 다를 수 있지만, 이 글을 쓴 시점 기준으로는 이렇게 동작했습니다.

먼저 `.claude/skills/<이름>/` 폴더를 만듭니다. 그 안에 SKILL.md 파일을 만들고 머리말을 적습니다. name, description, user-invocable 을 넣습니다. 그다음 본문에 절차를 적습니다. 저는 처음에 이 순서를 몰라서 파일을 프로젝트 루트에 두고 헤맸습니다. 폴더 위치가 틀리면 클로드가 아예 못 찾습니다. 위치를 확인하고 나서 `/이름` 을 입력해 보면 됩니다. 이때 스킬 이름에 공백이나 특수문자가 있으면 안 됩니다. 저는 '블로그 초안'이라고 이름을 지었다가 `/블로그 초안` 이 안 먹어서 하이픈으로 바꿨습니다.

정리 카드 대신 실제 화면

아래 사진은 user-invocable 을 켠 스킬을 `/` 키로 불러낸 화면입니다. 목록에 스킬 이름이 보입니다.

스킬이 실행된 뒤에는 대화창에 '스킬을 불러왔습니다'라는 안내가 뜹니다. 이때부터는 그 스킬의 절차를 따라 일을 합니다. 저는 이 스킬로 블로그 초안을 쓰고, 퇴고하고, 마무리하는 전체 절차를 묶어 두었습니다. 이제 '블로그 초안'이라고 말하지 않아도 `/블로그-초안` 을 입력하면 바로 시작됩니다.

allowed-tools 와 함께 쓰면 더 안전합니다

user-invocable 을 켜면 내가 직접 부를 수 있지만, 그 스킬이 어떤 도구를 쓸 수 있는지도 정해 두는 게 좋습니다. `allowed-tools` 에 허용할 도구만 적으면, 그 스킬은 그 도구만 씁니다. 예를 들어 블로그 초안 스킬에는 파일 읽기와 쓰기만 허용하고, 인터넷 검색은 빼 두었습니다. 그러면 스킬이 실행되는 동안 엉뚱한 데 가지 않습니다. 이 두 줄은 함께 쓰일 때 빛을 냅니다. 둘 중 하나만 쓰면 절차는 편한데 통제가 안 되거나, 통제는 되는데 부르기가 불편합니다.

안 되는 것 같을 때 확인할 자리

user-invocable 을 넣었는데 `/이름` 이 안 나오면 세 가지를 확인합니다. 첫째, 파일이 `.claude/skills/<이름>/SKILL.md` 에 있는지. 둘째, 머리말에 `---` 가 제대로 닫혀 있는지. 셋째, 스킬 이름이 대문자나 공백을 쓰지 않았는지. 저는 머리말을 닫는 `---` 를 빼먹어서 한참을 헤맸습니다. 이때 클로드가 알려주는 오류 메시지가 정확해서, 그걸 따라 고치면 됩니다. 그래도 안 되면 클로드를 재시작하는 것도 방법입니다. 가끔은 파일을 읽지 못한 상태로 계속 있을 때가 있습니다.

슬래시 명령과 스킬의 차이

슬래시 명령은 `.claude/commands/*.md` 에 두고, 스킬은 `.claude/skills/*/SKILL.md` 에 둡니다. 둘 다 `/이름` 으로 부를 수 있지만, 스킬은 description 으로 자동 호출이 되고 allowed-tools 같은 설정이 가능합니다. 그래서 저는 반복 작업을 하나의 절차로 묶을 때는 스킬을, 단순한 프롬프트를 실행할 때는 슬래시 명령을 씁니다. 처음부터 둘 다 만들 필요는 없습니다. 먼저 스킬 하나를 만들어 보고, 그 구조가 익숙해지면 슬래시 명령도 손대 보는 걸 권합니다.

#클로드스킬 #클로드코드 #user -invocable #슬래시명령 #SKILL .md #AI마케팅 #클로드스킬만들기 #업무자동화 #블로그운영 #전주마케팅아비컴퍼니 드림