Prompt Master 스킬로 Claude Code 한도 아끼는 법 (설치 5분)

한도를 태우는 것은 큰 작업이 아니라, 빗나간 요청의 재시도다. 시키기 전에 지시문을 한 번 만들면 한 번에 끝난다.

대상: Claude Code를 쓰는 Pro 이상 사용자 소요 시간: 설치 5분 + 첫 사용 5분 난이도: ★☆☆☆☆ (복사·붙여넣기를 할 줄 아신다면 이미 자격이 충분합니다) 터미널: 몰라도 됩니다. 모든 단계는 Claude Code 입력창에 붙여넣는 프롬프트로 진행합니다. 터미널이 더 편한 분을 위해서는 같은 작업의 명령어를 바로 아래 접힌 칸에 순서대로 넣어 두었어요. 검증: 이 글의 설치 과정은 Windows 11 + Claude Code 2.1.266 환경에서 실제로 돌려 보고 썼습니다. 중간중간 나오는 "실제로 해 보니" 상자가 그 기록입니다.

1. 혹시 오늘도 "아니, 그게 아니라…"로 시작하셨나요

장면 하나를 그려 보겠습니다.

"로그인 화면 만들어줘." 한 줄 던져 놓고 커피를 가지러 갔다 옵니다. 돌아와 보니 Claude가 쓰지도 않는 라이브러리로 아주 성실하게 화면을 만들어 놨습니다. 잘못한 건 Claude가 아닙니다. 아무 말도 안 해 줬으니까요. 그래서 설명을 덧붙여 다시 시킵니다.

비슷한 장면은 더 있습니다.

한참 작업하다 보니 앞에서 "이 폴더는 건드리지 말자"고 정한 걸 Claude가 잊어버려서 다시 설명했다.
Midjourney에 넣을 프롬프트를 부탁했는데 어딘가 밋밋해서, 지금 세 번째 다시 요청 중이다.
그리고 마침내 만납니다. "사용 한도에 도달했습니다."

그런데 말이죠, 한도를 제일 빨리 태우는 범인은 큰 작업이 아닙니다. 빗나간 작업의 재시도입니다. Claude Code는 한 번 빗나가면 파일을 읽고, 고치고, 되돌리는 과정을 통째로 다시 밟습니다. 부실한 요청 한 줄 때문에 수만 토큰이 두 번 나가는 셈이죠. 택시를 탔는데 목적지를 "저기 그… 큰 건물 있는 데요"라고 말한 것과 비슷합니다. 미터기는 기사님 잘못이 아니어도 올라갑니다.

오늘 소개할 Prompt Master는 바로 이 지점을 노린 스킬입니다. 대충 던진 아이디어를 받아서, 빠진 정보가 있으면 딱 세 개까지만 되묻고, 한 번에 통하는 지시문으로 바꿔 줍니다.

자, 그럼 제일 궁금하실 것부터 말씀드릴게요. 그래서 이거, 꼭 깔아야 하나요?

2. 결론부터: 필수는 아닙니다. 그런데 어떤 분에게는 꽤 쏠쏠합니다

뜸 들이지 않겠습니다. 종합 6점 / 10점, "있으면 좋은 옵션"입니다.

항목	점수	근거
인기도	8 / 10	GitHub 별 약 13,300개, 포크 약 1,550개 (2026-09-19 확인). 공개 6개월 된 스킬 하나치고는 상당한 숫자입니다
관리 상태	8 / 10	현재 v1.8.0. 새 모델이 나올 때마다 맞춰서 갱신되고 있고, MIT 라이선스입니다
설치 난이도 (쉬울수록 높음)	9 / 10	글 파일 다섯 개를 폴더에 넣으면 끝. 실행 파일이 하나도 없습니다
한도 절약 체감	5 / 10	효과가 "재시도가 줄어든 만큼"이라 간접적입니다. 공개된 실측 수치도 없고요
필수도	4 / 10	Claude Code는 원래도 되묻고 계획을 세울 줄 압니다. 없어도 일은 됩니다
종합 추천	6 / 10	있으면 좋은 옵션

"6점이면 애매한데요?" 하실 수 있습니다. 맞습니다, 평균은 애매합니다. 그런데 이 스킬은 쓰는 사람에 따라 점수가 크게 갈립니다.

이런 분에게는 8점입니다

일단 짧게 던지고, 결과를 보면서 고쳐 나가는 스타일이신 분
이미지·영상 AI, Cursor, ChatGPT처럼 다른 도구에 넣을 프롬프트를 Claude에게 자주 부탁하시는 분
세션이 길어지는 편이고, 새 대화로 넘어갈 때마다 처음부터 다시 설명하느라 지치신 분

이런 분에게는 3점입니다

이미 요청을 꼼꼼하게 쓰시는 분 (대상 파일, 금지 사항, 완료 기준을 습관처럼 적으신다면 이 글은 복습입니다)
계획 모드(Plan mode)를 잘 쓰고 계신 분
한두 줄짜리 작은 수정이 대부분이신 분

