.skill 파일을 열어 안에 든 스킬 보기

.skill 파일이란

2026년 11월 6일에 Anthropic의 파일과 문서로 확인한 내용이에요.

• 이름만 다른 ZIP이에요. skill-creator의 패키징 스크립트는 스킬 폴더를 폴더째 ZIP으로 묶어 폴더 이름으로 저장해요. 예를 들면 refund-reply.skill이에요. 맨 위에 폴더가 있고, 그 안에 refund-reply/SKILL.md와 필요하면 scripts/, references/, assets/가 있어요.
• 저장하기 전에 검사해요. SKILL.md의 이름과 설명이 올바르고 프런트매터에 허용된 항목만 있을 때만 저장해요. __pycache__, node_modules, .DS_Store, .pyc 파일과 맨 위의 evals 폴더는 넣지 않아요.
• Claude가 건네줘요. skill-creator의 안내에 따르면 claude.ai에서는 Claude가 이 스크립트를 실행하고, 사용자가 만들어진 .skill 파일을 내려받아요.
• Claude 도움말에서는 ZIP이에요. 업로드 단계는 맨 위에 스킬 폴더가 있는 ZIP을 요구하고 .skill 확장자는 언급하지 않아요. .skill 파일은 원래 그 구조라서, 이름을 .zip으로 바꾸면 요구하는 ZIP 그대로예요.
• Claude Code에는 압축을 풀어서 둬요. Claude Code는 폴더에서 스킬을 읽어요. 나만 쓸 때는 ~/.claude/skills/<이름>/SKILL.md, 프로젝트에서는 .claude/skills/<이름>/SKILL.md예요.

도구 없이 .skill 파일을 여는 방법

1. Windows: my-skill.skill의 이름을 my-skill.zip으로 바꾸고, 마우스 오른쪽 단추를 눌러 ‘모두 추출’을 고른 뒤 SKILL.md를 메모장으로 열어요.
2. Mac: 이름을 my-skill.zip으로 바꾸고 확장자 변경을 확인한 뒤 이중 클릭해요. 옆에 폴더가 생기면 SKILL.md를 텍스트 편집기로 열어요.
3. 터미널(Mac, Linux): unzip my-skill.skill -d skill-files는 이름을 바꾸지 않아도 풀려요.
4. Claude에 넣기: claude.ai나 데스크톱 앱에서 Customize > Skills를 열고 +, Create skill > Upload a skill을 눌러 파일을 골라요. Claude 도움말은 ZIP을 요구하고 .skill은 언급하지 않으니, 선택이 안 되면 먼저 .zip으로 이름을 바꿔요. 안은 원래 ZIP이에요. 코드 실행을 켜 두어야 해요.
5. Claude Code에 넣기: ~/.claude/skills/에 압축을 풀어 ~/.claude/skills/my-skill/SKILL.md가 되게 해요.

확인하는 항목

모두 Anthropic의 페이지나 Agent Skills 사양에 적힌 규칙이에요. 업로드 전에 고칠 점을 먼저, 알아 두면 좋은 메모를 그다음에 보여 줘요.

• 이름: 있어야 하고, 64자까지, 영문 소문자, 숫자, 하이픈 하나씩만 쓰고 양 끝은 하이픈이 아니어야 해요. ‘anthropic’, ‘claude’는 넣을 수 없고, 폴더 이름과 같아야 해요.
• 설명: 있어야 하고, 1,024자까지, XML 태그나 꺾쇠괄호가 없어야 해요. 200자를 넘으면 메모를 보여 줘요. Claude 도움말의 사용자 지정 스킬 문서가 claude.ai의 한도를 200자로 적고 있어서예요.
• 프런트매터 항목: name, description, license, compatibility, metadata, allowed-tools만 써요. Claude Code 문서에 따르면 claude.ai 업로드, Skills API, package_skill.py는 다른 항목이 있으면 오류로 멈춰요. Claude 도움말의 사용자 지정 스킬 문서는 선택 항목으로 dependencies도 적고 있어서, 이 항목은 메모로만 알려 줘요.
• 구조와 크기: SKILL.md는 압축 파일 맨 위의 폴더 하나 안에 있어야 해요. SKILL.md가 500줄을 넘거나 풀었을 때 30 MB(Skills API의 한도)를 넘으면 메모를 보여 줘요.

