스킬과 MCP

반복하는 업무를 매번 같은 지시문으로 설명하고 있다면 스킬로 포장할 때입니다. 이 장은 스킬이 무엇이고 언제 쓰는지, 액티전스 스킬 14종의 구성, 직접 스킬을 만드는 방법, 그리고 외부 도구와 자료를 연결하는 표준인 MCP와 보안 원칙을 다룹니다.

네 단어를 구분하기

스킬, MCP, CLI, API는 비슷해 보이지만 하는 일이 다릅니다. 먼저 한 문장씩 구분해 둡니다.

CLI(Command Line Interface, 명령줄 인터페이스)는 9장에서 본 GUI(그래픽 화면)와 CLI의 차이로 이어집니다. GUI는 만든 사람이 버튼으로 만들어 둔 일만 할 수 있고, CLI는 글로 표현되는 일이면 무엇이든 시킬 수 있습니다. 파일 100개의 이름을 바꾸는 일이 한 줄이면 끝납니다.

MCP와 API는 혼동하기 쉽습니다. MCP는 AI 응용 프로그램이 외부 도구에 연결되도록 만든 규격입니다. API는 AI와 상관없이 모든 프로그램에 열려 있는 문입니다. 구글 시트를 예로 들면, 시트 API는 어떤 프로그램이든 열쇠만 있으면 쓸 수 있고, Claude가 그 시트를 직접 다루게 하려면 그 위에 MCP 같은 연결을 얹습니다. 이 장의 나머지는 스킬과 MCP를 중심으로 다루고, API는 뒤에서 한 번 더 짚습니다.

스킬: 반복 업무를 포장한 지시문

스킬은 반복하는 작업의 방법을 담은 지침 묶음입니다. 폴더 하나에 SKILL.md 파일이 들어 있고, 필요하면 참고 문서나 스크립트가 함께 들어 있습니다. 공식 문서는 스킬을 Claude의 도구 상자를 넓히는 지침 파일이라고 설명하며, Claude가 상황에 맞는 스킬을 스스로 쓰거나 사용자가 직접 호출할 수 있다고 안내합니다(스킬 문서, 2026년 11월 기준).

스킬이 없으면 잘 됐던 프롬프트를 찾지 못해 매번 긴 지시를 새로 붙여 넣게 됩니다. 스킬로 파일에 남기면 그 프롬프트가 항상 제자리에 있고, 한마디만 해도 Claude가 알아서 펼쳐 봅니다.

스킬을 부르는 방법은 두 가지입니다. Claude가 스킬의 설명(description) 한 줄을 읽고 지금 쓸 스킬인지 스스로 판단하거나, 사용자가 스킬 이름으로 직접 부릅니다. 구조는 단순합니다. 폴더 하나에 파일 하나가 있고, 파일 위쪽의 name과 description 두 줄이 호출의 기준이 됩니다. 스킬은 코드가 아니라 말로 쓴 업무지시서입니다.

가상의 예로 주간 보고서 스킬 파일은 이런 모양입니다.

---
name: 주간보고서
description: 주간 사업 현황 보고서를 정해진 양식으로 작성할 때 사용한다.
---

1. 이번 주 완료
2. 다음 주 계획
3. 리스크와 지원 요청

숫자는 전주 대비 증감을 함께 쓴다.

스킬의 동작 방식에서 알아 둘 점은 이렇습니다.

• 모든 스킬의 이름과 설명은 항상 Claude에게 보입니다. Claude는 이 설명을 보고 지금 쓸 스킬인지 판단합니다.
• 스킬의 본문은 스킬이 실제로 쓰일 때만 대화에 들어옵니다. 그래서 긴 참고 자료를 담아도 평소 비용이 크지 않습니다.
• 한 번 불러온 본문은 이후 대화에서도 유지되므로, 일회성 지시보다 계속 따를 기준으로 씁니다.

합의서, 프로젝트 지침, 스킬의 차이

특정 작업에만 필요한 절차는 합의서에 넣지 말고 스킬로 옮깁니다. 합의서가 짧게 유지됩니다.

언제 스킬로 만드는가