본인이 어느 쪽인지 감이 오셨다면, 설치 버튼을 누르기 전에 딱 세 가지만 짚고 가겠습니다. 이걸 모르고 깔면 "어, 생각한 거랑 다른데?" 하게 되거든요.

3. 깔기 전에 풀고 가는 오해 세 가지

① 깔아 두면 알아서 다 고쳐 주는 도구가 아닙니다. 이 스킬은 "프롬프트를 써줘 / 고쳐줘"라고 콕 집어 부탁할 때만 눈을 뜹니다. 평소 대화나 코딩 요청에는 끼어들지 않아요. 자동 맞춤법 검사기보다는, 필요할 때 부르는 교정 선생님에 가깝습니다. 부르지 않으면 조용히 계십니다.

② 선생님을 부르는 데도 출장비가 듭니다. 평소에는 스킬 소개 문장 몇 줄만 올라가 있어서 부담이 거의 없습니다. 하지만 한 번 호출하면 본문 전체가 대화에 올라옵니다. 직접 받아 보니 본문 파일이 약 32KB였고, 토큰으로 어림하면 8천 개 안팎입니다(어림값입니다. 실측은 아니에요). 그래서 이 글 전체를 관통하는 규칙은 단순합니다.

큰 작업 앞에서만 부른다. 작은 수정에는 부르지 않는다.

빗나가면 수만 토큰이 날아가는 작업 앞에서 8천 토큰을 쓰는 건 남는 장사입니다. 오타 하나 고치자고 부르는 건… 동네 편의점 가는데 대리운전을 부르는 격이고요.

③ 만든 분은 사실 브라우저 설치를 더 권합니다. 저장소 안내문을 보면 claude.ai에 ZIP을 올리는 방식이 "권장", Claude Code 폴더에 직접 넣는 방식은 "권장하지 않음"이라고 적혀 있습니다. 이유는 따로 설명이 없습니다. 다만 Claude Code에서 제대로 호출되도록 고친 이력(v1.4.0)이 있고, 구조상으로도 문제 될 것이 없습니다. 숨길 이유가 없어서 말씀드립니다. 브라우저에서도 쓰고 싶으시면 부록 A를 보세요.

여기까지 읽고도 "그래도 한번 써 보고 싶은데?" 싶으시다면 잘 오셨습니다. 준비물 확인하고 바로 시작하죠.

4. 준비물

Claude Code (데스크톱 앱, 터미널, VS Code 확장 중 아무거나)
Pro 이상 요금제
끝입니다. 정말로요. git이 없어도 아래 프롬프트가 알아서 다른 길로 받아 옵니다.

5. 따라 하기

규칙은 하나입니다. 아래 회색 상자의 프롬프트를 그대로 복사해서 Claude Code 입력창에 붙여넣기. 중간에 Claude가 "이 명령을 실행해도 될까요?" 하고 물으면, 내용을 한번 읽어 보시고 허용해 주세요. 남의 집에 가구를 들이기 전에 초인종을 누르는 것이니 귀찮아하지 마시고요.

STEP 1. 혹시 이미 깔려 있진 않은지 (30초)

이사 가기 전에 집부터 둘러보는 단계입니다. 아무것도 건드리지 않고 구경만 시킵니다.

프롬프트

내 컴퓨터에 Claude Code용 스킬이 이미 설치되어 있는지 확인해줘.
사용자 폴더의 .claude/skills 와 지금 프로젝트의 .claude/skills 두 곳을 보고,
폴더가 있는지, 있다면 어떤 스킬이 들어 있는지 목록으로 알려줘.
아무것도 만들거나 지우지 말고 확인만 해줘.

실제로 해 보니 사용자 폴더 쪽은 "그런 폴더 없음"이 나왔고, 프로젝트 폴더에는 예전에 만들어 둔 스킬 하나가 들어 있었습니다. "없음"이 나와도 놀라지 마세요. 스킬을 한 번도 깔아 본 적 없다면 그게 정상입니다. 오히려 깨끗한 새집이라는 뜻이죠.

macOS / Linux / Git Bash

ls ~/.claude/skills
ls .claude/skills

Windows PowerShell

Get-ChildItem "$HOME\.claude\skills"
Get-ChildItem ".claude\skills"

No such file or directory 또는 "경로를 찾을 수 없습니다"가 나오면 아직 폴더가 없다는 뜻이고, 정상입니다.

</details>

집 구경은 끝났습니다. 빈집인 걸 확인했으니, 이제 가구를 들일 차례입니다.

STEP 2. 설치 (3분… 이라고 썼지만 실제로는 10초였습니다)

먼저 어디에 둘지만 정하겠습니다. 고민되시면 계정 전체를 고르세요.

위치	경로	이럴 때
계정 전체 (권장)	사용자 폴더의 `.claude/skills/`	어느 프로젝트에서든 부르고 싶을 때
이 프로젝트만	프로젝트의 `.claude/skills/`	특정 프로젝트에서만 쓰거나 팀과 공유할 때

