터미널 없이 클로드 스킬 만드는 법 — 왕초보 완전 가이드

결론부터 말씀드릴게요. 스킬을 만드는 데 코딩도, 터미널도 필요 없습니다. 스킬의 본체는 코드가 아니라 한국어로 쓴 지시문이고, 그 지시문조차 클로드에게 만들어 달라고 하면 됩니다. 사람이 할 일은 딱 하나, 매번 똑같이 시키는 일이 뭔지 알아차리는 것입니다.

이 글은 스킬을 한 번도 안 만들어본 분을 기준으로 씁니다. 파일이 뭔지, 어디에 올리는지, 뭘 적어야 하는지, 그리고 처음 만들 때 거의 다 겪는 실수까지 순서대로 다룹니다.

01 스킬이 정확히 뭔가요

왜 프롬프트를 저장해두는 것과 다른가요

메모장에 프롬프트를 모아두고 필요할 때 복붙하는 분들이 많습니다. 그것도 방법이지만 두 가지가 아쉽습니다. 매번 찾아서 붙여야 하고, 붙이는 걸 잊으면 결과가 달라집니다.

스킬은 그 복붙을 클로드가 알아서 하게 만듭니다. "인스타 캡션 써줘"라고만 해도 클로드가 내가 만들어둔 캡션 규칙을 스스로 꺼내옵니다. 내가 기억하지 않아도 되는 것이 핵심 차이입니다.

클로드는 스킬을 어떻게 꺼내 쓰나요

이 구조를 이해하면 뒤에 나오는 모든 조언이 왜 그런지 자동으로 이해됩니다.

스킬이 10개 있어도 클로드가 처음부터 10개를 전부 읽는 게 아닙니다. 이름과 설명 두 줄씩만 훑어보고, 지금 요청에 맞는 게 있으면 그때 그 스킬의 본문을 펼쳐 봅니다.

스킬 파일은 어떻게 생겼나요

SKILL.md라는 파일 하나가 최소 구성입니다. 확장자 .md 때문에 어려워 보이는데, 사실 그냥 글자만 들어 있는 메모장 파일입니다. 워드 파일처럼 특별한 프로그램이 필요하지 않습니다.

윗부분과 아랫부분, 딱 두 덩어리입니다. 윗부분은 클로드가 이 스킬을 언제 쓸지 판단하는 곳이고, 아랫부분은 실제로 어떻게 일할지 적는 곳입니다.

02 스킬 vs 프로젝트 vs 스타일

이 셋이 헷갈려서 시작을 못 하는 분이 많습니다. 한 줄로 정리하면 이렇습니다.

• 프로젝트 — 그 대화 묶음에서 항상 켜져 있는 배경 정보. 우리 회사 소개, 제품 자료 같은 것
• 스타일 — 말투와 문체. 내용이 아니라 표현 방식만 바꿈
• 스킬 — 필요할 때만 자동으로 불려 나오는 작업 절차서

차이를 만드는 건 "항상"과 "필요할 때만"입니다. 프로젝트에 넣은 내용은 그 프로젝트의 모든 대화에 계속 붙어 다니고, 스킬은 관련 있는 요청에서만 등장합니다.

표가 잘리면 좌우로 밀어서 보세요

셋은 경쟁 관계가 아닙니다. 자료는 프로젝트에 넣고, 그 자료를 다루는 방법을 스킬로 만드는 조합이 제일 잘 굴러갑니다.

03 시작하기 전 확인할 것

스킬은 크게 두 종류입니다. 이걸 구분해야 헛수고를 안 합니다.

• 기본 제공 스킬 — 문서, 슬라이드, 엑셀 같은 걸 만들 때 이미 백그라운드에서 알아서 작동합니다. 설정할 게 없습니다
• 커스텀 스킬 — 내가 만들어 올리는 스킬. 이 글에서 다루는 게 이쪽입니다

스킬은 무료 플랜에서도 쓸 수 있습니다. Free, Pro, Max, Team, Enterprise 전 플랜에서 예시 스킬을 켜고 직접 만든 스킬을 올릴 수 있습니다. 조건은 플랜이 아니라 코드 실행 기능이 켜져 있는가 하나입니다.

화면은 두 곳으로 나뉩니다. 헷갈리기 쉬우니 순서대로 보세요.

• 설정 › 기능(Settings › Capabilities) — 여기서 "코드 실행 및 파일 생성"을 켭니다. 딱 한 번만 하면 되는 준비 작업입니다
• 맞춤설정 › 스킬(Customize › Skills) — 여기가 진짜 스킬 화면입니다. 켜고 끄고, 새로 올리고, 지웁니다

클로드 웹에서도 되고 데스크톱 앱에서도 됩니다. 터미널은 등장하지 않습니다.

