"Agent Skill(에이전트 스킬)" 또는 그냥 "스킬(Skill)"이라는 말을 들어보셨나요? 어렵게 들리지만, 스킬은 한마디로 "Claude에게 특정 작업을 잘하는 방법을 적어둔 폴더"입니다. 마치 요리 레시피 카드처럼요. 이 글은 스킬이 무엇이고 어떻게 작동하는지를 개발 지식 없이도 이해할 수 있게 설명합니다.
스킬이 뭐예요? (한 문장 정의)
스킬은 지시·스크립트·자료가 들어 있는 하나의 폴더입니다. 그 폴더 안에는 SKILL.md라는 파일(필수)이 있고, 거기에 "이 작업은 이렇게 해라"라는 설명이 담겨 있습니다. Claude는 여러분의 요청이 그 스킬과 맞으면, 폴더를 열어 설명을 읽고 그 방식대로 더 잘 처리합니다.
쉽게 비유하면, 평소의 Claude가 "요리를 할 줄 아는 사람"이라면, 스킬은 "우리 집 김치찌개는 이렇게 끓인다"는 레시피 카드입니다. 그 카드를 건네주면 매번 같은 방식으로, 더 정확하게 만들어 줍니다.
폴더 안에는 뭐가 들어 있나요?
스킬 폴더의 핵심은 SKILL.md 한 파일입니다. 그 안에는 보통 이런 게 들어갑니다.
- name — 스킬의 이름.
- description — 이 스킬이 무슨 일을, 언제 쓰는지를 한두 줄로 설명. 가장 중요한 부분입니다. Claude가 이 설명을 보고 "지금 이 스킬을 써야겠다"를 판단하기 때문입니다.
- 본문(지시) — Claude가 실제로 따라 할 구체적인 방법.
그 외에 선택적으로 scripts/(자동 실행할 코드), references/(참고 문서), assets/(템플릿·이미지 등) 폴더가 함께 들어갈 수 있습니다. 하지만 SKILL.md 하나만 있어도 스킬이 됩니다.
어떻게 작동하나요? — '필요할 때만 펼친다'
스킬의 똑똑한 점은 평소엔 이름과 설명만 가볍게 들고 있다가, 작업이 맞을 때 전체 내용을 읽어들인다는 것입니다. 이를 전문용어로 "점진적 공개(progressive disclosure)"라고 합니다. 덕분에 스킬을 여러 개 갖고 있어도 평소엔 자리를 거의 차지하지 않습니다.
흐름을 정리하면: ① 평소엔 스킬 이름·설명만 들고 있다가 → ② 여러분 요청이 어떤 스킬의 설명과 맞으면 그 SKILL.md 전체를 읽고 → ③ 적힌 지시대로 작업을 수행합니다(필요하면 폴더 안의 스크립트·자료도 그때 불러옵니다).
두 종류의 스킬: 사전 제공 vs 커스텀
- 사전 제공 스킬 — Anthropic이 미리 만들어 둔 것으로, PowerPoint·Excel·Word·PDF 문서 작업용 스킬이 대표적입니다. 관련 요청을 하면 Claude가 알아서 사용하므로 따로 설치할 필요가 거의 없습니다.
- 커스텀 스킬 — 내가(또는 회사가) 직접 만든 스킬입니다. 우리 브랜드 규칙이나 업무 절차를 담아두면, 매번 설명을 다시 붙여넣지 않아도 Claude가 그 방식대로 일합니다. claude.ai 설정, Claude Code, Claude API 등에서 추가할 수 있습니다.
두 종류 모두 작동 방식은 같습니다. 그리고 스킬은 Anthropic이 공개한 오픈 표준이라, 같은 형식이 다른 호환 AI 도구에서도 쓰이도록 설계돼 있습니다.
안전하게 쓰려면
중요한 주의점이 있습니다. 스킬은 Claude에게 새로운 동작을 지시하는 만큼, 신뢰할 수 있는 출처(직접 만든 것, 또는 Anthropic 제공)만 사용해야 합니다. 출처가 불분명한 스킬은 Claude가 의도와 다른 동작을 하도록 유도할 수 있으므로, 쓰기 전에 SKILL.md와 포함된 파일을 꼼꼼히 확인하세요. 처음에는 사전 제공 스킬이나 Anthropic 공식 예시부터 시작하는 것이 안전합니다.
정리
스킬은 어려운 기술이 아니라 "Claude에게 특정 작업을 잘하는 법을 적어둔 폴더(레시피 카드)"입니다. 핵심은 SKILL.md 파일 하나이고, 필요할 때만 펼쳐지며, 사전 제공·커스텀 두 종류가 있습니다. 더 알아보려면 같은 사이트의 Claude 스킬 라이브러리 — 어디서 구하나와 용도별 스킬 활용법을 이어서 보세요.
본 글은 Anthropic 공식 문서(platform.claude.com/docs, anthropic.com, agentskills.io)의 공개 정보를 초보자용으로 풀어 정리했습니다. 본 사이트는 Anthropic 공식 사이트가 아닙니다.