프롬프트 (계정 전체 설치)

GitHub의 nidhinjs/prompt-master 스킬을 내 계정 전체에서 쓸 수 있게 설치해줘.

1. 사용자 폴더에 .claude/skills 폴더가 없으면 만들어줘.
2. 그 안에 prompt-master 라는 이름으로 저장소를 받아줘.
   git이 있으면 git clone, 없으면 ZIP을 내려받아 풀어줘.
   최종 경로는 반드시 .claude/skills/prompt-master/SKILL.md 가 되어야 해.
3. 같은 이름의 폴더가 이미 있으면 덮어쓰지 말고 멈춰서 나에게 물어봐.
4. 설치가 끝나면 폴더 안의 파일 목록을 보여주고,
   실행 파일이나 스크립트(.sh, .py, .js, .exe 등)가 섞여 있는지 알려줘.
5. SKILL.md 맨 위의 name, version, description 을 읽어서 한국어로 요약해줘.
다른 폴더나 설정 파일은 건드리지 마.

프로젝트에만 설치하려면 첫 줄을 "지금 프로젝트에서만 쓸 수 있게"로, 경로를 "현재 프로젝트의 .claude/skills"로 바꾸시면 됩니다.

프롬프트가 좀 길죠? 일부러 그랬습니다. 3번("덮어쓰지 말고 물어봐")과 4번("스크립트 섞여 있는지 알려줘")은 이 스킬뿐 아니라 앞으로 어떤 스킬을 깔든 그대로 재활용할 수 있는 안전벨트입니다. 한 번 복사해 두면 평생 씁니다.

실제로 해 보니 받는 데 몇 초 걸리지 않았습니다. 들어온 파일은 정확히 다섯 개였어요. LICENSE, README.md, SKILL.md, references/patterns.md, references/templates.md 실행 파일·스크립트는 0개, 버전은 1.8.0으로 확인됐습니다. 말 그대로 "글로 된 지침서" 묶음입니다. 전체 용량도 55KB 정도로, 사진 한 장보다 가볍습니다.

macOS / Linux / Git Bash

mkdir -p ~/.claude/skills
git clone https://github.com/nidhinjs/prompt-master.git ~/.claude/skills/prompt-master
ls ~/.claude/skills/prompt-master

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude\skills"
git clone https://github.com/nidhinjs/prompt-master.git "$HOME\.claude\skills\prompt-master"
Get-ChildItem "$HOME\.claude\skills\prompt-master"

git이 없을 때 (macOS / Linux / Git Bash)

mkdir -p ~/.claude/skills
curl -L -o /tmp/prompt-master.zip https://github.com/nidhinjs/prompt-master/archive/refs/heads/main.zip
unzip /tmp/prompt-master.zip -d ~/.claude/skills
mv ~/.claude/skills/prompt-master-main ~/.claude/skills/prompt-master

ZIP을 풀면 폴더 이름이 prompt-master-main으로 나옵니다. 마지막 줄처럼 prompt-master로 바꿔 주세요.

</details>

가구는 들어왔습니다. 그런데 여기에 이 글에서 거의 유일한 돌부리가 하나 놓여 있습니다. "어? 방금 깔았는데 왜 안 되지?" 하는 바로 그 지점입니다.

STEP 3. 새 세션에서 인사시키기 (1분) — 여기가 제일 많이 막히는 곳입니다

설치를 끝낸 바로 그 대화창에서 곧장 스킬을 불러 보면 어떻게 될까요?

실제로 해 보니 Unknown skill: prompt-master 방금 깔았는데 "그런 스킬 모릅니다"라는 답이 돌아옵니다. 입력창에 /prompt-master를 쳐 봐도 자동완성은 조용합니다. 고장이 아닙니다. 스킬 폴더 자체를 처음 만든 직후에는, 열려 있던 세션이 아직 그 폴더의 존재를 모릅니다. 새로 전학 온 친구를, 어제 찍은 반 단체사진에서 찾는 셈이죠. 재미있는 건 그다음입니다. 몇 분 뒤 같은 세션에서 다시 부르니 이번에는 멀쩡히 대답했습니다. 출석부가 뒤늦게 갱신된 겁니다. 즉 "영영 안 되는" 게 아니라 "바로는 안 되는" 것에 가깝습니다.

그래도 기다리며 눈치 보는 것보다 확실한 방법이 있습니다. Claude Code를 새로 열거나 새 세션을 시작한 다음, 아래를 붙여넣으세요.

프롬프트

지금 사용할 수 있는 스킬 목록에 prompt-master 가 있는지 확인해줘.
있으면 그 스킬이 어떤 요청에서 동작하는지 한 문장으로 알려주고,
없으면 .claude/skills/prompt-master/SKILL.md 파일이 실제로 있는지 확인해서 원인을 알려줘.

Claude가 "네, 목록에 있습니다"라고 답하고, 입력창에 /prompt-master를 쳤을 때 자동완성에 얼굴을 내밀면 성공입니다.

