클로드코드 /reload-skills: 고친 스킬을 재시작 없이 바로 적용

스킬(Claude Code에게 특정 작업을 하는 방법을 미리 가르쳐 둔 설명서 묶음)을 한 줄 고쳤는데 반영이 안 돼서, 매번 클로드코드를 껐다 켜고 있진 않나요. /reload-skills는 재시작 없이 스킬만 다시 읽어줍니다. 스킬을 직접 만들어 보는 입문자에게는 시행착오를 빠르게 돌릴 수 있는 필수 단축키예요.

정의 (뭐냐면)

/reload-skills는 현재 세션을 유지한 채로, 새로 추가했거나 수정한 스킬을 다시 스캔(훑어 읽기)해서 적용하는 명령어입니다.

클로드코드는 시작할 때 사용 가능한 스킬 목록을 한 번 읽어둡니다. 그래서 도중에 스킬 파일을 고쳐도 그 변경을 모르고 예전 내용을 그대로 써요. 이 명령어를 치면 스킬 폴더를 다시 훑어서, 방금 바꾼 설명이나 새로 만든 스킬을 곧바로 인식하게 됩니다.

어떻게 쓰나 (난이도별)

기초 — 스킬 새로고침

스킬 파일을 수정한 뒤 입력창에 이렇게 칩니다.

/reload-skills

이 한 줄로 클로드코드가 스킬을 다시 스캔합니다. 새로 만든 스킬이라면 이제 목록에 잡히고, 고친 스킬이라면 바뀐 내용대로 동작해요.

응용 — 만들고-테스트 반복에 끼워 넣기

스킬을 개발하는 중이라면 이런 흐름으로 씁니다.

(스킬 파일 수정·저장)
/reload-skills
(그 스킬이 필요한 작업을 요청해서 동작 확인)

설명 문구나 트리거 조건을 조금 바꾼 뒤 reload하고, 실제로 스킬이 의도대로 발동하는지 바로 확인할 수 있어요. 기대와 다르면 또 고쳐서 다시 reload하면 됩니다.

흔한 함정

• 고쳤는데 그대로라면 파일 저장을 안 했을 가능성이 큽니다. 저장부터 확인하세요.
• 스킬이 인식되려면 정해진 폴더 위치와 파일 형식을 지켜야 합니다. reload해도 목록에 안 나타나면, 스킬 파일이 올바른 위치에 있는지 점검하세요.
• 플러그인용 /reload-plugins와 다릅니다. 스킬을 고쳤으면 /reload-skills를 써야 해요.

실전 사례

블로그 작성용 스킬처럼 글쓰기 규칙을 담은 스킬을 다듬을 때 잘 맞습니다. 문체 규칙 한 줄을 고치고 /reload-skills로 즉시 반영한 뒤, 실제로 글을 시켜 보며 결과가 어떻게 달라지는지 빠르게 비교할 수 있어요.

이렇게 더 씁니다

여러 스킬을 한꺼번에 손보는 날에도 좋습니다. 파일 몇 개를 연달아 수정한 다음 /reload-skills 한 번이면 모두 다시 읽혀서, 변경 사항을 묶어서 확인할 수 있어요. "스킬을 만지면 reload"를 습관으로 들이면 개발 속도가 눈에 띄게 빨라집니다.

정리

/reload-skills는 새로 추가하거나 수정한 스킬을 재시작 없이 다시 읽는 명령어입니다. 만들고-테스트하는 반복이 빨라져 스킬 개발의 시행착오 비용을 크게 줄여줘요. 반영이 안 되면 저장 여부와 파일 위치부터 확인하세요.

FAQ · 자주 묻는 질문

/reload-skills를 치면 하던 작업이 날아가지 않나요?

아니요, 현재 세션을 유지한 채로 스킬만 다시 스캔하는 명령이라 하던 작업은 그대로 이어집니다. 클로드코드를 껐다 켜는 재시작과 달리 대화 흐름이 끊기지 않아서, 스킬을 고칠 때마다 부담 없이 쳐도 되는 안전한 새로고침이에요.

스킬을 고친 뒤 언제 /reload-skills를 치면 되나요?

스킬 파일을 수정하고 저장한 직후에 바로 치면 됩니다. 클로드코드는 시작할 때 스킬 목록을 한 번만 읽어두기 때문에, 도중에 파일을 고쳐도 예전 내용을 그대로 써요. "스킬을 만지면 reload"를 습관으로 들이면 개발 속도가 눈에 띄게 빨라집니다.

reload했는데 변경이 반영되지 않아요. 어떻게 하나요?

먼저 파일 저장을 안 했을 가능성이 크니 저장부터 확인하세요. 목록에 아예 안 나타나면 스킬 파일이 정해진 폴더 위치와 파일 형식을 지키고 있는지 점검하면 됩니다. 그리고 플러그인을 고친 거라면 /reload-skills가 아니라 /reload-plugins를 써야 해요.

기준: Claude Code v2.1.154 (2026.05)