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

기준: Claude Code v2.1.154 (2026.05)