실제로 해 보니 새 세션을 열자 /prompt-master 자동완성이 바로 나타났습니다. 설치 직후 세션에서는 감감무소식이던 그 목록입니다. 한 가지 알아 두면 좋은 점: 자동완성이 뜨기 전인 설치 직후 세션에서도, 몇 분이 지나자 Claude 쪽에서는 이미 스킬을 알아보고 호출까지 됐습니다. 입력창의 자동완성은 편의 기능이고, 스킬을 실제로 알아보는 건 그 뒤의 Claude입니다. 메뉴판 인쇄가 늦었다고 주방에서 못 만드는 건 아니라는 얘기죠. 급하면 자동완성 없이 /prompt-master를 끝까지 치고 요청을 적어 보내거나, "프롬프트 마스터로 …"라고 말을 걸어도 됩니다.

ls ~/.claude/skills/prompt-master/SKILL.md

파일 경로가 출력되면 설치는 된 겁니다. 인식 여부는 Claude Code를 다시 실행한 뒤 입력창에서 /prompt-master로 확인하세요.

터미널에서 claude를 실행했는데 OAuth session expired가 나온다면, 터미널용 로그인이 만료된 것입니다. claude를 실행한 뒤 /login으로 다시 로그인하시면 됩니다. 데스크톱 앱 로그인과는 별개로 관리되니, 앱만 쓰시는 분은 신경 쓰지 않으셔도 됩니다. (이 글을 검증하는 중에도 실제로 나온 메시지입니다.)

</details>

인사까지 마쳤으니, 이제 이 친구가 밥값을 하는지 볼 차례입니다.

STEP 4. 첫 사용 — 시키기 전에, 지시문부터 만들게 하세요 (5분)

여기서부터가 본론입니다. 습관 하나만 바꾸시면 됩니다. 큰 작업을 바로 시키지 말고, 지시문을 먼저 만들게 하는 겁니다.

프롬프트

프롬프트 마스터로 Claude Code에게 시킬 작업 지시문을 만들어줘.

하고 싶은 일: <여기에 하고 싶은 일을 평소 말투로 한두 줄>

빠진 정보가 있으면 먼저 나에게 질문해줘.
완성된 지시문은 한국어로, 복사할 수 있는 블록 하나로 줘.

<하고 싶은 일> 자리에는 정말 평소 말투로 쓰셔도 됩니다. 예를 들어 이렇게요.

우리 가게 예약 페이지 만들고 싶어. 날짜랑 인원 고르면 되는 정도.

이 스킬은 요청을 받으면 속으로 아홉 가지(무슨 작업인지, 어느 도구인지, 결과물 형태, 제약, 완료 기준 등)를 점검하고, 빠진 게 치명적일 때만 되묻습니다. 질문은 최대 세 개로 못 박혀 있어서 스무고개가 되지는 않아요. 위 요청이라면 대략 이런 걸 묻습니다.

기존 프로젝트에 붙이나요, 빈 폴더에서 새로 만드나요? 쓰고 싶은 기술이 있나요?
예약 내용은 어디에 저장하나요? (일단 화면에만 보여 주면 되나요?)
무엇이 되면 "완성"인가요?

여기에 일부러 성의 없이 답해 봤습니다. "새 폴더, HTML/CSS/JS, 확인 문구만." 세 번째 질문에는 아예 답을 안 했고요. 그랬더니 아래 지시문이 돌아왔습니다.

## 목표
가게 예약 요청 페이지를 만든다. 손님이 날짜와 인원을 고르고 버튼을 누르면 확인 문구가 보이는 것까지가 전부다.

## 현재 상태
빈 새 폴더 ./reservation 에서 시작한다. 기존 코드, 프레임워크, 빌드 도구 없음.

## 완성 상태
./reservation 에 index.html, style.css, app.js 세 파일이 있고, index.html 을 브라우저에서 바로 열면 동작한다.
- 날짜 선택: 오늘 이전 날짜는 선택할 수 없다
- 인원 선택: 1명부터 8명까지
- [예약하기] 버튼을 누르면 같은 화면에 "O월 O일, O명 예약 요청이 접수되었습니다"가 표시된다
- 날짜나 인원을 고르지 않고 누르면 무엇이 빠졌는지 안내 문구가 표시된다

## 작업 범위
- 작업 위치: ./reservation 폴더 안
- 건드리지 말 것: ./reservation 밖의 모든 파일과 폴더

## 제약
- 순수 HTML, CSS, JavaScript 만 사용한다. 외부 라이브러리, CDN, npm 설치 없음
- 예약 내용은 저장하거나 전송하지 않는다. 화면에 확인 문구만 보여준다
- 요청한 것만 만든다. 로그인, 결제, 관리자 화면, 다크 모드 등 요청하지 않은 기능과 파일을 추가하지 않는다