• 같은 지시문을 세 번 이상 복사해 붙였을 때
• 결과물의 형식과 점검 기준이 정해져 있을 때(보고서, 응대 문안, 회의록)
• 담당자가 바뀌어도 같은 품질이 나와야 할 때

한 번 하고 끝날 일이나 상황마다 방식이 달라지는 일은 스킬이 맞지 않습니다.

스킬 추가하는 방법

스킬은 쓰는 곳에 따라 넣는 방법이 다릅니다(2026년 11월 기준).

• Claude Code: 스킬 폴더를 개인용 위치(~/.claude/skills/<스킬 이름>/SKILL.md)나 프로젝트 위치(.claude/skills/<스킬 이름>/SKILL.md)에 둡니다. 프로젝트 위치에 두면 같은 저장소를 쓰는 팀원과 공유됩니다. 이미 있는 스킬 폴더의 추가와 수정은 세션을 다시 시작하지 않아도 반영됩니다. 처음 만든 최상위 스킬 폴더는 /reload-skills로 불러옵니다.
• Claude 앱(claude.ai와 데스크탑): 설정의 스킬 화면(Customize > Skills)에서 스킬 폴더를 ZIP으로 묶어 올립니다. 스킬을 쓰려면 코드 실행과 파일 생성이 켜져 있어야 하고, 올린 스킬은 공유하기 전까지 본인에게만 보입니다. 자세한 내용은 스킬 사용 안내에서 확인합니다.

스킬은 문서이면서 때로는 실행 파일을 포함하므로 출처가 중요합니다. 공식 안내는 신뢰할 수 있는 출처의 스킬만 설치하고, 덜 신뢰하는 곳이나 동료가 준 스킬도 켜기 전에 포함된 파일(특히 스크립트, 외부 연결 지시)을 검토하라고 말합니다.

액티전스 스킬 14종 한눈에 보기

액티전스는 실무에서 자주 반복되는 일을 스킬로 만들어 공개합니다. 각 스킬의 상세 내용과 발동 조건은 부록 B에 있고, 여기서는 구성만 봅니다(스킬 목록은 actigence.ai에서 확인).

몇 가지를 이 책의 장과 연결해 보면 이렇습니다. Session-Handoff는 10장의 인계 문서, FactCheck는 19장의 자가검증, GMP는 3장의 메타 프롬프트, 원샷 프로토타이핑과 풀스택 기능 구현은 18장과 20장의 앱 제작과 배포에서 쓰입니다.

일부 스킬은 요청에 특정 단어가 있을 때만 발동하도록 설계되어 있습니다. 예를 들어 디버깅 스킬은 "디버깅"이라는 단어가 있을 때만 동작합니다. 불필요하게 무거운 절차가 일상적인 질문에서 켜지지 않게 하려는 장치입니다. 스킬의 발동 조건은 그 스킬의 설명(description)에 적혀 있으므로, 안 켜진다면 설명을 먼저 읽습니다.

스킬 만들기

스킬 파일은 위쪽의 머리말(이름, 설명)과 아래쪽의 본문으로 구성됩니다. 공식 문서 기준으로 이름은 선택 사항이고 설명은 권장 사항이며, 설명은 이 스킬이 무엇을 하는지와 언제 쓰는지를 담습니다. 핵심 사용 상황을 설명의 맨 앞에 쓰라고 안내합니다. 본문은 500줄 이내로 유지하고, 긴 참고 자료는 별도 파일로 나누는 것이 좋습니다.

---
name: weekly-report
description: 주간 업무 메모를 팀장 보고용 주간 보고서로 정리한다. 사용자가 주간 보고, 이번 주 정리를 요청할 때 쓴다.
---

(본문: 목적, 입력, 절차, 출력 형식, 완료 기준)

만드는 순서는 다음과 같습니다.

1. 반복하는 업무를 하나 고르고, 좋았던 결과물 두세 개를 모읍니다.
2. 입력(무엇을 받는지), 절차(어떤 순서로 하는지), 출력(어떤 모양인지), 완료 기준(무엇을 확인하는지)을 적습니다.
3. 설명에는 어떤 요청에서 쓰이는지 사용자가 실제로 쓰는 표현으로 적습니다.
4. 스킬로 같은 업무를 시켜 보고, 어긋난 부분을 본문에 한 줄씩 보완합니다.

