스킬이 안 불릴 때: 파일 위치부터 차례로 확인해요
스킬이 안 된다는 말 안에는 서로 다른 문제가 있어요. 파일을 찾지 못한 것인지, 찾았지만 선택하지 않은 것인지, 실행하다 막힌 것인지부터 나눠 보세요. Claude Code에서 확인할 순서를 따라가며 현재 위치, 파일 이름, 호출 설정, 필요한 도구를 살펴보면 재설치를 반복할 일을 줄일 수 있어요.
어느 단계에서 멈췄나요?
스킬 목록에 이름이 없다면 발견 경로나 설정을 먼저 봐요. 이름을 직접 부르면 되는데 일반 요청에서는 안 되면 description과 호출 설정을 살펴봐요. 스킬을 읽었다는 표시 뒤에 오류가 나면 필요한 파일이나 도구를 확인해요.
작업 결과가 틀린 것은 또 다른 문제예요. 호출은 됐지만 정리 기준을 지키지 못했다면 본문 지침과 예시를 고쳐야 해요.
파일 위치는 어떻게 확인하나요?
Claude Code의 프로젝트 스킬은 .claude/skills/스킬이름/SKILL.md 형태로 두어요. 지금 열어 둔 프로젝트가 그 파일을 둔 폴더와 같은지 확인해 주세요. 내려받은 ZIP 안에 폴더가 한 겹 더 들어가 있지 않은지도 살펴봐요.
파일 이름이 SKILL.md.txt로 저장되었거나, SKILL.md를 폴더 이름으로 만든 경우도 있어요. 파일 탐색기에서 확장자를 보이게 한 뒤 실제 이름을 확인해 주세요.
직접 부를 수 있는데 자동으로는 안 되나요?
먼저 description이 지금 요청하는 일을 설명하는지 읽어 보세요. ‘보고서 작성’ 스킬에 ‘이 표 이상한 곳 찾아 줘’라고 요청했다면 작업 종류가 맞지 않을 수 있어요. 자주 사용하는 표현과 구체적인 대상을 설명에 넣어 보세요.
disable-model-invocation: true가 있으면 Claude가 스스로 고르는 것을 막아요. 사용자가 직접 호출하도록 의도한 스킬인지 확인하고, 제작자가 정한 이유를 이해한 뒤 변경해 주세요.
스킬은 읽었는데 중간에 실패하나요?
오류에 나온 파일 경로를 실제로 열 수 있는지 확인해요. 다른 컴퓨터의 절대 경로가 적혀 있거나 참조 파일을 함께 복사하지 않았다면 그 단계에서 멈출 수 있어요. 실행 프로그램이 필요한 스킬이라면 프로그램 설치 여부도 확인해야 해요.
도구 접근이 거절된 경우에는 어떤 권한이 필요한지 살펴보세요. 모든 권한을 한꺼번에 여는 방식보다, 요청한 작업에 필요한 접근인지 확인하는 편이 원인을 파악하기 좋아요.
도움을 요청할 때 무엇을 보내면 되나요?
아래 항목을 채워서 전달해 보세요. 파일 본문에 비밀번호나 개인정보가 있으면 공유 전에 지워 주세요.
도움 요청 예시: ‘Claude Code에서 meeting-note 스킬을 쓰고 있어요. 저장 경로는 프로젝트/.claude/skills/meeting-note/SKILL.md예요. 직접 호출하면 ○○이고 일반 요청에서는 ○○예요. 사용 버전은 ○○, 오류 원문은 아래와 같아요. 파일 발견, 자동 선택, 실행 중 어느 단계의 문제인지 확인해 주세요.’
‘안 돼요’에 화면 전체를 붙이는 것보다, 기대한 결과와 실제 결과를 한 줄씩 적으면 확인할 범위가 작아져요.
자주 묻는 질문
Q. 파일을 고쳤는데 같은 답이 나와요. A. 기존 대화의 지침이 영향을 줄 수 있어요. 새 대화에서 스킬을 다시 호출하고 수정한 파일을 사용하는지 확인해 보세요.
Q. 플러그인으로 설치한 스킬은 어디부터 보나요? A. /plugin의 Installed와 Errors에서 활성 상태와 로딩 오류를 먼저 확인해 주세요.