## 완료 기준
- [ ] index.html 을 더블클릭해 열었을 때 오류 없이 화면이 보인다
- [ ] 오늘 이전 날짜가 선택되지 않는다
- [ ] 날짜와 인원을 고르고 버튼을 누르면 고른 값이 들어간 확인 문구가 보인다
- [ ] 화면 폭 360px 에서 가로 스크롤이 생기지 않는다

## 행동 경계
- 범위 안에서의 파일 생성, 수정, 확인은 묻지 않고 진행한다
- 파일 삭제, 의존성 추가, 범위를 넘는 작업이 필요해 보이면 멈추고 먼저 묻는다
- 같은 문제를 두 번 고쳐도 해결되지 않으면 멈추고 상황을 보고한다

## 진행 보고
완료를 알릴 때는 완료 기준 네 항목을 각각 어떻게 확인했는지 실제 확인 결과와 함께 적는다.

블록 아래에는 한 줄 요약이 따라붙습니다. "🎯 Target: Claude Code, 💡 한 줄 요청에 빠져 있던 범위·금지·완료 기준·멈춤 조건을 채워 첫 실행에서 끝나도록 했습니다." 그리고 실제로 파일을 건드리는 도구용 지시문에는, 붙여넣기 전에 범위와 금지 사항, 경로가 실제 프로젝트와 맞는지 확인하라는 영어 주의 문구가 한 문단 더 붙습니다. 친절한데 꼼꼼하기까지 합니다.

실제로 해 보니 위 지시문은 설치한 스킬을 실제로 호출해서 받은 출력입니다. 눈여겨볼 곳은 완료 기준입니다. 세 번째 질문("무엇이 되면 완성인가요?")에는 답을 하지 않았는데도, 스킬이 요청 내용에서 네 가지 합격 조건을 알아서 뽑아 넣었습니다. 360px 가로 스크롤이나 빈칸 안내 문구는 말한 적도 없는 항목이죠. 마음에 안 들면 이 단계에서 지우면 그만입니다. 작업이 끝난 뒤에 "이건 왜 넣었어요?" 하는 것보다 백 배 쌉니다.

입력은 "예약 페이지, 날짜랑 인원" 한 줄이었는데, 돌아온 건 행동 경계까지 달린 작업 지시서입니다. 특히 "두 번 고쳐도 안 되면 멈춘다"는 저 멈춤 조건이 백미예요. 스킬 본문은 "끝없이 도는 반복이 크레딧을 가장 많이 태운다"고 보고, Claude Code용 지시문에는 이 항목을 의무로 넣게 되어 있습니다. 한도 관리 관점에서는 이 한 줄이 제일 비싼 보험입니다.

자, 지시문을 읽어 보세요. 마음에 들면 이렇게 이어 갑니다.

좋아. 방금 만든 지시문 그대로 작업을 시작해줘.

여기가 절약 지점입니다. 지시문을 읽는 30초 동안 "아, 인원은 12명까지 받아야 하는데" 같은 걸 발견하면, 작업이 다 끝난 뒤가 아니라 시작하기 전에 고칠 수 있습니다. 집을 다 짓고 나서 "방이 하나 더 필요했는데요"라고 하는 것과 설계도에서 고치는 것, 어느 쪽이 싼지는 말씀 안 드려도 아시죠.

Claude Code한테 시키는 법은 이 정도면 됐습니다. 그런데 이 스킬의 진짜 주특기는 따로 있어요. 남의 집 살림에 훈수 두기입니다.

STEP 5. 다른 AI 도구용 프롬프트 만들기 — 이 친구의 주특기

Midjourney는 쉼표로 끊은 묘사를 좋아하고, 영상 AI는 카메라 움직임을 따로 챙겨 줘야 하고, Cursor는 파일 경로를 짚어 줘야 말을 듣습니다. 도구마다 "잘 통하는 말투"가 다른데, 그걸 다 외우고 다닐 수는 없잖아요. 이 스킬은 그 사투리를 대신 구사해 줍니다.

프롬프트 마스터로 <도구 이름>에 넣을 프롬프트를 만들어줘.
만들고 싶은 것: <결과물을 평소 말투로 설명>

<도구 이름>을 빼먹으셔도 괜찮습니다. 스킬 쪽에서 먼저 물어봅니다. 어느 도구에 넣을지 모르는 채로는 프롬프트를 내놓지 않는 것이 이 스킬의 철칙이거든요. 고집이 좀 있는 편입니다.

새 프롬프트를 만드는 건 알겠고, 그럼 이미 써 보고 실망한 프롬프트는요? 버리지 마세요. 고쳐 씁니다.

STEP 6. 빗나간 프롬프트, 버리지 말고 진단받기

아래는 내가 <도구 이름>에 썼다가 결과가 빗나간 프롬프트야.
프롬프트 마스터로 무엇이 문제였는지 짚어주고, 고친 버전을 하나만 줘.

[원래 프롬프트]
<여기에 붙여넣기>

[기대한 결과와 실제 결과의 차이]
<한두 줄>

