클로드 코드 나만의 스킬 5분 만에 만들기

1단계스킬 폴더 만들기

1. 홈 폴더 아래 개인 스킬 폴더를 만듭니다. 여기 두면 내 모든 프로젝트에서 쓸 수 있어요.
   복사

   mkdir -p ~/.claude/skills/summarize-changes

• 프로젝트에서만 쓰고 팀과 나누려면 프로젝트 안 .claude/skills/<스킬이름>/SKILL.md 에 두고 깃에 올리면 돼요.
• 폴더 이름이 곧 /명령어 이름이 됩니다.

2단계SKILL.md 쓰기

맨 위 --- 사이는 '언제 쓰는지' 설명, 그 아래는 클로드가 따를 지시예요. 아래는 공식 문서 예시로, 커밋 전 바뀐 내용을 요약하고 위험한 부분을 짚어 줍니다.

1. ~/.claude/skills/summarize-changes/SKILL.md 에 저장합니다.
   복사

   ---
   description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
   ---
   
   ## Current changes
   
   !`git diff HEAD`
   
   ## Instructions
   
   Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.

• !`명령` 줄은 클로드가 보기 전에 명령을 먼저 실행해 결과로 바꿔 넣어요. 그래서 짐작이 아니라 실제 변경 내용을 보고 답해요.
• description에는 사람들이 실제로 말할 법한 단어를 넣으세요. 클로드는 이 설명을 보고 스킬을 꺼낼지 정해요.

3단계써 보기

1. 깃 프로젝트에서 파일을 조금 고친 뒤 claude를 켜고, 설명과 맞는 말을 하면 클로드가 알아서 스킬을 꺼내요.
   복사

   What did I change?

2. 직접 부를 수도 있어요.
   복사

   /summarize-changes

4단계내가 부를 때만, 값 넘겨서 쓰기

배포·전송처럼 결과가 남는 일은 클로드가 멋대로 돌리면 곤란하죠. 이럴 땐 설정 한 줄을 더해요.

1. disable-model-invocation: true 를 넣으면 나만 /이름으로 부를 수 있어요. $ARGUMENTS 자리에는 명령 뒤에 친 글이 들어가요.
   복사

   ---
   name: fix-issue
   description: Fix a GitHub issue
   disable-model-invocation: true
   ---
   
   Fix GitHub issue $ARGUMENTS following our coding standards.
   
   1. Read the issue description
   2. Understand the requirements
   3. Implement the fix
   4. Write tests
   5. Create a commit

2. /fix-issue 123 이라고 치면 클로드는 'Fix GitHub issue 123 following…'을 받아요.

• 반대로 user-invocable: false 를 넣으면 클로드만 꺼내 쓰는 배경지식 스킬이 돼요.

스킬이 안 불릴 때