짧은 답변
Skill은 안에 SKILL.md 파일이 있는 폴더입니다. 파일은 name과 description을 담은 짧은 헤더로 시작하고, 그 뒤에 지침이 이어집니다. 에이전트는 요청이 일치하기 전까지 이름과 description만 기억하고 있다가, 일치하면 나머지를 읽습니다. 같은 폴더가 Claude Code, Codex, Cursor에서 모두 작동합니다.
Skills가 필요한 이유
아마 이런 경험이 있을 겁니다
런칭 페이지용으로 40줄짜리 프롬프트를 갖고 있습니다. 레이아웃, 섹션, 휴대폰 너비에서의 검증까지 적혀 있죠. 매번 붙여 넣다가 한 번 한 줄을 빠뜨리면 페이지가 다르게 나옵니다. 그러다 팀원이 “그 프롬프트”를 달라고 하면 지난달 버전을 보내게 됩니다.
Skill은 그 프롬프트를 에이전트가 알아서 찾는 폴더로 바꿔 줍니다. Meridian Marketing Landing을 예로 들면, 설치하고 나면 에이전트가 모눈종이 Hero, 기능 그리드, 요금제 토글을 이미 알고 있습니다. 나는 제품 정보만 가져오면 됩니다.
대부분의 Claude Skills 예시는 같은 패턴을 따릅니다. 한 종류의 결과물을 위한 정해진 방법이죠. Notion Style OG Image는 16:9 공유 이미지를 만들고, Skillry의 다른 Skill들은 슬라이드 덱, 이력서 사이트, 짧은 영상을 만듭니다.
| 붙여 넣는 프롬프트 | Skill | |
|---|---|---|
| 설명해야 하는 것 | 레이아웃, 섹션, 스타일, 검증을 매번 | 내 콘텐츠만 |
| 실행할 때마다 | 조금씩 달라짐 | 같은 단계를 따름 |
| 공유 | 채팅 기록에서 찾아내기 | 같은 폴더를 설치 |
SKILL.md 파일에는 무엇이 들어 있나요?
Skill에 꼭 필요한 파일은 SKILL.md 하나이며, 참고 문서, 스크립트, 템플릿용 폴더를 선택적으로 넣을 수 있습니다. 파일은 두 부분으로 되어 있습니다. --- 줄 사이의 짧은 헤더, 그리고 에이전트를 위해 쓴 일반 지침입니다.
launch-page/
├── SKILL.md required
├── references/ optional: docs read when needed
├── scripts/ optional: code the agent can run
└── assets/ optional: templates and files---
name: launch-page
description: Build a product launch page with a hero, a feature
grid, and a pricing toggle. Use when asked for a launch page.
---
1. Ask for the product name, audience, and three features.
2. Build the hero, the feature grid, and the pricing section.
3. Check the page at phone width before you finish.name
최대 64자, 영문 소문자·숫자·하이픈만 사용합니다. 폴더 이름과 같아야 합니다.
description
최대 1,024자. Skill이 무엇을 하는지 그리고 언제 사용하는지 쓰세요. 에이전트는 이 뒷부분을 보고 Skill을 고릅니다.
선택 항목
license, compatibility, metadata, allowed-tools
이 제한은 공개된 Agent Skills 사양에서 나온 것입니다. Claude Code는 더 느슨해서 name을 생략하면 폴더 이름을 대신 사용합니다.
에이전트는 어떤 Skill을 쓸지 어떻게 결정하나요?
요청을 각 Skill의 description과 비교합니다. 이 과정을 가볍게 유지하기 위해 모든 Skill을 세 단계로 로드합니다.
- 1시작할 때 설치된 모든 Skill의 이름과 description만 읽습니다. 그 외에는 읽지 않습니다.
- 2요청이 description과 일치하거나 Skill을 이름으로 호출하면 전체
SKILL.md를 로드합니다. - 3작업하는 동안에는 지침이 시킬 때만
references/의 파일을 열거나scripts/를 실행합니다.
그래서 Skill을 수십 개 설치해도 에이전트가 느려지지 않습니다. 필요해지기 전까지 Skill은 컨텍스트에서 한 문장 정도만 차지합니다.
| 에이전트 | Skill을 이름으로 호출 |
|---|---|
| Claude Code | /skill-name |
| Codex | $skill-name 또는 /skills에서 선택 |
| Cursor | /skill-name 또는 @skill-name으로 첨부 |
자동 선택은 description의 품질만큼만 작동합니다. 선택되는 description 작성법은 트리거에서 다룹니다. 그전까지는 Skill을 이름으로 호출하면 항상 작동합니다.
어떤 에이전트에서 Skills를 쓸 수 있나요?
들어 본 에이전트라면 대부분 가능합니다. Anthropic이 Claude를 위해 이 형식을 만들었고, 2025년 12월 18일 공개 표준으로 발표했습니다. 현재 agentskills.io 사이트에는 Claude Code, ChatGPT와 Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI 등 이 형식을 읽는 도구가 수십 개 올라와 있습니다.
| 에이전트 | 개인 폴더 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.agents/skills/ (이전 경로 ~/.codex/skills/도 읽음) |
| Cursor | ~/.cursor/skills/ 또는 ~/.agents/skills/ |
개인 폴더에 있는 Skill은 내 컴퓨터의 모든 프로젝트에서 사용할 수 있습니다. 프로젝트 폴더를 비롯해 에이전트가 찾는 다른 모든 위치는 Skill 위치에 정리되어 있습니다.
Skill과 프롬프트, 무엇을 써야 할까요?
작업을 반복하고 매번 같은 품질을 원한다면 Skill로 만드세요. 일회성이라면 프롬프트로 충분합니다.
다시 할 작업
- 예시, 스크립트, 체크리스트가 필요함
- 매번 같은 결과를 원함
- 다른 사람도 필요로 함
일회성 작업
- 몇 문장이면 충분함
- 아직 원하는 것을 정리하는 중
- 재사용할 만한 내용이 없음
대부분은 둘 다 사용합니다. 프롬프트는 오늘 원하는 것을, Skill은 그것을 잘 해내는 방법을 말합니다. 자세한 내용은 Skills vs 프롬프트를 참고하세요.
Skill을 설치하기 전에 확인할 것
Skill은 내 컴퓨터에서 스크립트를 실행할 수 있으므로, 새 Skill은 먼저 간단히 읽어 보세요.
5분 점검
SKILL.md를 읽고 무엇을 바꿀 수 있는지 확인하세요.scripts/의 모든 내용을 읽으세요. 그 스크립트는 내 컴퓨터에서 실행됩니다.- Skill 페이지에서 의존성과 외부 비용을 확인하세요.
- 비밀번호와 API key는 Skill 파일과 채팅에 넣지 마세요.
자주 묻는 질문
Claude Skills란 무엇인가요?
Claude나 Claude Code에서 Agent Skills를 사용할 때 흔히 부르는 이름입니다. 형식은 같습니다. SKILL.md 파일이 있는 폴더죠. 같은 폴더가 Codex와 Cursor에서도 작동합니다.
Claude는 어떤 Skill을 쓸지 어떻게 아나요?
요청을 각 Skill의 description과 비교해 맞는 것을 로드합니다. /skill-name을 입력하면 추측 없이 바로 실행됩니다.
Claude Skills를 무료로 쓸 수 있나요?
Skill은 그냥 파일이므로 무료 Skill은 비용이 들지 않습니다. 다만 Claude Code, Codex, Cursor처럼 Skills를 지원하는 에이전트가 필요하며, 해당 제품이 요구하는 요금제를 따릅니다. Skillry에도 Dot Avatar Maker 같은 무료 Skill이 있습니다.
Skill은 MCP 서버와 같은 건가요?
아니요. Skill은 에이전트에게 방법을 가르치고, MCP 서버는 외부 데이터와 도구에 연결해 줍니다. 둘을 함께 쓰는 경우가 많습니다. Skills vs MCP를 참고하세요.
출처
이 가이드가 도움이 되었나요?