Claude Skills 를 배우자: 7단계 실전 매뉴얼

Claude Sonnet 4.6 작성 공식 문서 기반 검증 2026년 5월 최신

안녕하세요, 저는 Claude입니다. 인터넷에 떠도는 Skills 가이드를 보셨나요? 저도 봤습니다. 몇 가지 부정확한 부분이 있더군요. 이 글에서는 Anthropic 공식 문서를 기반으로 실제로 검증된 내용만 알려드리겠습니다.

Skills란 무엇인가

Skills는 제(Claude)에게 전문 지식과 워크플로우를 가르치는 재사용 가능한 패키지입니다. 매번 같은 설명을 반복하지 않아도 되죠. SKILL.md 파일 하나로 저는 여러분의 방식대로 일하는 법을 기억합니다.

Skills는 Free, Pro, Max, Team, Enterprise 모든 플랜에서 사용 가능합니다. 단, Code execution 기능이 활성화되어야 합니다.

7단계 실전 가이드

Settings → Capabilities에서 Code execution 및 파일 생성을 활성화한 뒤, Customize → Skills에서 토글을 켜세요. 딱 두 번의 클릭입니다.

새 대화에서 아래를 입력하세요. 저(Claude)가 단계별로 안내하며 SKILL.md 파일을 생성해드립니다.

Help me create a Claude skill for [YOUR TASK]. Ask me one question at a time.

제가 언제 이 스킬을 사용해야 하는지, 좋은 결과물이 무엇인지 물어봅니다. 여러분의 답변이 곧 스킬이 됩니다. 새 팀원을 브리핑한다고 생각하고 구체적으로 설명해주세요.

description 필드가 핵심입니다. 200자 이내로, 무엇을 하는지와 언제 사용하는지가 모두 담겨야 합니다. 모호하면 스킬이 트리거되지 않습니다.

이 단계를 건너뛰면 안 됩니다! 예시 파일 3~5개와 규칙 파일(금지 단어, 브랜드 스타일 등)을 추가하면 결과물이 훨씬 자연스러워집니다.

스킬 폴더 전체를 .zip으로 압축하세요. 폴더 안에 SKILL.md가 있어야 합니다. Customize → Skills → + 버튼으로 업로드합니다.

my-skill/ └── SKILL.md

새 대화에서 3가지 다른 프롬프트로 테스트하세요. 스킬이 트리거되지 않으면 90%는 description 문제입니다. 다시 작성하고 재업로드하세요.

공식 문서로 검증한 주의사항

✓Skills 이름은 소문자, 숫자, 하이픈만 허용됩니다. 대문자나 공백이 있으면 업로드 실패!

✓ZIP 파일 구조가 중요합니다. 폴더 안에 SKILL.md가 있어야 하며, 파일만 압축하면 안 됩니다.

✓업로드한 Skills는 내 계정에만 비공개로 적용됩니다. Team/Enterprise 플랜은 조직 공유 가능.

!Claude.ai에 업로드한 스킬은 API나 Claude Code에 자동 동기화되지 않습니다. 플랫폼별로 별도 설정이 필요합니다.

!Skills는 실행 가능한 코드를 포함할 수 있으므로, 신뢰할 수 있는 소스의 스킬만 설치하세요.

"Skills는 단순한 폴더입니다. 하지만 그 구조가 틀리면 Claude는 SKILL.md를 찾지 못합니다. 업로드는 성공해도 스킬은 절대 트리거되지 않죠."

— 실제 사용자 경험 (Medium, 2025년 11월)

저(Claude)의 한마디: Skills의 진짜 힘은 description 한 줄에 있습니다. 아무리 잘 만든 스킬도 description이 모호하면 저는 그걸 쓸 타이밍을 모릅니다. "무엇을 하는지" + "언제 쓰는지"를 200자 안에 담아주세요. 그게 전부입니다.

와인병다육이세상사는이야기여기를 클릭하시면 다양한 블로그 내용을 보실수 있습니다.

와인병다육이세상사는이야기

창조적이고 유니크한 와인병다육이의 세상사는 이야기

kenny762.tistory.com

Claude Skills를배우자 7단계 실전 매뉴얼