단원 목차 · 실제로 쓰기
- 좋은 요청
- 프로젝트 구조
- Git 기본
- Notion 연결 — MCP
- 서브에이전트 위임
- 규칙 파일 — CLAUDE.md
- Context 관리
- Skills · Plugin
↑ 먼저 — Context 관리
실습 Skills
Skills · Plugin
같은 순서로 하는 작업을 매번 처음부터 다시 설명하고 있지 않나요? 그 순서를 패키지로 묶어 두면 다음부터는 불러 쓰기만 하면 됩니다.
같은 절차를 매번 처음부터 설명하면 그만큼 시간이 들고, 설명을 빠뜨리면 결과도 매번 달라집니다.
Skill(스킬)은 특정 작업의 절차와 규칙을 SKILL.md 파일에 정리해 둔 패키지입니다. 예전에는 커스텀 커맨드와 스킬이 따로였지만 지금은 하나로 통합되어, 이름을 불러 실행하면 매번 설명했던 순서와 기준을 다시 적지 않아도 됩니다. 이름을 몰라도 됩니다. description에 실제로 쓸 법한 표현을 적어 두면 Claude가 요청 맥락을 보고 스스로 스킬을 불러옵니다. description이 부실하면 이 자동 호출이 안 되고, 사용자가 이름을 직접 불러야만 실행됩니다.
Plugin(플러그인)은 Skill·서브에이전트·Hook을 묶어 다른 프로젝트나 사람에게 그대로 옮기는 배포 단위입니다. 한 프로젝트에서 다듬은 조합을 다른 곳에도 쓰고 싶을 때 이 단위로 옮깁니다. 카피라이터가 매주 같은 형식으로 뉴스레터 초안을 뽑는다면, 그 절차를 스킬로 만들어 두고 다음부터는 이름만 불러 실행하면 됩니다. 흔한 안티패턴은 description에 “뉴스레터용”처럼 짧게만 적어 두는 것으로, 실제 요청 문장과 맞아떨어지지 않아 자동으로 불려 오지 않습니다. 처음부터 완벽하게 만들 필요는 없습니다. 반복하다 보면 빠진 단계나 잘못된 가정이 드러나므로, 실제로 쓰면서 다듬는 편이 낫습니다.
아래 연습을 그대로 붙여넣어 반복 절차 하나를 스킬로 만들어 보세요.
순서
- 반복하는 절차 하나를 글로 정리합니다.
- .claude/skills/<이름>/SKILL.md 파일을 만들어 절차를 적습니다.
- /스킬이름으로 불러 실행합니다.
- 쓰면서 빠진 단계나 잘못된 가정을 다듬습니다.
연습
다음 절차를 스킬로 만들어 줘. 1) 회의록을 받으면 결정사항·할 일·미결로 나눈다 2) 할 일에는 담당자를 추정하지 않고 비워 둔다 3) 표 형식으로 정리한다. .claude/skills 폴더에 SKILL.md로 저장해 줘.
[반복하는 작업 절차 한 줄]을 스킬로 만들어 줘. 이름과 description은 내가 실제로 쓸 법한 표현으로 지어 줘.
만든 스킬을 이름으로 불러 실행해 보고, 설명 없이도 같은 결과가 나오는지 확인해 보세요.
반복 작업 하나를 Skill로 불러 실행했을 때 매번 설명하지 않아도 같은 결과가 나오면 통과입니다.
막히는 지점
SKILL.md의 description이 부실하면 이름을 직접 불러야만 실행되고, Claude가 상황에 맞춰 스스로 불러오지는 못합니다. 실제로 말할 법한 키워드를 description에 넣어야 자동 호출이 됩니다. 한 번 쓰고 말 일까지 스킬로 만들면 관리할 파일만 늘어나므로, 세 번 이상 반복한 절차부터 스킬화합니다.
2026-07-13 기준 · 출처 · Claude Code — Skills