문서를 SKILL.md로 바꾸기

변환기가 만드는 파일

스킬은 필수 파일 SKILL.md 하나가 든 폴더예요. 파일은 짧은 YAML 블록(프런트매터)으로 시작하고, 그 뒤에 Markdown으로 쓴 지침이 이어져요. 공개된 Agent Skills 형식은 이 블록에 두 항목을 요구해요.

• name: 1~64자의 영문 소문자, 숫자, 하이픈. 하이픈으로 시작하거나 끝날 수 없고, 하이픈 두 개를 이어 쓸 수 없어요. 폴더 이름과 같아야 해요.
• description: 스킬이 무엇을 하고 언제 쓰는지 적은 1~1,024자의 글.

변환기는 문서의 첫 제목으로 이름을 만들고, 첫 문장으로 설명의 초안을 쓰고, 글머리 기호를 정리하고, 문서에 제목이 없으면 제목을 붙여요. 두 항목 모두 고칠 수 있고, 입력하는 대로 파일이 바뀌어요. Anthropic은 규칙을 두 가지 더 둬요. 이름에 "anthropic"이나 "claude"를 넣을 수 없고, 두 항목 모두 XML 태그를 담을 수 없어요. 변환기는 둘 다 확인해요.

파일을 넣을 곳

• Claude(웹과 데스크톱): ‘사용자 정의’ 메뉴에서 스킬(Skills)로 가서 +를 누르고, 스킬 만들기(Create skill)에서 스킬 업로드(Upload a skill)를 고른 뒤 .zip 파일을 선택하세요. .zip 안에는 SKILL.md가 든 폴더가 있어서 Claude가 요구하는 형태 그대로예요. 코드 실행이 켜져 있어야 해요.
• Claude Code: 나만 쓰려면 ~/.claude/skills/에, 저장소를 클론하는 모두가 쓰게 하려면 저장소의 .claude/skills/에 압축을 푸세요.
• Codex, Cursor, OpenCode: 각자 정해진 위치에서 스킬 폴더를 읽어요. 위치는 동기화 가이드에 있어요.

직접 넣은 사본은 누군가 직접 업데이트해야 해요. AI Skill Pod가 그 일을 대신해요.

AI가 실제로 쓰게 되는 설명 쓰기

AI는 요청에 맞는 스킬을 찾을 때까지 모든 스킬의 이름과 설명만 봐요. 그래서 스킬이 열릴지는 설명이 정해요. 세 가지 습관이 도움이 돼요.

• 하는 일로 시작해요: “우리 고객지원 말투로 환불 답장 초안을 씁니다.”
• 이어서 언제 쓰는지 적어요: “고객이 환불, 반품, 지불 거절을 요청할 때 사용합니다.”
• 사람들이 실제로 입력하는 말을 넣어요: 제품 이름, 파일 형식, 팀에서 쓰는 용어.