Agent Skills란? 첫 SKILL.md를 만들기 전에 작업부터 정해요
Agent Skills의 파일 형식과 호스트의 역할을 구분하고, 직접 확인할 수 있는 첫 작업과 예제 입력을 준비해요.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.
Agent Skills는 반복해서 하는 작업의 절차를 파일로 남기고 싶을 때 살펴볼 만한 형식이에요. 몇 개의 Skill을 모았는지보다, 매번 설명하던 규칙 하나를 다시 쓰면서 결과도 쉽게 확인할 수 있는지가 중요해요. 이미 자주 하는 수정이 있다면 그 내용부터 작은 절차로 정리할 수 있어요.
이 글에서는 첫 작업을 고르는 기준, 옮겨 쓸 수 있다는 말의 범위, 설치 전에 준비할 내용을 알아봐요. 이어지는 실습에서는 Claude Code로 회의 메모 정리 도구를 만들어요. 제품 설명은 2026년 10월 26일 공식 문서 기준이며, 실제 모델 실행 결과를 평가한 글은 아니에요.
작업을 시작할 조건이 있는 설명서예요
Agent Skills는 폴더와 SKILL.md를 중심으로 한 공개 형식이에요. 파일에는 이름, 설명, 작업 지침을 넣고 필요한 자료를 추가할 수 있어요. 지원하는 에이전트는 설명으로 관련 작업을 찾고 필요할 때 자세한 지침을 읽어요. Agent Skills 공식 개요
예를 들어 회의 메모를 정리할 때 “제안을 확정된 결정으로 쓰지 마”, “기한이 없으면 비워 두거나 미지정이라고 써”를 반복해서 말할 수 있어요. 이런 수정은 첫 Skill을 만들기 좋은 재료예요. 막연하게 전문가처럼 행동하라는 요청보다 무엇을 확인해야 하는지 드러나기 때문이에요.
다음은 직접 작성한 첫 작업 설계 카드예요.
작업: 현재 요청에 들어 있는 회의 메모를 정리해요.
독자: 무엇을 합의했고 누가 다음 행동을 해야 하는지 알고 싶은 사람이에요.
유지할 것: 이름, 날짜, 수량, 확실하지 않다는 표현이에요.
만들면 안 되는 것: 승인, 담당자, 기한, 완료 여부예요.
결과: 결정 사항, 할 일, 확인할 질문으로 나눠요.
확인: 각 할 일의 짧은 근거 문구를 원문과 비교해요.
이 카드에는 할 일과 확인 방법이 있지만 특정 회의 날짜는 없어요. 반복할 절차와 매번 달라지는 사실을 분리한 거예요. 이렇게 구분해야 지난주 참석자나 마감일을 이번 주 메모에 다시 넣는 실수를 발견하기 쉬워져요.
틀렸는지 직접 판단할 수 있는 작업을 골라요
첫 실습은 결과를 스스로 확인할 수 있을 만큼 작게 잡아요. 모든 상황에 대응하는 완벽한 작업보다, 어떤 답이면 받아들이고 어떤 답이면 수정할지 말할 수 있는 작업이 좋아요.
| 후보 작업 | 확인할 결과 | 넣어 볼 실패 사례 |
|---|---|---|
| 회의 메모 정리 | 결정과 담당 업무가 원문과 일치하는지 봐요 | 제안이 확정으로 바뀌는지 확인해요 |
| 행사 공지문 편집 | 날짜·장소·가격·신청 방법이 유지되는지 봐요 | 원문에 없는 신청 링크가 생기는지 확인해요 |
| 초안 기획서 점검 | 필수 정보가 있거나 누락으로 표시되는지 봐요 | 없는 타깃 독자를 임의로 정하는지 확인해요 |
이 표는 제품 성능을 측정한 결과가 아니라 연습할 작업 제안이에요. 입력을 제공할 수 있고, 수정 이유를 설명할 수 있고, 실제로 수정됐는지 알아볼 수 있는 작업을 고르세요. 좋은 결과가 무엇인지 불분명하면 지침 파일만 길게 늘려도 개선 여부를 판단하기 어려워요.
반복할 절차, 바뀌는 입력, 검토한 결과를 따로 두는 습관도 도움이 돼요. 행사 날짜가 달라지면 입력을 바꾸면 돼요. 같은 유형의 잘못이 반복되면 절차를 고칠 이유가 생겨요. 한 문장만 마음에 들지 않을 때는 그 문장만 편집해도 충분할 수 있어요.
옮겨 쓰려면 실행하는 제품도 확인해요
표준은 파일 형식을 정하고, 실제 에이전트 제품은 화면과 모델, 사용할 도구를 제공해요. 실습에서는 프로젝트 안의 Skills 위치를 공식적으로 안내하는 Claude Code를 사용해요. 다른 제품에서는 설치 위치와 호출 순서가 달라질 수 있어요. Claude Code 디렉터리 안내
첫 예제는 텍스트만으로 만들어요. 표준의 name, description 정보와 직접 쓴 절차부터 넣어요. 선택 항목도 있지만 첫 실습에서 모두 사용할 필요는 없어요. 형식 명세
다른 지원 제품으로 옮길 때는 세 가지를 확인해요. 그 제품이 파일을 찾는지, 원하는 절차를 선택할 수 있는지, 같은 예제가 정한 기준을 만족하는지예요. 파일을 복사하는 일과 결과가 같다는 것을 확인하는 일은 별개예요. 나중에 스크립트나 특정 제품의 설정을 추가한다면 확인할 부분도 늘어나요.
평범한 입력 하나와 까다로운 입력 하나를 준비해요
회의 메모라면 첫 입력에는 확실한 결정 두 개와 담당자를 정한 업무 두 개를 넣어 봐요. 두 번째 입력에는 아무도 승인하지 않은 제안과, 회의 날짜 없이 나온 내일이라는 기한을 넣어요.
생성하기 전에 통과 기준을 적어 두세요. 첫 입력에서는 담당자 두 명이 유지돼야 해요. 두 번째 입력에서는 정해지지 않은 날짜를 임의로 확정하면 안 돼요. 보기 좋은 문장에 집중하다가 사실이 달라진 점을 놓치지 않도록 만드는 확인 기준이에요.
공식 작성 지침도 실제 사용 후 수정하는 과정을 안내해요. 이 글의 시작 예제는 실행해 검증한 도구가 아니에요. 통제된 입력으로 직접 확인하는 단계에서 자신의 작업에 필요한 규칙을 발견하게 돼요. 공식 작성 안내
파일 준비와 계정 선택을 나누어 생각해요
Markdown 파일을 저장하는 것과 에이전트 이용료는 별도예요. Claude Code 실습에 들어가기 전 공식 계정·요금제 페이지에서 사용할 계정을 확인해 주세요. 이 예제에 대해 측정한 시간 절약이나 비용 절감 수치를 제시하지는 않아요.
반복할 작업의 이름을 붙이고, 가상 입력 두 개를 준비하고, 어떤 결과면 거절할지 설명할 수 있다면 실습을 시작할 준비가 된 거예요. 작은 절차를 먼저 만든 뒤 다시 열고 재사용해 보세요. 무엇을 바꿨고 왜 도움이 됐는지 이해할 수 있을 때 범위를 넓히면 돼요.