참고로 뒤에 나올 플러그인은 유료 플랜 전용입니다. 스킬과 조건이 다르니 구분해두세요.

04 깃허브에서 좋은 스킬 찾아 쓰기

직접 만들기 전에 알아둘 게 있습니다. 이미 잘 만들어진 스킬이 아주 많습니다. 남의 스킬을 하나 깔아서 써보면 스킬이 뭔지 몸으로 이해되기 때문에, 순서상 이쪽이 먼저입니다.

먼저: 스킬과 플러그인은 다릅니다

찾다 보면 스킬이라고도 하고 플러그인이라고도 해서 헷갈립니다. 관계는 간단합니다.

스킬은 낱개고, 플러그인은 그 낱개들을 담은 상자입니다. 그래서 남의 것을 가져올 때는 대부분 플러그인 단위로 설치하게 되고, 설치하면 그 안의 스킬들이 한꺼번에 들어옵니다.

어디서 찾나요

출처는 크게 세 갈래입니다. 위쪽일수록 안전하고 쉽습니다.

• 앤트로픽 공식 카탈로그 — 앱 안에서 바로 둘러보고 설치할 수 있습니다. 웹 카탈로그는 claude.com/plugins 입니다. 처음이라면 여기서만 골라도 충분합니다
• 깃허브 공개 저장소 — anthropics/skills 저장소에 문서·디자인 관련 예시 스킬이 공개되어 있습니다. 깃허브에서 SKILL.md로 검색하거나, awesome-claude-skills 같은 정리 저장소를 보는 방법도 있습니다
• 개인·커뮤니티 마켓플레이스 — 만든 사람이 자기 저장소를 마켓플레이스로 열어둔 경우입니다. 주소를 직접 추가해서 씁니다. 종류가 가장 많지만 검증은 본인 몫입니다

좋은 스킬인지 어떻게 판단하나요

깃허브가 익숙하지 않아도 다섯 가지만 보면 대충 걸러집니다.

1. 별(★) 개수와 최근 업데이트 날짜를 봅니다. 저장소 상단에 있습니다. 1년 넘게 안 건드린 스킬은 지금 클로드와 안 맞을 수 있습니다
2. SKILL.md를 직접 열어봅니다. 어차피 사람이 읽는 글이라 코드를 몰라도 읽힙니다. 무슨 일을 어떻게 시키는지 이해가 안 되면 안 쓰는 게 맞습니다
3. 스크립트가 들어 있는지 확인합니다. scripts 폴더가 있으면 실제로 코드가 실행됩니다. 이건 뒤의 안전 항목에서 다시 다룹니다
4. 설명이 구체적인지 봅니다. 설명이 두루뭉술한 스킬은 만든 사람도 대충 만든 겁니다. 앞에서 본 그 기준이 그대로 적용됩니다
5. 내 일과 실제로 맞는지 봅니다. 개발용 스킬이 압도적으로 많아서, 유명하다고 다 나에게 쓸모 있는 건 아닙니다

설치하는 법 — 앱에서 (터미널 없음)

클로드 웹, 데스크톱 앱의 채팅 탭, 코워크에서 플러그인을 설치해 쓸 수 있습니다.

1. 왼쪽 사이드바에서 맞춤설정(Customize)을 엽니다. 코워크에서 쓸 거라면 Cowork 탭을 먼저 연 뒤 여기로 들어갑니다
2. 위쪽 플러그인(Plugins) 탭을 누릅니다
3. Browse plugins를 눌러 목록을 봅니다. 기본으로 앤트로픽 공식 카탈로그가 열립니다
4. 원하는 항목의 Install을 누릅니다
5. 설치한 플러그인을 열어보면 그 안에 어떤 스킬이 들어 있는지 보이고, 하나씩 켜고 끌 수 있습니다

직접 만든 플러그인 파일도 이 화면에서 올릴 수 있습니다. 다만 내가 만든 스킬 하나를 올리는 곳은 여기가 아니라 맞춤설정 › 스킬입니다. 앞 장에서 본 그 화면이 맞습니다.

설치하는 법 — 클로드 코드에서

터미널을 쓰신다면 한 줄입니다.

/plugin install 플러그인이름@claude-plugins-official

/plugin만 치면 관리 화면이 열려서 둘러보기, 설치 목록, 켜고 끄기를 할 수 있습니다. 공식이 아닌 저장소에서 가져올 때는 마켓플레이스를 먼저 등록합니다.

/plugin marketplace add 계정명/저장소명
/plugin install 플러그인이름@마켓플레이스이름

처음 깔아볼 만한 것 하나

뭘 깔지 모르겠다면 superpowers가 무난합니다. 공식 카탈로그에 올라와 있고, 생태계에서 가장 많이 쓰이는 축입니다.

