교재 목차
MODULE 03 / 16
03
Part 3 · 규칙과 스킬

규칙과 스킬

매번 같은 부탁을 다시 적는 게 슬슬 지겨워질 때다. 한 번 정한 정리 방식을 ‘규칙’으로 못 박고, 세 번쯤 반복한 작업을 ‘스킬’로 굳혀 이름 하나로 다시 부른다. 그러고 나면 스킬이 정확히 무엇인지, 플러그인과는 어떻게 다른지가 또렷해진다.


Lesson 09

특정 규칙으로 파일 정리하기

1모듈에서 폴더 하나를 한 번 정리시켜 봤다. 그런데 비슷한 폴더를 매주 똑같이 정리해야 한다면, 매번 같은 문단을 다시 쓰는 게 맞을까.

한 번 쓰고 버릴 부탁과, 앞으로도 계속 쓸 규칙은 다르다.

“이 폴더 정리해줘”는 그때 한 번의 부탁이다. 반면 “앞으로 이런 폴더는 항상 이렇게 정리해”는 규칙이다. 규칙은 한 번 정해 두면 다음부터 “규칙대로 정리해줘” 한마디로 끝난다.

여기서 중요한 건 분류 기준을 무엇으로 잡느냐다. 사람들은 흔히 확장자로 나누지만, 막상 머릿속에서 파일을 찾을 때는 ‘청구서’, ‘계약서’, ‘발표자료’처럼 용도로 떠올린다. 규칙도 그 머릿속 기준에 맞춰 적을수록 결과가 손에 익는다.

규칙은 ‘기억해 둬’라는 한마디가 핵심

일회성 부탁과 규칙을 가르는 건 딱 한 문장이다. “이 규칙을 기억해 뒀다가, 다음에 ‘규칙대로 정리해줘’라고만 해도 똑같이 해줘.”

이 한마디가 붙는 순간, 부탁은 재사용 가능한 약속으로 바뀐다. 다음 주에 비슷한 폴더를 만나도 긴 설명을 다시 쓸 필요가 없다.

붙여넣기 프롬프트 · 내 정리 규칙 선언
앞으로 이 폴더를 정리할 때는 항상 아래 규칙을 따라줘.
- 확장자가 아니라 "용도"로 분류한다: 청구서, 계약서, 이미지, 발표자료, 기타
- 파일명에 회사명이 들어 있으면 그 회사명 하위 폴더로 한 번 더 묶는다
- 날짜가 있는 파일은 이름 맨 앞에 "YYYY-MM-DD_"를 붙인다
- 옮기기 전에 규칙에 따른 이동 계획을 표로 먼저 보여준다
- 내가 "진행"이라고 답하면 그때 옮긴다
이 규칙을 기억해 뒀다가, 다음에 "규칙대로 정리해줘"라고만 해도 똑같이 해줘.
규칙 다듬기 변형까지 전체는 prompts/m03/01-규칙으로-파일정리.md
1모듈의 안전 리듬은 그대로

규칙이 길어져도 계획 먼저 → 진행은 빼지 않는다. 규칙대로 움직이는 작업일수록 한 번에 여러 파일을 건드리니, dry-run으로 이동 계획을 먼저 받는 습관이 오히려 더 중요하다.

실습 09

내 정리 규칙 한 벌 만들기

  1. 자주 어질러지는 폴더를 하나 정해, 위 규칙 프롬프트를 내 용도에 맞게 고쳐 붙여넣는다.
  2. 이동 계획을 받고 한 번 다듬은 뒤 “진행”한다.
  3. 며칠 뒤 비슷한 폴더에서 “규칙대로 정리해줘”라고만 해 본다 — 같은 결과가 나오는지 확인한다.

목표: 긴 부탁을 짧은 호출로 줄여 보는 것. 규칙이 길고 자주 쓰인다고 느껴지면, 그게 바로 다음 레슨 ‘스킬화’의 신호다.

한 문장 요약

한 번의 부탁에 “기억해 둬”를 붙이면, 그게 규칙이 된다.

규칙은 용도로 적을수록 손에 맞고, 길어질수록 스킬로 굳힐 때가 됐다는 뜻이다.


Lesson 10

스킬 제네레이터로 스킬화

