모든 글

Agent Skills 첫 사용법: Claude Code에 회의 메모 정리 SKILL.md 만들기

Claude Code 설치부터 SKILL.md 저장과 호출까지 따라 하고, 결정 사항·담당 업무·미해결 질문을 원문과 확인해요.

마지막 업데이트

메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

앱 · APP
공식 자료를 읽고 정리했어요 · 직접 실행한 후기는 아직 없어요 자료 확인일:

첫 Agent Skill은 작은 문서 작업부터 만들면 좋아요. 이 글에서는 뒤섞인 회의 메모를 확정된 결정, 담당자가 있는 할 일, 아직 정하지 않은 질문으로 나누는 meeting-note-check를 만들어요. Claude Code 설치와 시작, 완성된 SKILL.md 저장, 실행 요청, 결과 확인, 다른 입력으로 수정 확인까지 이어서 해볼 거예요.

설치 방법과 경로는 2026년 10월 26일 공식 문서로 확인했어요. 이 글을 위해 Claude Code를 설치하거나 유료 모델 세션을 실행하지는 않았어요. 회의 메모와 예상 결과는 모두 직접 만든 가상 예시예요. 실제 실행 화면이나 성능 측정 결과로 제시하는 내용은 없어요.

1. 설치 전에 계정과 준비물을 확인해요

여기서는 Claude Code의 터미널 화면을 사용해요. 공식 지원 조건에는 macOS 13 이상, Windows 10 버전 1809 이상, 메모리 4GB 이상과 인터넷 연결이 포함돼요. Linux를 쓴다면 배포판별 조건도 확인해 주세요. 시스템 요구 사항

Claude Code를 사용할 수 있는 계정도 필요해요. Claude 구독과 Console의 API 과금은 서로 다른 이용 경로예요. 기존 계정에 맞는 방법을 선택하고, 시작 전 현재 Claude 요금제와 Claude Code 비용 안내를 확인해 주세요. 아래의 텍스트 파일을 만든다고 모델 사용 권한을 구매하거나 무료 이용권을 얻는 것은 아니에요.

일반 텍스트 편집기와 빈 연습 폴더를 준비해요. 이번 작업에는 실제 회사 회의록이나 다른 서비스 연결이 필요하지 않아요. 가상 메모를 쓰면 결과에 들어가도 되는 사실을 한눈에 비교할 수 있어요. 첫 시도에서는 파일 한 개와 입력 한 개를 다루는 데 집중해 주세요.

2. 설치를 확인하고 연습 폴더를 만들어요

이미 claude --version이 실행된다면 설치 단계는 넘어가도 돼요. 처음이라면 macOS·Linux에서는 터미널, Windows에서는 PowerShell을 열어요. 다음은 공식 기본 설치 명령이에요. 사용하는 환경에 맞는 것 하나만 실행해 주세요. 공식 설치 안내

macOS·Linux·WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

설치가 끝나면 새 터미널 창에서 아래 명령을 실행해요.

claude --version

버전 번호가 보이면 실행 명령을 찾을 수 있는 상태예요. 명령을 찾을 수 없다는 오류가 나오면 위 공식 설치 문서의 문제 해결 안내를 먼저 따라가 주세요. 이 단계에서 Skill 파일을 여러 번 새로 만들어도 설치 문제를 해결할 수는 없어요.

이제 아래 연습용 명령으로 폴더를 만들어요. 폴더만 만드는 명령이라 SKILL.md 내용은 다음 단계에서 따로 저장해야 해요.

macOS·Linux·WSL:

mkdir -p ~/skill-practice/.claude/skills/meeting-note-check
cd ~/skill-practice

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\skill-practice\.claude\skills\meeting-note-check"
Set-Location "$env:USERPROFILE\skill-practice"

연습 폴더를 기준으로 한 저장 위치는 .claude/skills/meeting-note-check/SKILL.md예요. Claude Code는 프로젝트 설정과 홈 폴더의 개인 설정을 구분해요. 이번에는 연습 프로젝트 안에 파일을 두어요. 디렉터리 안내