이게 하는 일은 클로드가 답부터 내놓지 않게 만드는 겁니다. 브레인스토밍으로 방향을 먼저 잡고, 계획을 세우고, 만든 뒤 스스로 점검하는 순서를 지키게 합니다. 코딩용으로 만들어졌지만 기획이나 글쓰기에도 그대로 씁니다.

다만 이런 스킬은 답이 느려집니다. 계획을 세우고 검토하느라 단계가 늘어나니까요. 간단한 일에는 "이건 빠르게 그냥 해줘"라고 덧붙이면 해당 절차를 건너뜁니다.

안전하게 쓰는 법

스킬은 결국 클로드에게 주는 지시문이고, 어떤 스킬은 실행되는 코드까지 들고 있습니다. 남이 만든 걸 그대로 켜는 건 남이 준 프로그램을 실행하는 것과 비슷합니다.

• 설치 전에 SKILL.md를 한 번 읽습니다. 한국어든 영어든 사람이 읽는 글입니다
• scripts 폴더가 있으면 그 안에 뭐가 있는지 봅니다. 뭘 하는지 모르겠으면 클로드에게 이 스크립트가 무슨 일을 하는지 설명해 달라고 하세요
• API 키나 계정 정보를 요구하는 스킬은 특히 주의합니다. 어디로 보내는지 확인되지 않으면 쓰지 않습니다
• 기업에서 쓴다면 엔터프라이즈 플랜의 스킬 검사 기능을 켜두면 설치·업데이트 시점에 악성 여부를 확인해 줍니다

가져왔으면 내 것으로 고치세요

남의 스킬을 그대로 쓸 필요는 없습니다. 설치한 스킬의 SKILL.md를 클로드에게 보여주고 이렇게 요청하세요.

빈 화면에서 시작하는 것보다 훨씬 빠르고, 잘 만든 스킬의 구조를 그대로 배울 수 있습니다. 다음 장에서 직접 만들 때도 이 구조가 기준이 됩니다.

플러그인 목록이 안 보인다면

플러그인은 유료 플랜(Pro, Max, Team, Enterprise) 전용입니다. 무료 계정에서는 설치할 수 없습니다.

05 반복 업무를 스킬로 바꾸는 3단계

여기가 이 글의 핵심입니다. 빈 파일을 열어놓고 "뭘 적지" 고민하면 백이면 백 막힙니다. 순서를 거꾸로 가야 합니다.

1단계 — 매번 똑같이 시키는 일 하나 고르기

후보를 찾는 질문은 이겁니다. 클로드에게 설명하면서 "아 이거 저번에도 말했는데" 싶었던 적이 있나요? 그 지점이 전부 스킬 후보입니다.

흔한 예시들입니다.

• 인스타 카드뉴스를 올릴 때마다 같은 톤의 캡션을 뽑는 일
• 블로그 글을 쓸 때마다 제목 규칙, FAQ 위치, 마무리 형식을 다시 알려주는 일
• 고객 문의에 답할 때마다 우리 회사 톤을 설명하는 일
• 회의록을 받아서 정해진 양식으로 정리하는 일

2단계 — 대화로 한 번 제대로 만들어보기

바로 스킬을 만들지 말고, 그 일을 평소처럼 클로드와 대화하며 처리합니다. 결과가 마음에 들 때까지 고쳐 달라고 하세요.

이 단계가 왜 필요하냐면, 내가 뭘 원하는지는 결과를 보기 전까지 나도 모르기 때문입니다. 고쳐 달라고 말하는 과정에서 내 기준이 저절로 말로 튀어나옵니다. "좀 더 짧게", "존댓말로", "해시태그는 빼고" 같은 것들이요. 그게 곧 스킬에 들어갈 내용입니다.

3단계 — 클로드에게 스킬로 만들어 달라고 하기

결과가 만족스러워지면 같은 대화 안에서 이렇게 요청하세요.

클로드는 스킬 형식을 이미 알고 있어서, 별도 설정 없이도 이름과 설명이 들어간 파일을 만들어 줍니다. 여기서 한 번 더 다듬으세요.

이 한 마디로 분량이 절반 이하로 줄어드는 경우가 많습니다. 짧을수록 좋은 스킬입니다.

업로드하고 테스트하기

여기서 왕초보가 반드시 한 번 막힙니다. SKILL.md 파일을 그대로 올리는 게 아니라, 폴더째 압축한 ZIP 파일을 올립니다.

