저는 두 가지 다른 Skills 설정이 혼동되는 스레드를 몇 개 본 적이 있습니다. 둘 다 Skills라고 불리지만, 설치 경로는 같지 않습니다.

claude.ai를 사용하는 경우 (채팅 / 데스크톱) - Skill 폴더를 압축(zip)하여, 압축 파일 안에 SKILL.md가 들어있는 하나의 폴더만 있도록 하세요. 즉, 압축 파일의 루트에 개별 파일로 두지 마세요.

• 먼저 코드 실행 및 파일 생성 기능을 켜야 합니다 (Free/Pro/Max: 설정 → 기능; Team/Enterprise: org Skills 설정).
• 그런 다음 맞춤 설정(Customize) → Skills → + → zip 파일을 업로드하고, 해당 Skill을 활성화합니다.

Claude Code를 사용하는 경우 (터미널 / IDE) - 압축 파일 업로드는 하지 않습니다. 디스크에 폴더를 만드세요:

• 개인용: ~/.claude/skills/<이름>/SKILL.md
• 프로젝트용: .claude/skills/<이름>/SKILL.md (팀과 공유해야 하는 경우 커밋하세요)
• /skill-name으로 호출하거나, Claude가 설명에서 이를 인식하도록 두세요.

CLAUDE.md의 일부 내용이 절차(procedure)로 바뀌어 계속 붙여넣는다면, 그것은 보통 Skill 영역입니다. CLAUDE.md는 일반적인 사실 정보(standing facts)를 위해 보관하세요.

쉽게 혼동되는 부분 claude.ai zip 업로드에 대한 조언은 Claude Code의