스킬 안에는 크레딧을 낭비하게 만드는 흔한 실수 유형 37가지가 정리되어 있고, 이 요청을 받으면 그 목록에 비춰 점검합니다. 남이 빨간 펜으로 그어 준 걸 몇 번 보다 보면, 어느 순간 스킬 없이도 내 프롬프트가 달라져 있습니다. 사실 이게 이 스킬의 숨은 효능이에요.

이제 마지막 기술입니다. 한도 관리라는 이 글의 주제에 가장 직접 닿아 있는 대목이기도 합니다.

STEP 7. 긴 세션을 새 세션으로 이사시키기 (한도 관리의 핵심)

대화가 길어질수록 Claude는 매 요청마다 지금까지의 맥락을 통째로 짊어지고 움직입니다. 배낭이 무거워질수록 한 걸음의 값이 비싸지는 거죠. 그래서 어느 정도 진행됐으면 새 세션으로 옮기는 게 이득인데, 다들 망설입니다. 이유는 하나예요. "지금까지 정한 걸 또 설명해야 하잖아."

그 설명, 시키세요.

지금 세션에서

이 대화를 새 세션에서 이어가려고 해.
프롬프트 마스터로, 지금까지 우리가 정한 결정 사항(기술 선택, 이름 규칙,
하지 않기로 한 것, 현재 진행 상태, 다음에 할 일)을 담은 인수인계 프롬프트를 만들어줘.
비밀번호나 API 키 같은 값은 절대 넣지 마.

스킬은 이전 결정들을 "이어받을 맥락" 묶음으로 정리해서 프롬프트 앞쪽에 배치합니다. 앞쪽에 두는 데는 이유가 있습니다. 모델이 긴 글의 뒷부분으로 갈수록 집중력이 흐려지니, 절대 잊으면 안 되는 건 첫머리에 두라는 것이 이 스킬의 설계 원칙입니다.

나온 블록을 복사해서 새 세션(/clear 또는 새 창)에 붙여넣으면, 앞에서 정한 걸 뒤집지 않고 작업이 이어집니다. 이삿짐은 가볍게, 등기부등본만 챙겨 가는 겁니다.

여기까지가 "쓰는 법"이었습니다. 그런데 쓰다 보면 슬슬 욕심이 납니다. "매번 '한국어로'라고 붙이기 귀찮은데?" 네, 고칠 수 있습니다.

6. 내 입맛에 맞게 길들이기 (선택)

내려받은 스킬의 정체는 결국 글로 된 지침서입니다. 글이니까 고칠 수 있죠. 다만 원본을 직접 뜯어고치면 나중에 업데이트를 받을 때 충돌이 납니다. 전셋집 벽에 못을 박기 전에는 한 번 더 생각하는 게 좋습니다. 그래서 순서를 이렇게 권해 드립니다.

방법 A. 원본은 그대로, 내 규칙은 CLAUDE.md에 (권장)

벽에 못을 박는 대신 스탠드 조명을 들이는 방법입니다. 원본은 멀쩡하고, 업데이트도 편합니다.

내 사용자 폴더의 .claude/CLAUDE.md 파일 맨 아래에 아래 규칙을 추가해줘.
파일이 없으면 새로 만들고, 기존 내용은 그대로 둬.

## prompt-master 사용 규칙
- prompt-master 스킬로 만든 프롬프트는 대상 도구가 영어를 요구하지 않는 한 한국어로 작성한다.
- 되묻는 질문도 한국어로 한다.
- Claude Code용 지시문에는 항상 "건드리면 안 되는 파일"과 "완료 기준" 항목을 포함한다.

규칙 세 줄은 예시일 뿐입니다. 본인이 입버릇처럼 되풀이하는 요구가 있다면 그걸 적으세요. "우리 팀은 주석을 영어로 단다"든, "결과는 항상 표로 달라"든요.

방법 B. 한국어로 불러도 잘 깨어나게 하기

스킬이 언제 눈을 뜰지는 SKILL.md 맨 위 description 문장이 결정합니다. 원본은 영어로만 적혀 있어서, 한국어 표현을 한 줄 보태 주면 더 안정적으로 반응합니다. 이건 벽에 못 하나 정도 박는 일이니, 백업부터 하고 갑니다.

.claude/skills/prompt-master/SKILL.md 를 수정하려고 해.
1. 먼저 같은 폴더에 SKILL.md.bak 으로 백업을 만들어줘.
2. 맨 위 description 문장 끝에 아래 한 문장만 덧붙여줘. 다른 곳은 건드리지 마.
   Also activates on Korean requests such as "프롬프트 써줘", "프롬프트 고쳐줘", "프롬프트 마스터로".
3. 수정 전후의 description 을 나란히 보여줘.

고칠 때 지킬 것 네 가지

---로 둘러싸인 머리말의 name은 바꾸지 마세요. 폴더 이름과 한 쌍입니다.
description은 짧게 유지하세요. 이 문장은 평소에도 늘 대화에 올라가 있는 부분이라, 길어지면 그만큼 상시 비용이 늘어납니다.
본문의 규칙 구간(금지 기법, 출력 형식)은 이 스킬의 심장입니다. 바꾸고 싶은 동작이 있다면 방법 A로 해결하시는 편이 낫습니다.
방법 B를 쓴 뒤 업데이트를 받으면 수정이 덮이거나 충돌할 수 있습니다. 백업 파일을 남겨 두는 이유가 그것입니다.