‘저장하고 팀과 공유하기’를 누르면

1. SKILL.md 텍스트만 보내요. 받는 곳은 AI Skill Pod예요. .skill 안의 스크립트, 참고 자료 같은 파일은 내 기기에 남아요. 포드에는 스킬의 이름, 설명, 지시가 남고, 프런트매터의 다른 항목(license, compatibility, metadata, allowed-tools)은 남지 않아요. 다른 파일에서 AI에게 필요한 내용은 저장한 뒤 앱에서 스킬에 덧붙이세요.
2. 텍스트는 24시간 기다려요. 그동안 이메일로 가입하거나 로그인해요. 아직 어느 포드에도 들어가지 않았어요.
3. 확인하고 저장해요. 이름, 설명, 첫 몇 줄이 보이고 ‘포드에 저장’을 눌러야 포드에 들어가요. 새 포드는 14일 동안 무료이고 카드 등록은 없어요.
4. AI를 연결하고 팀을 초대해요. 링크 하나로 Claude, ChatGPT, Cursor를 연결해 스킬을 한 번 써 보고, 팀에 초대 링크를 보내요. 개인 이메일도 돼요.

Free 플랜은 스킬 10개, 멤버 3명까지예요.

자주 묻는 질문

.skill 파일이 뭔가요?

Claude 스킬을 ZIP으로 묶은 파일이에요. Anthropic의 skill-creator가 만들고, 안에는 스킬 폴더가 있어요. 이름, 설명, 지시를 적은 SKILL.md와 스킬이 쓰는 스크립트, 참고 자료, 에셋이 들어 있어요.

.skill 파일은 어떻게 여나요?

이 페이지의 뷰어에 놓으면 브라우저 안에서 읽을 수 있어요. 도구 없이 열려면 확장자를 .skill에서 .zip으로 바꿔 압축을 풀고(Windows는 ‘모두 추출’, Mac은 이중 클릭), SKILL.md를 아무 텍스트 편집기로 여세요.

.skill 파일을 SKILL.md로 바꾸려면요?

SKILL.md는 이미 안에 들어 있어요. 여기서 열고 ‘SKILL.md 내려받기’를 누르거나, 압축을 풀어 폴더에서 SKILL.md를 꺼내세요.

.skill 파일을 Claude에 넣으려면요?

claude.ai나 데스크톱 앱에서 Customize > Skills를 열고 +, Create skill > Upload a skill을 차례로 눌러 파일을 고르세요. Claude 도움말은 이 업로드를 ZIP으로 설명하니, 선택이 안 되면 .zip으로 이름을 바꾸세요. 코드 실행을 켜 두어야 해요. Claude Code라면 ~/.claude/skills/에 압축을 풀어요.

여기서 열면 파일이 업로드되나요?

아니요. 브라우저가 읽기만 하고 페이지는 아무것도 보내지 않아요. ‘저장하고 팀과 공유하기’를 누를 때만 SKILL.md 텍스트를 AI Skill Pod로 보내요.

.skill 파일을 팀과 공유하려면요?

Pro, Max 같은 개인 플랜에서는 모두가 각자 사본을 올리고 고칠 때마다 다시 올려야 해요. Team과 Enterprise에서는 같은 Claude 조직의 동료에게 읽기 전용으로 공유하고 소유자가 모두에게 스킬을 배포할 수 있지만, ChatGPT나 Cursor, 자기 계정으로 일하는 외주 파트너에게는 닿지 않아요. AI Skill Pod에 두면 스킬은 포드 하나에 있고, 초대 링크로 들어온 팀원이 자기 Claude, ChatGPT(Pro, Business, Enterprise), Cursor에서 바로 써요.