텍스트 편집기에서 skill-practice 폴더를 열고, 방금 만든 하위 폴더 안에 SKILL.md 파일을 추가해 주세요. 파일 이름 뒤에 .txt가 한 번 더 붙지 않았는지도 확인해요.

3. 완성된 SKILL.md를 저장해요

Agent Skills 파일은 YAML 형식의 정보와 Markdown 본문으로 구성돼요. 필수 항목인 name은 폴더 이름과 같아야 하고, description에는 어떤 작업에서 쓰는지 적어요. 파일 형식 명세

아래는 이 글을 위해 만든 전체 예제예요. 위아래 ---까지 빠짐없이 SKILL.md에 붙여 넣고 저장해 주세요.

이 예시 파일 내려받기

여기서 중요한 부분은 “잘 요약해 줘”보다 구체적인 확인 방법이에요. 근거 문구가 있으면 그 결정을 실제로 합의했는지 원문과 대조할 수 있어요. 기한이 없을 때 미지정이라고 적게 하면 빈칸이 단순한 작성 실수인지, 원문에 정보가 없는 것인지도 구분하기 쉬워져요.

이번 회의의 날짜나 참석자 이름은 이 파일에 넣지 않아요. Skill에는 반복해서 쓸 절차를 남기고, 매번 달라지는 회의 내용은 실행할 때 전달할 거예요.

4. Claude Code를 시작하고 메모를 넣어요

터미널에서 skill-practice 폴더에 있는 상태로 claude를 실행해요. 처음이면 브라우저 로그인 안내를 따라가요. 로그인 창이 열리지 않거나 계정 선택이 헷갈리면 공식 인증 안내에서 해당 상황을 확인해 주세요. 로그인 안내

Claude Code의 채팅 입력란에서 /meeting-note-check를 입력해요. 이 명령은 운영체제의 PowerShell 입력란에 쓰는 명령과 달라요. Claude Code는 /skill-name 방식으로 Skill을 직접 호출할 수 있어요. Skill 호출 방법

Skill을 선택하거나 제출한 뒤 아래 메모를 전달해요. 다음 메시지로 입력한다면 meeting-note-check에 넣을 메모라는 점도 함께 적어 주세요.

meeting-note-check로 아래 가상 메모를 정리해 줘. 한국어로 답해 줘.

샘플 책방 기획 회의, 2026년 11월 2일.
합의: 종이 책갈피 만들기 행사를 11월 7일에 진행한다.
참가 인원은 최대 12명으로 승인했다.
민아는 11월 4일까지 카운터 안내판 초안을 만든다.
준은 공급업체에 종이 재고를 문의한다. 기한은 정하지 않았다.
무료 음료를 제공하자는 제안이 나왔지만 결정하지 않았다.
참가비는 아직 논의 중이다.

첫 실행에서는 이메일 발송이나 일정 등록을 함께 요청하지 않아요. 목표가 검토 가능한 회의 정리 초안이므로, 입력과 분류 결과를 비교하는 것만으로 이번 작업을 끝낼 수 있어요.

5. 결과를 원문과 비교해요

다음은 받아들일 수 있는 결과를 설명하기 위해 직접 작성한 예시예요. Claude에서 실제로 받은 응답은 아니에요.

결정 사항
- 종이 책갈피 만들기 행사를 11월 7일에 진행한다.
  근거: "합의: 종이 책갈피 만들기 행사를 11월 7일에 진행한다."
- 참가 인원을 최대 12명으로 제한한다.
  근거: "참가 인원은 최대 12명으로 승인했다."

할 일
작업 | 담당자 | 기한 | 근거 문구
카운터 안내판 초안 작성 | 민아 | 11월 4일 | "민아는 11월 4일까지 카운터 안내판 초안을 만든다."
종이 재고 문의 | 준 | 미지정 | "준은 공급업체에 종이 재고를 문의한다. 기한은 정하지 않았다."

