Skills 관리
만든 Skill을 확인하고, 수정하고, 삭제하는 방법을 정리합니다.
1. 설치된 Skills 확인
가장 간단한 방법은 /skills 명령입니다. 설치된 Skill 목록과 프로젝트/사용자 구분을 볼 수 있습니다.
/skills
클로드에게 직접 물어볼 수도 있습니다.
지금 사용 가능한 Skills가 뭐가 있어?
파일 시스템에서 직접 확인하려면 다음 경로를 봅니다.
# 사용자(전역) Skills
ls ~/.claude/skills/
# 프로젝트 Skills
ls .claude/skills/
# 특정 Skill 내용 확인
cat ~/.claude/skills/my-skill/SKILL.md
2. Skills 수정
SKILL.md 파일을 직접 열어 내용을 고치면 됩니다. 지침이 잘 지켜지지 않거나, 작업 방식을 바꾸고 싶을 때 Instructions와 Examples를 다듬으세요.
SKILL.md를 수정한 뒤에는 반드시 클로드 코드를 재시작해야 변경 사항이 반영됩니다. "분명히 고쳤는데 그대로네?" 싶을 때는 대부분 재시작을 안 한 경우입니다.
3. Skills 삭제
Skill 폴더를 삭제하면 됩니다.
# 사용자 Skill 삭제
rm -rf ~/.claude/skills/my-skill
# 프로젝트 Skill 삭제
rm -rf .claude/skills/my-skill
플러그인으로 설치한 Skill은 /plugin 명령으로 플러그인 단위로 제거할 수 있습니다.
4. Skill을 잘 쓰기 위한 체크리스트
Skill이 의도대로 동작하지 않을 때는 다음을 점검하세요.
| 점검 항목 | 확인 내용 |
|---|---|
| 위치 | .claude/skills/이름/SKILL.md 경로가 정확한가 |
| 파일명 | 파일명이 정확히 SKILL.md인가(대소문자 포함) |
| name | 소문자·숫자·하이픈만 썼는가, 예약어를 피했는가 |
| description | "무엇을·언제"가 명확한가 (자동 인식의 핵심) |
| 재시작 | 만들거나 고친 뒤 재시작했는가 |
description이 가장 중요합니다.
Skill이 "있는데도 안 불려오는" 가장 흔한 원인은 description이 모호하기 때문입니다. 클로드는 description만 보고 이 Skill을 쓸지 판단합니다. 어떤 작업·어떤 키워드일 때 써야 하는지를 구체적으로 적어주세요.
5. 정리
Skills를 한 문장으로 요약하면 이렇습니다.
"특정 작업을, 항상 정해진 방식으로, 클로드가 알아서 처리하게 만드는 매뉴얼."
- SKILL.md 하나로 시작 (
name+description+ 본문) - 올바른 위치에 두면 자동 등록 (재시작 필요)
- 마켓플레이스·skill-creator로 더 빠르게 확보
- 잘 안 되면 description부터 점검
다음 챕터에서는 별도의 컨텍스트를 가진 전문 일꾼, Subagents를 다룹니다.