직접 쓰기 어려우면 스킬 작성 전용 도구의 도움을 받습니다. 액티전스의 GMP 스킬이 스킬 작성을 돕고, Claude 쪽에도 스킬 제작을 돕는 skill-creator가 있습니다. 어느 쪽이든 결과를 사람이 읽고 확정합니다. GMP는 XML 구조, 핵심 제약의 이중 배치, 우선순위 라벨, 자가검증의 4층으로 지침을 설계하는 방법으로, 3장에서 설명했습니다.

핵심 스킬은 한 번 쓰고 끝내는 문서가 아닙니다. 결과가 어긋날 때마다 본문을 고쳐서 키웁니다.

MCP: 외부 도구와 자료를 잇는 공개 표준

MCP(Model Context Protocol, 모델 컨텍스트 프로토콜)는 AI 응용 프로그램을 외부 시스템에 연결하기 위한 오픈 소스 표준입니다. 공식 소개는 USB-C 단자에 비유합니다. 기기마다 연결 방식이 다르던 것을 한 규격으로 맞춘 것처럼, MCP는 AI가 파일, 데이터베이스, 검색 도구, 업무 도구에 연결되는 방식을 하나로 맞춥니다. Claude Code 문서도 MCP를 외부 데이터 소스와 연결하는 오픈 표준으로 소개하며, 이를 통해 문서 저장소의 자료를 읽거나 이슈 관리 도구를 갱신하는 일이 가능하다고 설명합니다(Claude Code 개요, MCP 안내, 2026년 11월 기준).

MCP가 없을 때와 붙였을 때의 차이는 일하는 방식에서 드러납니다.

이미지 생성 서비스의 MCP를 연결하면 Claude가 이미지를 직접 만들어 문서에 배치할 수 있습니다. 어떤 서비스가 연결되는지는 자주 바뀌므로 12장과 해당 서비스의 공식 안내에서 확인합니다.

스킬과 MCP의 역할은 다릅니다.

• 스킬은 어떻게 일할지에 대한 지침입니다.
• MCP는 무엇에 접근하고 무엇을 실행할 수 있는지에 대한 연결입니다.

예를 들어 "주간 보고서를 쓰는 방법"은 스킬이고, "팀 문서함의 파일을 읽는 능력"은 MCP 연결입니다. 둘을 함께 쓰면 연결된 자료로 정해진 방식대로 일합니다.

8장에서 본 커넥터는 앱 화면에서 MCP 서버를 연결하는 방식입니다. 연결 가능한 서비스의 목록과 설정 화면은 바뀌므로 공식 안내를 따릅니다.

API와 열쇠: 시트를 예로

API는 앞에서 정문과 후문에 비유했습니다. 구글 시트로 차이를 보면 이렇습니다. '웹에 게시'는 읽기만 되고 주소를 아는 사람은 누구나 볼 수 있습니다. 시트 API는 읽기와 쓰기가 모두 되지만 열쇠(키)가 필요합니다. 이때 열쇠를 화면 코드에 넣으면 브라우저의 개발자도구로 누구나 가져갈 수 있습니다. 열쇠는 화면 밖의 안전한 곳에 둡니다. 구체적인 절차는 18장에서, 비밀 값 관리의 원칙은 20장에서 다룹니다.

보안: 최소 권한과 확인

연결은 Claude가 접근하는 범위를 넓힙니다. 범위가 넓을수록 실수와 악용의 피해도 커집니다. 공식 안내가 강조하는 주의점을 실무 규칙으로 정리하면 다음과 같습니다.