1. 폴더를 하나 만듭니다. 폴더 이름은 스킬 이름과 똑같이 짓습니다. 예를 들어 스킬 이름이 writing-instagram-caption이면 폴더 이름도 그렇게 합니다
2. 그 폴더 안에 SKILL.md를 넣습니다. 참고 파일이 있다면 같이 넣습니다
3. 폴더를 압축합니다. 맥은 폴더 우클릭 › 압축, 윈도우는 우클릭 › 보내기 › 압축 파일
4. 맞춤설정 › 스킬로 가서 "+" 버튼 › 스킬 만들기 › 스킬 업로드를 고르고 ZIP 파일을 올립니다
5. 목록에 뜨면 토글을 켭니다

업로드가 실패한다면 대부분 폴더 이름과 스킬 이름이 다르거나, ZIP 안에 SKILL.md가 없거나, 이름·설명에 쓸 수 없는 문자가 들어간 경우입니다.

올린 뒤에는 새 대화를 열어 실제 요청으로 시험해보세요. 만들던 대화에서 그대로 테스트하면 앞 내용이 남아 있어서 스킬이 작동한 건지 알 수 없습니다.

잘 불려 나오는지, 결과가 원하는 형식으로 나오는지 두 가지만 보면 됩니다. 안 되면 다음 장을 보세요.

06 초보자가 하는 실수 7가지

처음 만든 스킬이 작동하지 않는다면 거의 이 안에 있습니다. 앞의 세 개가 특히 많습니다.

07 스킬이 안 불려 나올 때

제일 흔한 증상입니다. 순서대로 확인하세요.

1. 설정에서 켜져 있는지 확인합니다. 올렸어도 꺼져 있으면 작동하지 않습니다
2. 새 대화에서 테스트합니다. 기존 대화에는 이전 맥락이 남아 있습니다
3. 설명에 내가 실제로 쓰는 말이 들어 있는지 봅니다. 캡션이라고 말하는데 설명에는 문구 작성이라고 적혀 있으면 안 잡힐 수 있습니다
4. 스킬 이름을 직접 불러 봅니다. 이름을 대고 시켰을 때는 되는데 그냥 시키면 안 된다면, 문제는 본문이 아니라 설명입니다
5. 설명을 고칩니다. 무엇을 하는지 + 언제 쓰는지 + 사용자가 칠 법한 단어. 이 셋을 넣으세요

08 더 잘 만들고 싶다면

결과물 예시를 하나 넣으세요

형식을 말로 설명하는 것보다 완성본 예시 하나를 넣는 게 훨씬 정확합니다. 원하는 결과가 나왔던 실제 캡션이나 문서를 그대로 스킬 안에 붙여넣고 "이런 형식으로"라고 적으세요.

길어지면 파일을 나누세요

본문이 길어지면 상세 규칙을 별도 파일로 빼고 SKILL.md에는 "자세한 톤 규칙은 tone.md 참고"처럼 안내만 남깁니다. 클로드는 그 파일이 진짜 필요할 때만 열어봅니다.

단, 참조는 한 단계까지만 하세요. A가 B를 부르고 B가 다시 C를 부르는 구조는 클로드가 끝까지 따라가지 못하는 경우가 있습니다.

한 번에 완성하려 하지 마세요

가장 좋은 방법은 실제로 쓰면서 고치는 겁니다. 결과가 마음에 안 들 때마다 그 항목을 한 줄씩 추가하세요. 세 번쯤 쓰고 나면 스킬이 제 모양을 갖춥니다.

바로 쓰는 시작 템플릿

빈 화면이 막막하다면 이걸 복사해서 클로드에게 주세요.

정리

• 스킬은 코드가 아니라 한국어 지시문. 터미널 없이 맞춤설정 › 스킬에서 올린다
• 스킬은 무료 플랜에서도 된다. 플러그인만 유료 전용
• 올릴 때는 SKILL.md가 아니라 폴더를 ZIP으로 압축해서 올린다
• 클로드는 이름과 설명만 먼저 보고 스킬을 고른다. 설명이 곧 스위치
• 빈 파일부터 쓰지 말고, 대화로 한 번 잘 만든 뒤 그걸 스킬로 굳힌다
• 스킬 하나에 일 하나. 만능 스킬은 어떤 요청에도 애매하게 걸린다
• 클로드가 이미 아는 건 빼고, 내 기준과 출력 형식만 남긴다
• 직접 만들기 전에 공식 카탈로그에서 하나 깔아보면 감이 빨리 잡힌다
• 남의 스킬은 SKILL.md와 scripts 폴더를 열어보고 켠다
• 테스트는 반드시 새 대화에서
• 한 번에 완성하려 하지 말고 쓰면서 한 줄씩 늘린다

스킬을 만든다는 건 결국 내가 일하는 방식을 말로 정리하는 일입니다. 그래서 코딩보다 업무 이해가 중요하고, 그 점에서 비개발자가 오히려 유리합니다. 자기 일을 제일 잘 아는 사람이 만든 스킬이 제일 잘 작동합니다.

자주 묻는 질문