확인할 질문
- 무료 음료: 제안만 나왔으며 승인하지 않았다.
- 참가비: 아직 논의 중이다.

문장을 예쁘게 다듬기 전에 분류부터 봐요. 준의 작업에 민아의 기한이 붙으면 안 돼요. 무료 음료가 제공 확정으로 바뀌거나, 미정인 참가비가 무료로 바뀌어도 안 돼요. 근거 문구는 실제 입력에 있어야 해요. 원문에 없는 설명을 또 생성해서 근거라고 붙인다면 확인 기능을 하지 못해요.

문제가 발견되면 틀린 부분과 유지할 부분을 함께 말해요.

무료 음료는 제안만 나왔고 승인하지 않았어.
그 항목을 확인할 질문으로 옮겨 줘.
확정된 결정 두 개와 작업 담당자, 기한은 바꾸지 말아 줘.

입력 메모와 검토한 결과는 별도의 연습 노트로 저장해 두세요. 원문을 함께 보관해야 나중에 지침을 바꿨을 때 같은 내용을 기준으로 비교할 수 있어요.

6. 다시 열고 다른 메모로 수정 여부를 확인해요

exit를 입력해 세션을 끝내요. 다시 작업할 때는 같은 skill-practice 폴더에서 claude를 시작해요. 파일이 이 프로젝트 안에 있으니 어디서 수정할지 찾기 쉬워요. 터미널 이동이나 세션 종료가 낯설다면 공식 터미널 기초 안내를 참고해 주세요.

이번에는 확정된 내용이 거의 없는 메모를 넣어 봐요.

meeting-note-check로 정리하고 한국어로 답해 줘.

가상 메모이며 회의 날짜는 기록하지 않았다.
래: 독서 모임을 내일 시작하면 어떨까요?
시작 날짜를 확정한 사람은 없다.
알렉스가 후보 공간 두 곳을 비교해 보겠다고 했다.
기한은 배정하지 않았다.

이 입력에서는 확정된 시작 날짜가 없어야 해요. 알렉스의 공간 비교는 할 일에 들어가되 기한은 미지정이어야 해요. 내일을 임의의 날짜로 바꾸면 안 돼요. 첫 사례와 다른 종류의 실수를 확인하기 위한 입력이에요.

반복해서 필요한 설명이 보이면 SKILL.md에서 해당 규칙 하나를 수정하고 저장해요. 현재 Claude Code는 Skill 본문의 변경을 감지해요. 세션 시작 후 최상위 Skills 폴더를 새로 만들었다면 변경 후 /reload-skills를 실행해 주세요. 변경 반영 안내

수정 전 파일을 날짜가 있는 이름으로 백업하고, 바꾼 이유를 한 줄 남겨요. 그런 다음 두 메모를 다시 확인해요. 한 사례가 좋아졌다고 다른 사례도 괜찮을 것이라고 가정하지 않는 거예요. 이 정도의 확인은 작은 작업 기준이며 모든 회의록의 정확도를 입증하는 실험은 아니에요.

Skill이 안 보이면 현재 폴더, 파일 이름, 폴더와 name의 일치를 확인해요. 잘못 분류하면 그 분류 기준이나 예시를 고쳐요. 다른 결제 안내가 나오면 선택한 계정 경로를 먼저 확인해요. 다른 에이전트로 옮기려면 그 제품의 설치 위치와 지원 기능을 확인해요. 이 예제는 텍스트만 사용하지만, 호스트마다 실제 동작을 다시 확인해야 해요.

파일을 다시 찾고, 직접 호출하고, 분류 근거를 설명하고, 지침 하나를 고쳐 다른 사례까지 확인할 수 있으면 첫 실습을 마친 거예요. 이렇게 만든 절차는 이후에 직접 읽고 손볼 수 있는 작업 자산이 돼요.

완료 전에 직접 확인할 항목을 정리한 설명 그림

아래 그림은 실습 결과를 확인하기 위한 자체 제작 체크리스트예요. 실제 앱 화면이나 생성 결과가 아니에요.

참고 자료