cp ~/.claude/skills/prompt-master/SKILL.md ~/.claude/skills/prompt-master/SKILL.md.bak

그다음 편집기로 SKILL.md를 열어 description: 줄 끝에 문장을 덧붙이고 저장합니다.

</details>

길들이기까지 마쳤습니다. 그럼 이제 제일 현실적인 질문이 남죠. "그래서 언제 부르고, 언제 참아야 하나요?"

7. 부를 때와 참을 때 — 한도를 실제로 아끼는 규칙

앞에서 "출장비" 얘기를 드렸습니다. 출장비가 있는 선생님은 아무 때나 부르는 게 아니죠.

상황	부를까요?	이유
여러 파일을 만들거나 고치는 작업	✅ 부릅니다	빗나가면 손실이 큽니다
처음 해 보는 종류의 작업	✅ 부릅니다	내가 뭘 빠뜨렸는지조차 모르는 상태니까요
다른 AI 도구용 프롬프트	✅ 부릅니다	이 친구의 주특기입니다
세션을 새로 시작하기 직전	✅ 부릅니다	인수인계 프롬프트로 재설명 비용이 사라집니다
오타 수정, 변수명 변경 같은 한 줄 작업	❌ 참습니다	출장비가 수리비보다 비쌉니다
이미 요청을 구체적으로 적은 경우	❌ 참습니다	보탤 게 없습니다
같은 세션에서 연달아 여러 번	⚠️ 가끔만	한 번 올라온 본문은 대화에 남아 있습니다. "같은 방식으로 하나 더"면 충분해요

그리고 스킬 없이도 오늘부터 쓸 수 있는 비법을 하나 드립니다. 요청에 대상(어느 파일), 금지(건드리지 말 것), 완료 기준(뭐가 되면 끝) 세 가지만 적으세요. 이것만으로도 재시도의 상당수가 사라집니다. Prompt Master는 결국 이 습관을 대신 챙겨 주는 꼼꼼한 비서이고, 비서를 옆에 두다 보면 어느새 그 꼼꼼함이 옮습니다.

8. 업데이트와 삭제 — 들일 줄 알았으면 뺄 줄도 알아야죠

업데이트 프롬프트

.claude/skills/prompt-master 스킬을 최신 버전으로 업데이트해줘.
업데이트 전에 현재 version 을 알려주고, 내가 SKILL.md 를 수정한 흔적이 있으면
덮어쓰기 전에 멈춰서 나에게 물어봐. 끝나면 새 version 을 알려줘.

삭제 프롬프트

.claude/skills/prompt-master 폴더를 삭제하려고 해.
삭제하기 전에 폴더 경로와 안에 든 파일 목록을 보여주고, 내가 확인하면 그 폴더만 지워줘.

써 보고 "나는 3점짜리 사용자였구나" 싶으시면 미련 없이 지우셔도 됩니다. 폴더 하나 지우면 흔적도 남지 않아요.

업데이트 (git으로 설치한 경우)

git -C ~/.claude/skills/prompt-master pull

삭제 (macOS / Linux / Git Bash)

rm -rf ~/.claude/skills/prompt-master

삭제 (Windows PowerShell)

Remove-Item -Recurse -Force "$HOME\.claude\skills\prompt-master"

ZIP으로 설치하셨다면 업데이트는 폴더를 지우고 STEP 2를 다시 하는 방식입니다.

</details>

9. 자주 막히는 곳

Q. 설치했는데 /prompt-master 자동완성이 안 보여요. 먼저 안심부터 하세요. 자동완성이 안 보이는 것과 스킬이 안 깔린 것은 다른 문제입니다. STEP 3의 프롬프트로 Claude에게 직접 물어보세요. "목록에 있다"고 하면 설치는 성공이고, 자동완성 없이 /prompt-master 요청 내용을 그대로 보내거나 "프롬프트 마스터로 …"라고 부르면 됩니다. Claude도 "목록에 없다"고 한다면 그때는 셋 중 하나입니다. ① 설치 직후라 아직 반영이 안 됐다(새 세션을 여세요). ② 세션을 시작하기 전의 빈 입력창이다(첫 메시지를 보내 세션이 시작된 뒤에 확인하세요). ③ 폴더가 한 겹 더 들어가 있다(prompt-master/prompt-master-main/SKILL.md). SKILL.md는 반드시 prompt-master 폴더 바로 아래에 있어야 합니다.

Q. "프롬프트 써줘"라고 했는데 스킬 없이 그냥 답해요. "프롬프트 마스터로"라고 이름을 불러 주시거나 /prompt-master로 직접 호출하세요. 한국어 요청에 더 잘 반응하게 하려면 6장의 방법 B가 답입니다.