같은 절차를 세 번쯤 반복했다면, 손이 기억하기 전에 도구에게 기억시키자. 그 절차를 ‘스킬’로 굳히면 다음부터는 이름 하나로 불러낸다.

규칙을 매번 채팅창에 다시 적는 단계에서, 절차에 이름을 달아 박아 두는 단계로 넘어가는 순간이다.

스킬 제네레이터는 ‘방금 한 작업’을 재사용 가능한 절차로 바꿔 주는 도구다. 우리가 직접 형식을 짜지 않아도, 무엇을 했는지 설명하면 스킬의 뼈대를 대신 만들어 준다.

좋은 스킬은 세 가지가 또렷하다. 이름(뭐라고 부를지), 설명과 트리거(언제 꺼내 쓸지), 그리고 빈칸(매번 달라지는 부분). 이 셋이 분명해야 나중에 헷갈리지 않고 다시 꺼낸다.

반복 작업이 스킬이 되는 3단계 — 같은 부탁 반복, 절차로 추출, 이름으로 다시 호출
그림 1. 반복 → 추출 → 호출. 같은 부탁을 세 번 하면, 그 절차를 한 장으로 추출해 이름으로 다시 부른다.

무엇을 빈칸으로 남길지가 실력

스킬을 만들 때 흔한 실수는 모든 걸 고정해 버리는 것이다. 대상 폴더, 분류 항목까지 박아 두면 딱 한 상황에서만 쓰인다.

반대로 매번 달라질 부분을 빈칸으로 비워 두면, 같은 스킬을 여러 폴더·여러 기준에 쓸 수 있다. 무엇을 고정하고 무엇을 비울지 가르는 감각이 스킬화의 핵심이다.

붙여넣기 프롬프트 · 방금 한 작업을 스킬로
방금 우리가 한 작업(용도별 파일 정리 + 날짜 접두어 + 계획 먼저 확인)을
재사용 가능한 스킬로 만들어줘.
- 스킬 이름: "용도별-정리"
- 설명: 폴더를 용도별로 분류하고 날짜 접두어를 붙인 뒤, 실행 전 계획을 보여주는 절차
- 언제 써야 하는지(트리거)도 한 줄로 적어줘: "폴더 정리해줘", "규칙대로 정리"
- 내가 채워 넣을 부분(대상 폴더, 분류 항목)은 빈칸으로 남겨줘
완성된 스킬을 보여주고, 다음부터 "/용도별-정리"로 부를 수 있게 등록해줘.
스킬 다듬기 변형까지 전체는 prompts/m03/02-스킬화-요청.md
실습 10

내 규칙을 스킬로 굳히기

  1. 레슨 9에서 만든 정리 규칙을 위 프롬프트에 넣어 스킬로 만들어 달라고 한다.
  2. 제안받은 스킬에서 이름·설명·트리거가 또렷한지 살피고, 어색하면 한 번 더 다듬어 달라고 한다.
  3. 대상 폴더와 분류 항목이 빈칸으로 남았는지 확인한다.
  4. 다른 폴더를 열고 “/용도별-정리”로 불러내 같은 절차가 재현되는지 본다.

목표: 손으로 다시 적던 절차가 이름 하나로 호출되는 경험. 한 번 굳혀 두면 같은 작업의 비용이 거의 0에 가까워진다.

한 문장 요약

세 번 반복했으면, 손이 아니라 스킬에 기억시킨다.

이름·트리거·빈칸 세 가지만 또렷하면, 긴 절차가 한 줄 호출로 바뀐다.


Lesson 11

스킬이란 무엇인가

방금 하나 만들어 봤으니 이제 정체를 밝힐 차례다. 스킬은 마법이 아니라, 에이전트에게 건네는 ‘이 일은 이렇게 하라’는 한 장짜리 업무 매뉴얼이다.

거창한 프로그램이 아니라, 잘 쓰인 한 페이지의 절차서에 가깝다.

신입사원에게 “정산은 이 순서로 처리하세요”라고 적어 둔 한 장의 안내문을 떠올리면 된다. 평소엔 서랍에 들어 있다가, 정산할 일이 생기면 꺼내 그대로 따른다. 스킬도 똑같다.

그래서 스킬은 두뇌(모델) 자체가 아니다. 두뇌는 그대로 두고, 특정 상황에서 꺼내 읽는 절차 지식을 옆에 붙여 두는 것이다. 평소엔 잠들어 있다가 트리거에 걸리면 깨어난다.