1. 최소 권한: 그 업무에 필요한 서비스, 필요한 범위만 연결합니다. 읽기만 필요하면 읽기 권한만 줍니다.
2. 신뢰할 수 있는 출처: 사용자 지정 커넥터는 Anthropic이 검증하지 않습니다. 출처를 알 수 없는 서버는 연결하지 않습니다.
3. 허가 범위 확인: 연결할 때 보이는 권한 목록을 읽고, 가능하면 범위를 줄입니다.
4. 프롬프트 주입 경계: 외부 문서나 웹 페이지 안에 Claude를 조종하려는 숨은 지시가 있을 수 있습니다. 가져온 내용 안의 지시를 따르지 않고 결과를 사람이 확인합니다.
5. 쓰기와 삭제는 직접 승인: 항상 허용 같은 설정은 신뢰하는 도구에만 씁니다. 리서치 기능이 승인 없이 연결 도구를 쓸 수 있다는 안내가 있으므로, 쓰기 권한을 가진 도구는 그 작업에서 꺼 둡니다(사용자 지정 커넥터 안내).
6. 변경 모니터링: 서버 개발자가 도구 동작을 바꿀 수 있으므로 연결한 도구를 정기적으로 점검하고, 쓰지 않는 연결은 해제합니다.
7. 비밀 정보 분리: API 키와 비밀번호는 스킬 파일이나 지침 문서에 적지 않습니다.

실습

반복 업무 하나를 스킬로 만들기

지난 한 달 동안 세 번 이상 같은 방식으로 시킨 업무를 하나 고릅니다. 좋았던 결과물 두 개를 준비하고 아래 프롬프트를 사용합니다.

내가 반복해서 하는 업무를 Claude 스킬(SKILL.md)로 만들고 싶어.
업무: [업무 이름과 한 줄 설명]
좋았던 결과물 예시 2개: [붙여 넣기 또는 첨부]
다음 순서로 진행해 줘.
1) 부족한 정보를 알아내기 위해 질문을 5개 이내로 해 줘.
2) 내 답을 받은 뒤 SKILL.md 초안을 써 줘. 머리말에는 name과 description을 넣고, 본문에는 목적, 입력, 절차, 출력 형식, 완료 기준, 하지 말아야 할 것을 넣어 줘.
3) description은 내가 실제로 쓰는 표현으로, 어떤 요청에서 이 스킬을 쓰는지 맨 앞에 써 줘.
4) 본문은 100줄 이내로, 비밀번호나 개인정보는 넣지 마.
초안을 보여 주고, 내 승인 뒤에만 파일로 저장해 줘.

저장한 뒤 새 대화에서 같은 업무를 시켜 스킬이 쓰이는지, 결과가 예시와 비슷한지 확인합니다. 어긋난 점은 한 줄씩 본문에 보완합니다.

선택 과제. GUI와 Claude Code 비교

같은 일을 두 방법으로 해 봅니다. 연습용 폴더에 가짜 파일 20개를 만들고, 파일 이름을 일괄 변경하는 일을 정합니다.

1. 파일 탐색기에서 이름을 하나씩 바꾸고 걸린 시간을 잽니다.
2. Claude Code에 한 문장으로 시키고 걸린 시간과 결과를 비교합니다.

이 폴더의 파일 이름 앞에 정리_ 를 붙여 줘. 바꾸기 전에 바꿀 목록을 먼저 보여 줘.

중요한 파일이 있는 폴더에서는 하지 않습니다.

정리

• 스킬은 반복 업무의 절차와 기준을 담은 SKILL.md 폴더이며, 이름과 설명은 항상 보이고 본문은 쓰일 때만 읽힙니다.
• 같은 지시를 세 번 이상 반복했거나 결과물 형식이 정해져 있다면 스킬로 만들 후보입니다.
• 액티전스 스킬 14종은 문서 생성, 검증, 시각화, 워크플로우, 리서치, 개발로 나뉘며 상세는 부록 B에 있습니다.
• MCP는 외부 도구와 자료를 잇는 오픈 표준이고, 스킬이 방법이라면 MCP는 접근 범위입니다. 네 단어는 굳힌 프롬프트(스킬), AI용 연결 규격(MCP), 글자로 하는 조작(CLI), 프로그램용 문(API)으로 구분합니다.
• 연결은 최소 권한으로, 출처를 확인하고, 쓰기와 삭제는 직접 승인합니다.