클로드 스킬을 만들어 뒀는데 정작 알아서 불려 나오지 않는다면 어디부터 봐야 할까요. 대개 본문이 아니라 설명문 쪽 문제입니다. 클로드는 스킬 본문을 미리 읽지 않고 프론트매터의 description만 훑어 지금 상황에 맞는지 판단합니다.
자동 발동 조건과 설치 위치, 외부 스킬을 받아 쓸 때의 점검 순서를 나눠 정리했습니다.
목차
클로드 스킬은 설명문으로 호출 여부가 갈립니다
호출 판단의 근거는 SKILL.md 프론트매터의 description 필드입니다. 앤트로픽 공식 문서는 이 필드를 두고 클로드가 스킬을 언제 적용할지 결정하는 기준이라고 설명합니다. 본문은 실제로 실행될 때 비로소 읽힙니다.
이 구조에는 장점이 있습니다. 긴 참고 자료를 스킬에 넣어 둬도 쓰이기 전까지는 컨텍스트를 거의 잡아먹지 않습니다. CLAUDE.md에 절차를 길게 적어 두는 방식과 다른 부분입니다.
대신 설명문이 부실하면 존재 자체가 무시됩니다. 판단은 단어가 겹치는지가 아니라 의미가 맞는지로 이뤄집니다. 그래서 “문서 작업 도우미” 같은 분야 서술보다 사용자가 실제로 말할 문장을 적어야 자동 호출에 걸립니다.
목록에 실리는 description과 when_to_use는 합쳐서 1,536자에서 잘립니다. 핵심 용례를 앞쪽에 두라는 뜻입니다.
설치 위치가 적용 범위와 우선순위를 정합니다
클로드 스킬 설치 위치는 어느 폴더에 두느냐에 따라 쓰이는 범위를 바꿉니다. 개인 폴더에 두면 모든 프로젝트에서 불러 쓰고 프로젝트 폴더에 두면 저장소를 따라 이동합니다.
| 위치 | 경로 | 적용 범위 |
|---|---|---|
| 개인 | ~/.claude/skills/이름/ | 내 모든 프로젝트 |
| 프로젝트 | .claude/skills/이름/ | 해당 저장소 |
| 플러그인 | 플러그인 패키지 안 | 설치한 환경 |
이름이 겹치면 우선순위가 적용됩니다. 개인 스킬이 프로젝트 스킬보다 우선 적용되고 프로젝트 스킬이 플러그인 스킬보다 우선합니다. 같은 이름을 쓰면 기본 내장 스킬도 이렇게 교체됩니다.
프로젝트 스킬은 클로드를 띄운 폴더뿐 아니라 저장소 루트까지 거슬러 올라가며 읽힙니다. 하위 폴더에서 실행해도 상위에 정의한 스킬이 잡히는 이유입니다.
확실히 부르고 싶으면 이름을 직접 지정하세요
클로드 스킬의 자동 발동은 판단이라서 100%가 아닙니다. Andy Stapleton은 영상에서 클로드가 의도대로 스킬을 항상 집어 들지는 않는다고 지적하면서 확실한 방법을 권했습니다. 프롬프트 앞에 스킬 이름을 명시하거나 “이 작업에는 어떤 스킬을 써 달라”고 못 박는 방식입니다.
반대 방향도 있습니다. 손으로만 부르고 싶은 스킬이라면 프론트매터에 disable-model-invocation: true를 넣습니다. 클로드가 알아서 끌어다 쓰는 일이 막히고 슬래시 명령으로만 실행됩니다.
외부에서 받은 스킬은 실행 전에 열어 봐야 합니다
클로드 스킬은 절차를 담은 문서라서 남의 것을 가져다 쓰기 쉽습니다. 그만큼 검증 없이 실행하면 위험이 따라옵니다. 영상에서도 이 부분을 가장 길게 다룹니다.
Andy Stapleton은 외부 스킬이 데스크톱 환경을 통해 실제 작업 컴퓨터에 접근할 권한을 얻을 수 있다는 점을 짚었습니다. 출처가 확인되지 않은 스킬을 그대로 돌리지 말라는 이야기입니다. 깃허브에서 받을 때는 별이 많이 붙은 저장소를 고르라는 기준도 제시했습니다.
실행 전에 확인할 것은 단순합니다. 본문의 단계가 내 작업 목적과 맞는지 읽어 보고 어떤 도구 권한을 요구하는지 봅니다. 프론트매터의 allowed-tools는 해당 턴에서 확인 없이 쓸 도구를 미리 허용하는 항목이라 특히 눈여겨봐야 합니다.
슬래시 명령이 스킬로 통합됐습니다
앤트로픽은 기존 커스텀 슬래시 명령을 스킬로 통합했습니다. .claude/commands/deploy.md와 .claude/skills/deploy/SKILL.md는 똑같이 /deploy를 만들고 동작도 같습니다. 쓰던 파일을 옮기지 않아도 그대로 돌아갑니다.
스킬이 추가로 제공하는 점은 세 가지입니다. 보조 파일을 담을 폴더가 생기고 누가 호출할지 프론트매터로 정할 수 있으며 클로드가 상황에 맞을 때 알아서 불러옵니다.
만드는 과정을 자동화하고 싶다면 공식 마켓플레이스의 스킬 크리에이터를 설치하면 됩니다. 수동으로 한 번 해 본 작업을 두고 이걸 스킬로 만들어 달라고 지시하는 방식도 영상에서 소개됐습니다. 개념과 제작 기초는 클로드 코드 스킬 활용법에서 먼저 다뤘습니다.
자주 묻는 질문
/skills를 입력하면 현재 인식된 스킬이 나열됩니다. 새로 추가하거나 수정한 내용은 SKILL.md 본문에 한해 자동으로 반영됩니다. 플러그인에 포함된 훅이나 설정을 바꿨다면 /reload-plugins를 실행해야 적용됩니다.마무리
클로드 스킬이 안 걸린다면 본문을 다듬기보다 설명문을 먼저 손봐야 합니다. 분야를 적지 말고 사용자가 그 순간 실제로 하는 말을 적는 것이 핵심입니다. 위치는 쓰는 범위에 맞춰 개인과 프로젝트 중에서 고르고 이름 충돌이 생기면 우선순위를 떠올리면 됩니다.
다음으로 확인할 지점은 AI 코딩 도구 전반의 표준화 흐름입니다. 클로드 코드의 스킬은 여러 도구가 함께 쓰는 개방 규격을 따르므로 다른 에이전트로도 옮겨 쓸 수 있습니다. 규격 지원 범위가 어디까지 넓어지는지가 다음 관전 포인트입니다.
📺 출처: Andy Stapleton — “Forget Prompting: Claude Skills Do the Whole Workflow For You”
프론트매터 항목과 설치 경로는 클로드 코드 공식 스킬 문서에서 확인할 수 있습니다.