✔ 클로드 스킬 — Pro 플랜 이상. 설정 → 기능 → 스킬에서 활성화. 사용자 지정 스킬 등록 가능
✔ Claude 코워크 — Pro 플랜 이상. Claude Desktop 앱 설치 필요. 현재 리서치 프리뷰(베타) 단계. 플랜별 사용 한도 차이 있음
✔ Claude Code — Pro 플랜 이상. 개발자 대상. 이 글에서는 개념 참고용으로만 언급. 플랜별 사용 한도 차이 있음
유튜브나 블로그에서 클로드 스킬 관련 콘텐츠를 보면 대부분 이런 말을 합니다. “스킬을 쓰면 AI와 협업의 수준이 달라진다”, “일관성 있는 결과물을 만들 수 있다”. 저도 비슷한 기대를 했습니다. AI 생성 결과물의 가장 큰 단점인 일관성 문제, 그걸 스킬이 해결해줄 수 있다고 생각했습니다.
실제로 써본 결과, 기대했던 방향은 맞습니다. 다만 제대로 작동하게 하려면 알아야 할 게 있습니다. 이 글은 그 과정에서 발견한 것들을 정리한 기록이죠. 잘 작동한 것과 그렇지 않은 것, 둘 다 솔직하게 씁니다.
워크플로우 흐름도클로드 스킬이 작동하는 세 가지 환경
※ 스킬은 세 환경 모두에서 발동되지만, 참조 파일 접근 방식은 각각 다릅니다
스킬이란 무엇인가 — 가장 단순한 설명
클로드 스킬의 실체는 텍스트 파일(.md)입니다. “이런 요청이 오면 이렇게 작업해라”는 지침이 담겨 있습니다. 한 번 등록해두면 매번 설명하지 않아도 됩니다.
제가 쓰는 enersentry-blog 스킬에는 이런 내용이 있습니다. 블로그 글 요청이 오면 바로 쓰지 말고 먼저 인터뷰 질문을 해라, 포커스 키워드를 본문에 특정 횟수 이상 배치해라, 소제목 색상은 특정 색상으로 고정해라. 제가 매번 말하지 않아도 이 지침대로 작동합니다.
STEP 1 — 채팅에서의 스킬: 생각보다 훨씬 쉬웠습니다
스킬 등록은 설정 → 기능 → 스킬 → 사용자 지정에서 파일을 올리면 끝입니다. 여기까지는 누구나 5분 안에 됩니다.
가장 신선했던 건 스킬 업데이트 방식이었습니다. 작업을 하다가 만족스러운 결과가 나오면, “이 작업 과정을 스킬에 반영해줘”라고 말하고 업데이트 버튼 하나만 누르면 됩니다. 스킬 파일을 직접 수정할 필요가 없죠. 이 부분은 GPTs나 Gemini Gems와 비교해도 훨씬 간편합니다.
이미지
▲ 설정 → 기능 → 스킬 → 사용자 지정. 이 화면에서 스킬 파일을 올리고 관리합니다.
스킬이 발동되는 방식도 편리합니다. 스킬 이름을 직접 말하지 않아도 됩니다. 스킬 파일 안에 description이라는 항목에 트리거 조건을 적어두면, 그 조건에 맞는 요청이 들어올 때 자동으로 해당 스킬이 적용됩니다. “enersentry-blog 스킬 써줘”가 아니라 “블로그 글 써줘” 한 마디면 되죠.
스킬만 등록하면 반쪽짜리입니다. 스킬이 참조하는 파일들(템플릿, 가이드 등)을 프로젝트 지식에 함께 올려둬야 합니다. 프로젝트 안에서 대화하면 이 파일들이 자동으로 참조됩니다. 매번 파일을 첨부할 필요가 없습니다.
✔ 스킬 파일 → 설정에서 등록
✔ 참조 파일(템플릿, 가이드) → 프로젝트 지식에 업로드
✔ 해당 프로젝트 안에서 대화 시작
실전 에피소드 — 스킬이 빛났던 순간과 실패한 순간
스킬을 처음 적용하고 블로그 글을 요청했을 때, 가장 먼저 달라진 점은 인터뷰 단계였습니다. 이전에는 “블로그 글 써줘”라고 하면 바로 본문을 생성했습니다. 스킬 적용 후에는 먼저 “이 글의 대상 독자는 누구입니까?”, “핵심 메시지는 무엇입니까?” 같은 질문을 던집니다. 이 인터뷰 과정만으로 결과물의 방향이 확연히 달라졌습니다.
반면 실패한 경험도 있었습니다. 스킬 파일에 “소제목 색상은 #1565c0으로 고정”이라고 적어뒀는데, 어느 날 갑자기 소제목이 검은색으로 나왔습니다. 원인을 추적해보니 대화가 길어지면서 컨텍스트 윈도우 초반에 있던 스킬 지침이 밀려난 것이었죠. 대화가 짧을 때는 잘 따르다가, 대화가 길어지면 세부 지침을 빠뜨리는 현상입니다. 이후로는 긴 작업을 할 때 새 대화를 시작하는 습관을 들였습니다.
스킬의 핵심은 “반복 작업의 일관성”입니다. 블로그 글을 한 편만 쓸 거라면 스킬이 필요 없습니다. 매번 프롬프트를 새로 쓰면 됩니다. 하지만 같은 포맷으로 수십 편을 써야 한다면 이야기가 다릅니다. 매번 “소제목 색상은 이거, 문체는 이거, 키워드 배치는 이렇게”를 반복 입력하는 건 비효율적입니다. 스킬은 이 반복 비용을 제거해줍니다. 다만 만능은 아닙니다. 긴 대화에서 지침이 무시되는 한계를 인지하고 대화를 적절히 끊어주는 게 안정적으로 운용하는 핵심입니다.
STEP 2 — 코워크에서의 스킬: 완벽하지 않습니다
코워크는 Claude Desktop 앱에서 작동하는 에이전트 기능입니다. 내 컴퓨터의 특정 폴더에 접근 권한을 주면, 목표를 던져줬을 때 파일을 읽고 만들고 수정하는 작업을 알아서 처리합니다. 단순히 질문에 답하는 채팅과 다릅니다.
코워크에 기존 프로젝트를 연결하면 스킬은 인식됩니다. 그런데 불확실한 부분이 있습니다. 프로젝트를 연결했다고 해서 스킬이 참조하는 파일들을 매번 확실하게 읽는다는 보장이 없습니다. 읽을 수도 있고, 넘어갈 수도 있죠.
직접 테스트해봤습니다. 프로젝트를 연결했고, 그 프로젝트 지식에는 스킬 파일, 템플릿, 가이드가 모두 올라가 있었습니다. 그런데 결과물을 보니 문체 가이드가 적용되지 않았죠. 코워크 안의 Claude가 스스로 “style-guide.md를 빠뜨렸습니다”라고 인정하는 상황까지 발생했습니다.
이미지
▲ 코워크에서 style-guide.md를 읽지 않았다고 Claude가 직접 인정한 화면. 프로젝트에 파일이 올라가 있어도 코워크가 확실하게 읽는다는 보장은 없습니다.
프로젝트 연결만으로도 스킬은 작동합니다. 다만 참조 파일을 확실하게 읽는다는 보장이 없습니다. 더 안전하게 쓰려면 작업 폴더 안에 참조 파일들을 직접 복사해 넣는 방식을 권장합니다. Claude Code와 동일한 철학입니다 — 파일이 폴더 안에 있으면 확실하게 읽습니다.
작업폴더/CLAUDE.md ← 코워크가 자동으로 읽는 지침 파일html-template.md ← 스킬이 참조하는 파일style-guide.md ← 스킬이 참조하는 파일
코워크 작업 폴더를 설정할 때 “선택한 폴더가 홈 디렉터리 외부에 있습니다”라는 경고가 뜰 수 있습니다. 현재 코워크는
C:\Users\사용자명\ 안의 폴더만 허용합니다. config 수정, 심볼릭 링크 등 여러 방법을 시도했지만 모두 효과가 없었습니다. 현재로서는 홈 디렉터리 안에 폴더를 만들어 쓰는 것이 유일한 방법입니다.빠른 이동: 탐색기 주소창에
%USERPROFILE% 입력 → 그 안에 작업 폴더 생성
클로드 스킬 vs GPTs vs Gemini Gems
클로드 스킬은 GPTs나 Gemini Gems와 자주 비교됩니다. 비슷해 보이지만 다른 개념입니다.
| 항목 | 클로드 스킬 | ChatGPT GPTs | Gemini Gems |
|---|---|---|---|
| 만드는 방법 | .md 파일 업로드 또는 대화 중 업데이트 | GPT Builder UI에서 단계별 입력 | Gems 생성 화면에서 텍스트 입력 |
| 수정 편의성 | 대화 중 “업데이트해줘” 한 마디 | Builder 재진입 후 수정 | Gems 편집 화면 재진입 |
| 파일 참조 | 프로젝트 지식 또는 로컬 폴더 | GPT에 파일 첨부 | Google Drive 연동 |
| 에이전트 연동 | 코워크·Claude Code와 직접 연결 | 제한적 | 제한적 |
| 개념의 기원 | Claude Code (파일 기반 지침) | 챗봇 커스터마이징 | 챗봇 커스터마이징 |
수정 편의성만 보면 클로드 스킬이 압도적으로 쉽습니다. 그런데 이 편리함 뒤에 함정이 있습니다. GPTs나 Gems는 UI 안에서 모든 게 처리되기 때문에 어디서 작동하는지가 명확하죠. 클로드 스킬은 채팅, 코워크, Claude Code에서 각각 다르게 작동하고, 그 차이를 모르면 “스킬은 켜졌는데 지침은 따르지 않는” 상황이 생깁니다.
클로드 스킬을 쓰기 전에 이해해야 하는 개념
클로드 스킬의 뿌리는 Claude Code입니다. Claude Code는 개발자가 특정 프로젝트 폴더 안에 CLAUDE.md라는 지침 파일을 넣어두면, Claude가 그 폴더 안에서 작업할 때 자동으로 읽고 따르는 방식으로 작동합니다.
핵심 개념은 이것입니다. “지침은 Claude가 접근 가능한 위치에 파일로 있어야 한다.” 이 개념이 채팅의 프로젝트 지식, 코워크의 로컬 폴더로 이어집니다. 이걸 모르면 스킬을 등록했는데 왜 어떤 환경에서는 제대로 작동하고 어떤 환경에서는 안 되는지 이해하기 어렵습니다.
이미지
▲ 코워크 컨텍스트 패널. 스킬은 연결됐지만 참조 파일들은 로컬 폴더에 없는 상태입니다.
실전 세팅 체크리스트
| 작업 | 채팅 | 코워크 |
|---|---|---|
| 스킬 파일 등록 | 설정 → 기능 → 스킬 | 설정 → 기능 → 스킬 (동일) |
| 참조 파일 위치 | 프로젝트 지식에 업로드 | 로컬 작업 폴더에 직접 복사 |
| 작업 시작 위치 | 해당 프로젝트 안에서 대화 | 작업 폴더 연결 후 시작 |
| 스킬 발동 방식 | 트리거 조건 매칭 시 자동 | 트리거 조건 매칭 시 자동 |
| Windows 폴더 위치 제한 | 해당 없음 | C:\Users\사용자명\ 내부만 허용 |
· 클로드 스킬은 GPTs·Gems보다 만들고 수정하기 쉽습니다. “업데이트해줘” 한 마디면 됩니다
· 단, 스킬 발동과 참조 파일 접근은 별개입니다. 스킬이 켜져도 파일이 없으면 지침을 따르지 않습니다
· 채팅은 프로젝트 지식, 코워크는 로컬 폴더 — 환경마다 파일 위치가 다릅니다
· 이 차이를 이해하지 못하면 스킬을 쓰는 것과 안 쓰는 것의 차이가 없어집니다
· Claude Code 기반의 “파일이 있어야 읽는다”는 개념을 먼저 이해하는 게 출발점입니다
코워크는 아직 베타 단계입니다. 지금도 조금씩 바뀌고 있습니다. 플러그인, 커넥터(Google Workspace, WordPress 등 외부 서비스 연결), 예약 작업 같은 기능은 다음 편에서 정리하죠.