스킬의 세 부분

잘 만든 스킬은 늘 같은 골격을 갖는다. 이름표, 언제 쓸지, 그리고 무엇을 할지다.

트리거가 절반이다

초보가 만든 스킬이 안 불려 나오는 이유는 대개 본문이 아니라 설명·트리거가 모호해서다. “이걸 언제 써야 하는가”를 사람이 읽고 바로 알 만큼 구체적으로 적어야, 에이전트도 제때 꺼내 쓴다.

스킬(skill)
특정 상황에서 꺼내 읽는 한 장짜리 절차 지식. 두뇌가 아니라 두뇌에 붙이는 매뉴얼.
트리거(trigger)
스킬이 깨어나는 신호. “언제 이 스킬을 쓰는가”를 적은 부분.
호출
잠든 스킬을 꺼내 쓰는 것. 이름으로 부르거나(/이름) 트리거 상황에서 자동으로.
한 문장 요약

스킬은 두뇌가 아니라, 두뇌에 붙이는 한 장짜리 절차서다.

이름·트리거·본문 셋으로 이뤄지고, 그중 ‘언제 쓰는가’가 가장 자주 부실하다.


Lesson 12

플러그인과 스킬의 차이

스킬을 알고 나면 곧 ‘플러그인’이라는 말이 따라온다. 둘은 헷갈리기 쉽지만, 관계는 단순하다. 스킬은 낱장이고, 플러그인은 그 낱장들을 담은 꾸러미다.

한 장의 절차서와, 절차서·도구·명령을 한데 묶은 업무 키트의 차이라고 보면 된다.

스킬 하나는 ‘이 일은 이렇게 하라’는 한 장이다. 그런데 어떤 일은 절차 하나로 끝나지 않는다. 여러 절차에, 새로운 도구와 단축 명령까지 한 세트로 필요할 때가 있다.

그럴 때 그것들을 하나로 묶어 설치하고 공유할 수 있게 포장한 것이 플러그인이다. 플러그인 안에는 스킬 여러 개가 들어 있을 수 있고, 도구나 명령도 함께 담긴다.

스킬 vs 플러그인 — 스킬은 반복 절차 한 장, 플러그인은 스킬을 담은 꾸러미
그림 2. 스킬은 절차 한 장(낱장), 플러그인은 그 스킬들과 도구·명령을 담은 꾸러미(묶음)다.

언제 무엇을 쓰나

구분이 헷갈릴 땐 ‘혼자 쓸 것인가, 나눠 줄 것인가’로 갈라 보면 쉽다.

대부분의 사람은 스킬부터 시작한다. 절차가 쌓이고 “이걸 팀에 나눠 주고 싶다”는 생각이 들 때, 비로소 플러그인을 떠올리면 된다.

스킬
절차 한 장(낱장). 가볍게 만들어 혼자 바로 쓰는 단위.
플러그인
스킬·도구·명령을 담은 꾸러미(묶음). 설치·공유가 되는 배포 단위.
관계
플러그인 ⊃ 스킬. 꾸러미 안에 낱장이 여러 장 들어간다.
모듈 3 마무리

스킬은 낱장, 플러그인은 그 낱장을 담은 꾸러미다.

규칙으로 정리를 못 박고(L9), 반복을 스킬로 굳히고(L10), 스킬의 정체(L11)와 플러그인과의 차이(L12)까지 짚었다. 이제 절차를 재사용하는 감각이 생겼으니, 다음 모듈에서 더 큰 자동화로 넘어간다.

출처 · 더 읽을거리

이 모듈의 근거 문서

  1. 문서Anthropic — Agent Skills 공식 문서
    스킬의 구조(이름·설명·본문)와 트리거 작성 기준. 레슨 10~11의 근거.
    docs.anthropic.com/en/docs/claude-code/skills
  2. 문서Anthropic — Claude Code 플러그인 문서
    스킬·명령·도구를 묶어 배포하는 플러그인 개념. 레슨 12의 근거.
    docs.anthropic.com/en/docs/claude-code/plugins
  3. 문서Anthropic — Claude Code 공식 문서
    규칙·자동화의 바탕이 되는 코딩 에이전트 개요.
    docs.anthropic.com/en/docs/claude-code