Q. 결과 프롬프트가 영어로 나와요. 이미지·영상 AI처럼 영어가 유리한 도구라면 영어로 주는 게 정상입니다. 그 외에는 요청에 "한국어로"를 붙이시거나, 6장의 방법 A로 기본값을 정해 두세요.

Q. 질문이 귀찮아요. 그냥 바로 만들어 주면 안 되나요? 됩니다. "질문 없이 네가 합리적으로 가정해서 만들고, 가정한 내용은 끝에 한 줄로 알려줘"를 덧붙이세요. 다만 그 질문 세 개가 재시도를 막아 주는 장치라는 점만은 기억해 주시고요.

Q. 터미널에서 claude를 쳤더니 OAuth session expired가 떠요. 터미널용 로그인이 만료된 겁니다. claude 실행 후 /login 하시면 됩니다. 데스크톱 앱과는 로그인이 따로라서, 앱에서 잘 되던 분도 터미널에서는 이 메시지를 만날 수 있습니다.

Q. 남이 만든 스킬, 깔아도 안전한가요? 좋은 질문입니다. 스킬은 Claude가 따르는 지침서라서 출처 확인은 꼭 필요합니다. 이 스킬은 공개 저장소에 글 파일 다섯 개로만 이루어져 있고, 직접 확인한 결과 실행 파일은 0개였습니다. STEP 2의 프롬프트가 설치 직후 이 점검을 하도록 짜여 있으니, 다른 스킬을 들이실 때도 그 문장을 꼭 데려가세요.

10. 마무리 체크리스트

STEP 1: 기존 스킬 폴더 상태를 확인했다
STEP 2: .claude/skills/prompt-master/SKILL.md 경로로 설치했다
STEP 2: 실행 파일·스크립트가 0개인 것을 확인했다
STEP 3: 새 세션에서 Claude가 "prompt-master가 목록에 있다"고 답한다 (자동완성은 안 떠도 괜찮습니다)
STEP 4: 큰 작업 하나를 "지시문 먼저" 방식으로 해 봤다
STEP 7: 인수인계 프롬프트로 새 세션에 이사해 봤다
(선택) 6장: 한국어 기본값 규칙을 추가했다

숙제는 하나만 드리겠습니다. 이번 주에 큰 작업 딱 하나만 "지시문 먼저" 방식으로 해 보세요. 끝나고 나서 "아니, 그게 아니라…"를 한 번도 말하지 않았다면, 축하드립니다. 이 스킬은 당신에게 8점짜리입니다.

부록 A. 브라우저(claude.ai)에서도 쓰고 싶다면

저장소 페이지에서 Code → Download ZIP으로 받습니다. (https://github.com/nidhinjs/prompt-master)
claude.ai → 사이드바 → Customize → Skills → 스킬 업로드에서 받은 ZIP을 그대로 올립니다.
새 대화에서 "프롬프트 마스터로 …"라고 요청합니다.

ZIP은 풀었다가 다시 압축하지 마세요. 압축 구조가 바뀌면 업로드가 거부될 수 있습니다. 그리고 스킬 기능을 쓰려면 설정에서 코드 실행 및 파일 생성 기능이 켜져 있어야 합니다.

부록 B. 참고

스킬 저장소: https://github.com/nidhinjs/prompt-master (MIT, 확인 시점 v1.8.0)

한도를 아끼는 Prompt Master 스킬 사용법 — 직접 써 보고 내린 결론 (터미널 몰라도 됩니다)

1. 혹시 오늘도 "아니, 그게 아니라…"로 시작하셨나요

2. 결론부터: 필수는 아닙니다. 그런데 어떤 분에게는 꽤 쏠쏠합니다

3. 깔기 전에 풀고 가는 오해 세 가지

4. 준비물

5. 따라 하기

STEP 1. 혹시 이미 깔려 있진 않은지 (30초)

STEP 2. 설치 (3분… 이라고 썼지만 실제로는 10초였습니다)

STEP 3. 새 세션에서 인사시키기 (1분) — 여기가 제일 많이 막히는 곳입니다

STEP 4. 첫 사용 — 시키기 전에, 지시문부터 만들게 하세요 (5분)

STEP 5. 다른 AI 도구용 프롬프트 만들기 — 이 친구의 주특기

STEP 6. 빗나간 프롬프트, 버리지 말고 진단받기

STEP 7. 긴 세션을 새 세션으로 이사시키기 (한도 관리의 핵심)

6. 내 입맛에 맞게 길들이기 (선택)

방법 A. 원본은 그대로, 내 규칙은 CLAUDE.md에 (권장)

방법 B. 한국어로 불러도 잘 깨어나게 하기

7. 부를 때와 참을 때 — 한도를 실제로 아끼는 규칙

8. 업데이트와 삭제 — 들일 줄 알았으면 뺄 줄도 알아야죠

9. 자주 막히는 곳

10. 마무리 체크리스트

부록 A. 브라우저(claude.ai)에서도 쓰고 싶다면

부록 B. 참고

댓글