Skills가 프롬프트, 프로젝트, MCP, 서브 에이전트와 다른 점

Skills가 도입된 이후, Claude의 에이전트 에코시스템의 다양한 구성 요소가 어떻게 상호 작용하는지에 대한 관심이 커지고 있습니다.

Claude Code에서 정교한 워크플로우를 구축하든, API로 엔터프라이즈 솔루션을 생성하든, Claude.ai에서 생산성을 극대화하든, 어떤 도구를 언제 활용해야 하는지 알아야 Claude와 함께 작업 방식을 혁신할 수 있습니다.

이 가이드는 각 구성 요소를 세분화하고, 언제 무엇을 사용해야 하는지를 설명하며, 강력한 에이전트 워크플로우를 위해 이를 어떻게 조합해야 하는지를 보여줍니다.

에이전트 구성 요소 이해

Skills는 무엇인가요?

Skills는 Claude가 작업과 관련된 경우 동적으로 발견하고 로드하는 지침, 스크립트, 리소스가 포함된 폴더입니다. Excel 스프레드시트 작업부터 조직의 브랜드 가이드라인을 따르는 것까지, Claude에 특정 영역의 전문 지식을 제공하는 전문 교육 매뉴얼이라고 생각할 수 있습니다.

Skills 작동 방식: Claude가 작업을 만나면 사용 가능한 Skills를 스캔하여 관련 항목을 찾습니다. Skills는 점진적으로 공개됩니다: 메타데이터가 먼저 로드되며(약 100토큰), Claude가 Skills가 언제 관련이 있는지 알 수 있도록 충분한 정보를 제공합니다. 필요할 때 전체 지침을 로드하고(5,000토큰 미만), 번들로 구성된 파일이나 스크립트는 필요에 따라서만 로드합니다.

Skills 사용 시점: Claude가 특수 작업을 일관되고 효율적으로 수행해야 할 경우에는 Skills를 선택합니다. 다음 경우에 이상적입니다.

• 조직 워크플로우: 브랜드 가이드라인, 규정 준수 절차, 문서 템플릿
• 전문 분야: Excel 수식, PDF 조작, 데이터 분석
• 개인 선호도: 노트 기록 시스템, 코딩 패턴, 리서치 방법

사례: 회사의 색상 팔레트, 타이포그래피 규칙, 레이아웃 기준을 포함한 브랜드 가이드라인 Skill을 만들어 보세요. Claude는 프레젠테이션이나 문서를 생성할 때, 사용자가 매번 설명할 필요 없이 이 기준을 자동으로 적용합니다.

Skills에 대해 자세히 알아보려면, 계속 추가되는 Skills 라이브러리를 확인하세요.

프롬프트란 무엇인가요?

프롬프트는 대화 중에 자연어로 Claude에게 전달하는 지침입니다. 일시적이고, 대화형이며, 반응형입니다. 즉, 그 순간 필요한 맥락과 방향을 제시합니다.

프롬프트 사용 시기: 프롬프트는 다음과 같은 경우에 적합합니다.

• 일회성 요청: "이 기사를 요약해 주세요"
• 대화 다듬기: "톤을 더 전문적으로 바꿔 주세요"
• 즉각적인 상황: "이 데이터 분석 및 추세를 식별해 주세요"
• 임시 지침: "이걸 글머리 목록으로 작성해 주세요"

예: 

이 코드에 대한 종합적인 보안 검토를 해주세요. 검토 범위는 아래와 같습니다:

1. 일반적인 취약점

• 인젝션 결함(SQL, 명령, XSS 등)
• 인증 및 승인 문제
• 민감한 데이터 유출
• 보안 설정 오류
• 액세스 제어 실패
• 암호화 실패
• 입력 검증 문제
• 오류 처리 및 로깅 문제

2. 각 이슈에 대해 다음 정보제공

• 심각도 수준(위험/높음/보통/낮음)
• 코드 내 위치(줄 번호 또는 함수 이름)
• 보안상 문제가 되는 이유와 악용 가능성
• 가능한 경우 코드 예제가 포함된 구체적인 수정 권고 사항
• 유사 문제 예방을 위한 모범 사례 지침

3. 코드 맥락: [코드의 역할, 언어/프레임워크, 실행 환경 설명 - 예: "사용자 인증을 처리하고 결제 데이터를 처리하는 Node.js REST API입니다."]

4. 추가 고려 사항

• OWASP 상위 10대 취약점이 있나요?
• 코드가 [특정 프레임워크/언어]의 보안 모범 사례를 따르나요?
• 알려진 취약점과 종속성이 있나요?

심각도와 잠재적인 영향에 따라 결과의 우선순위를 결정하세요.

프로 팁: 프롬프트는 Claude와 소통하는 주요 수단이지만, 대화 전반에서 지속적으로 이어지지는 않습니다. 반복적인 워크플로우나 전문 지식의 경우, 프롬프트를 Skills나 프로젝트 지침으로 정리해 두는 것이 좋습니다.

대신 Skill을 사용해야 하는 경우: 여러 대화에서 동일한 프롬프트를 반복적으로 입력한다면, 이제 Skill을 생성해야 합니다. 'OWASP 표준을 사용하여 이 코드의 보안 취약성을 검토하세요', '이 분석을 요약, 주요 결과, 권고 사항으로 구성하세요' 처럼 반복적인 지침을 Skills로 전환합니다. 이를 통해 매번 절차를 다시 설명할 필요가 없으며, 일관된 실행을 보장합니다.

시작하려면 프롬프트 라이브러리, 프롬프트 작성 모범 사례 또는 스마트 프롬프트 메이커를 확인해 보세요.

프로젝트란 무엇인가요?

모든 유료 Claude 플랜에서 제공되는 프로젝트는 자체 채팅 기록과 지식 기반을 보유한 독립적인 워크스페이스입니다. 각 프로젝트에는 문서를 업로드하고, 컨텍스트를 제공하며, 프로젝트 내의 모든 대화에 적용되는 맞춤형 지침을 설정할 수 있는 200K 크기의 컨텍스트 창이 포함됩니다.

프로젝트 작동 방식: 프로젝트 지식 기반에 업로드한 모든 내용은 해당 프로젝트 내의 모든 채팅에서 사용할 수 있습니다. Claude는 이 맥락을 자동으로 활용하고, 더 많은 정보에 입각하여 관련성 있는 대응을 제공합니다. 프로젝트 지식이 맥락 한계에 도달하면, Claude는 RAG(검색 증강 생성) 모드를 원활하게 활성화하여, 용량을 최대 10배까지 확장합니다.

프로젝트 사용 시기: 다음이 필요할 때 프로젝트를 선택합니다.

• 지속적인 컨텍스트: 모든 대화에 중요한 배경 지식
• 워크스페이스 조직: 서로 다른 이니셔티브를 위한 컨텍스트 분리
• 팀 협업: 지식 및 대화 기록 공유(Team 및 Enterprise 플랜 기준)
• 맞춤형 지침: 프로젝트별 톤이나 관점, 접근 방식

예: 시장 조사, 경쟁사 분석, 제품 사양을 포함한 '4분기 제품 출시' 프로젝트를 생성합니다. 이 프로젝트의 모든 채팅은 이 지식을 다시 업로드하거나 맥락을 다시 설명하지 않아도 해당 정보에 접근할 수 있습니다.

대신 Skill을 사용해야 하는 경우: 프로젝트는 Claude에 회사 코드베이스, 리서치 이니셔티브, 진행 중인 고객 참여와 같은 특정 업무를 위한 지속적인 맥락을 제공합니다. 반면 Skills는 Claude에게 특정 작업을 수행하는 방법을 학습시킵니다. 프로젝트에는 제품 출시에 대한 모든 배경 정보가 포함될 수 있으며, Skill은 팀의 글쓰기 기준이나 코드 리뷰 프로세스를 Claude에게 알려줄 수 있습니다. 만약 여러 프로젝트에서 동일한 지침을 복사하고 있다면, 이는 Skill을 만들어야 할 신호입니다.

프로젝트에 대해 더 알아보십시오.

서브 에이전트란 무엇인가요?

서브 에이전트는 전문 AI 어시스턴트로, 고유한 컨텍스트 창, 맞춤형 시스템 프롬프트, 특정 도구 권한을 갖습니다. Claude Code와 Claude Agent SDK에서 사용할 수 있도록, 서브 에이전트는 독립적으로 개별 작업을 처리하고, 결과를 메인 에이전트에 반환합니다.

서브 에이전트 작동 방식: 각 서브에이전트는 고유한 구성으로 운영됩니다. 즉, 수행하는 작업, 문제 접근 방식, 어떤 도구에 접근할 수 있는지 사용자가 정의합니다. Claude는 설명을 바탕으로 적절한 서브 에이전트에게 작업을 자동으로 위임하거나, 특정 서브 에이전트에게 명시적으로 요청할 수 있습니다.

서브 에이전트 사용 시기: 는 다음과 같은 경우에 적합합니다.

• 작업 전문화: 코드 검토, 테스트 생성, 보안 감사
• 맥락 관리: 주요 대화에 집중하고, 전문적인 업무는 분리
• 병렬 처리: 여러 서브에이전트가 서로 다른 분야를 동시에 처리
• 도구 제한: 특정 서브 에이전트를 안전한 작업으로 제한(예: 읽기 전용 액세스)

예:

Read, Grep, Glob 도구에 액세스하지만 Write나 Edit는 액세스할 수 없는 코드 검토자 서브 에이전트를 생성합니다. 코드를 수정하면, Claude는 의도하지 않은 코드 변경의 위험 없이 품질과 보안 검토를 위해 이 서브 에이전트에 자동으로 위임합니다.

대신 Skill을 사용해야 하는 경우: 여러 에이전트나 대화에 보안 검토 절차나 데이터 분석 방법과 같이 동일한 전문 지식이 필요한 경우, 개별 서브 에이전트에 해당 지식을 반영하지 않고 Skill을 생성합니다. Skills는 이식성이 뛰어나고 재사용 가능하며, 서브 에이전트는 특정 워크플로우에 맞게 특별 설계되었습니다. 모든 에이전트가 적용할 수 있는 전문 지식을 가르칠 때는 Skills를 활용하고, 특정 도구 권한과 맥락 분리가 필요한 독립적인 작업 실행이 필요할 때는 서브 에이전트를 활용할 수 있습니다.

서브 에이전트에 대해 더 알아보기

MCP란 무엇인가요?

MCP(모델 컨텍스트 프로토콜)는 AI 어시스턴트를 콘텐츠 리포지토리, 비즈니스 도구, 데이터베이스, 개발 환경 등 데이터가 존재하는 외부 시스템에 연결하는 개방형 표준입니다.

MCP 작동 방식: MCP는 Claude를 도구와 데이터 소스에 연결하는 표준화된 방법을 제공합니다. 각 데이터 소스에 맞게 맞춤형 통합 기능을 구축하는 대신, 단일 프로토콜을 기반으로 구축합니다. MCP 서버는 데이터와 기능을 제공하고, Claude와 같은 MCP 클라이언트는 이러한 서버에 연결합니다.

MCP 사용 시기: Claude가 다음과 같은 작업을 수행해야 할 때 MCP를 사용하세요.

• 외부 데이터 액세스: Google Drive, Slack, GitHub, 데이터베이스
• 비즈니스 도구 사용: CRM 시스템, 프로젝트 관리 플랫폼
• 개발 환경에 연결: 로컬 파일, IDE, 버전 관리
• 맞춤형 시스템과 통합: 독점 도구 및 데이터 소스

예: MCP를 통해 Claude를 회사의 Google Drive에 연결하세요. 이제 Claude는 수동으로 업로드하지 않고도 문서를 검색하고, 파일을 읽으며, 내부 지식을 참조할 수 있으며, 연결은 유지되고 자동으로 업데이트됩니다.

대신 Skill을 사용해야 하는 경우: MCP는 Claude와 데이터를 연결하고, Skills는 Claude에게 그 데이터를 어떻게 처리할지 지시합니다. "데이터베이스 쿼리할 때, 항상 날짜 범위를 먼저 기준으로 필터링하세요", "Excel 보고서의 서식을 이 특정 수식으로 지정하세요" 등 도구 사용이나 절차를 따르는 방법을 설명하고 있다면, 이것이 바로 Skill에 해당합니다. Claude에게 처음부터 데이터베이스나 Excel 파일 접근 권한을 줘야 한다면, MCP를 선택하세요. 연결성은 MCP를, 절차적 지식은 Skills를 활용하세요.

MCP에 대해 자세히 알아보고, MCP 서버 구축 방법에 대한 문서를 확인하세요.

두 가지 요소가 함께 작동하는 방식

진정한 힘은 이 두 가지 요소를 결합할 때 나옵니다. 각 요소는 역할이 분명하며, 함께 사용하면 정교한 에이전틱 워크플로우를 만들어냅니다.

비교: 올바른 도구 선택

에이전트 워크플로우 예제: 리서치 에이전트

여러 빌딩 블록을 결합한 포괄적인 리서치 에이전트를 만들어 보겠습니다. 이 예제는 경쟁 분석을 위해 에이전트를 조립하고 활성화하는 방법을 보여줍니다.

1단계: 프로젝트 설정

'경쟁 인텔리전스' 프로젝트를 생성하고 다음을 업로드합니다

• 업계 보고서 및 시장 분석
• 경쟁사 제품 문서
• CRM의 고객 피드백
• 이전 리서치 요약

프로젝트 지침을 추가하세요:

제품 전략 관점에서 경쟁사를 분석하세요. 차별화 기회와 신규 시장 동향에 집중하세요. 구체적인 증거와 실행 가능한 권고 사항을 포함한 결과를 제시하세요.

2단계: MCP를 통해 데이터 소스 연결

MCP 서버 활성화:

• Google Drive(공유 리서치 문서 액세스)
• GitHub(경쟁사 오픈 소스 리포지토리 검토)
• 웹 검색(실시간 시장 정보)

3단계: 전문화된 Skills 생성

'competitive-analysis' skill을 개발하세요:

# 내 회사 GDrive 탐색 스킬

## 개요
Meridian Tech의 Google Drive 구조에 최적화된 검색 및 검색 전략. 이 스킬을 활용해 내부 문서, 연구, 전략적 자료를 효율적으로 찾을 수 있습니다.

## 조직 구동

**최상위 구조:**
- `/Strategy & Planning/` - OKR, 분기별 계획, 보드 덱
- `/Product/` - PRD, 로드맵, 기술 사양
- `/Research/` - 시장 조사, 경쟁사 인텔리, 사용자 연구
- `/Sales & Marketing/` - 고객 사례, 피치 덱, 캠페인 자료
- `/Customer Success/` - 구현 가이드, 성공 지표
- `/Company Ops/` - 정책, 조직도, 팀 디렉토리

**명명 규칙:**
- 형식: `YYYY-MM-DD_DocumentName_vX`
- `_FINAL`로 표시된 최종 버전
- 초안에는 `_DRAFT` 또는 `_WIP`가 포함

## 검색 모범 사례

1. **광범위하게 시작한 다음 필터링** - 폴더 컨텍스트 + 키워드 사용
2. **타겟 문서 소유자** - 루트가 아닌 영업/의 영업 자료
3. **최근 성 확인** - 현재 전략을 위해 지난 6개월 간의 문서에 우선순위를 지정합니다.
4. **'진실의 소스'를 찾으세요** - `_FINAL`, `_APPROVED`, 또는 `/Archives/Official/`에 있는 파일

## 연구 에이전트 워크플로우

1. 주제 카테고리(제품, 시장, 고객) 식별하기
2. 타겟 키워드로 관련 폴더를 검색
3. 가장 최근/관련 문서 3~5개 검색
4. 컨텍스트를 위해 `/Strategy & Planning/`과 상호 참조
5. 파일 이름과 날짜가 포함된 소스를 인용합니다.

4단계: 서브 에이전트 구성(Claude Code/SDK 전용)

특수 서브 에이전트 생성:

market-researcher 서브 에이전트:

이름: market-researcher
설명: 시장 동향, 업계 보고서, 경쟁 상황 데이터를 연구합니다. 경쟁 분석을 위해 사전 예방적으로 사용하세요.
도구: 읽기, Grep, 웹 검색
---
경쟁 인텔리전스를 전문으로 하는 시장 조사 분석가입니다.

연구 시:
1. 신뢰할 수 있는 소스(Gartner, Forrester, 업계 보고서) 식별하기
2. 정량적 데이터(시장 점유율, 성장률, 펀딩) 수집
3. 질적 인사이트(분석가 의견, 고객 리뷰) 분석
4. 트렌드와 패턴 종합

인용과 신뢰도 수준으로 결과를 발표하세요.

technical-analyst서브 에이전트:

이름: technical-analyst
설명: 기술 아키텍처, 구현 접근 방식, 엔지니어링 결정을 분석합니다. 기술 경쟁사 분석에 사용하세요.
도구: 읽기, Bash, Grep
---
경쟁사의 기술 선택을 분석하는 기술 아키텍트입니다.

분석 시:
1. 공용 리포지토리와 기술 문서 검토
2. 아키텍처 패턴과 기술 스택 평가
3. 확장성과 성능 접근 방식 평가
4. 기술적 강점과 제한 사항 식별하기

제품 결정을 내리는 실행 가능한 기술 인사이트에 집중하세요.

5단계: 리서치 에이전트 활성화

이제 Claude에 질문하기: "상위 3개 경쟁사가 새로운 AI 기능을 어떻게 포지셔닝하고 있는지, 그리고 우리가 활용할 수 있는 격차를 찾아보세요"

무슨 일이 일어날까요?

1. 프로젝트 컨텍스트 로드: Claude는 업로드된 리서치 문서에 액세스하고 프로젝트 지침을 따릅니다.
2. MCP 연결 활성화: Claude가 Google Drive에서 최근 경쟁사 브리핑을 검색하고, GitHub 데이터를 가져옵니다.
3. Skills 적용: competitive-analysis Skill이 분석 프레임워크를 제공합니다.
4. 서브 에이전트 실행(Claude Code에서): market-researcher는 업계 데이터를 수집하고, technical-analyst는 기술 구현을 검토합니다.
5. 프롬프트 보정: "특히 헬스케어 분야의 기업 고객에게 집중하세요"와 같은 대화형 지침을 추가합니다.

결과: 여러 데이터 소스를 활용하고, 분석 프레임워크를 바탕으로 전문 지식을 활용하고, 리서치 프로젝트 전반에서 컨텍스트를 유지하는 종합적인 경쟁 분석을 제공합니다.

일반적인 질문

Skills는 어떻게 작동하나요?

Claude의 효율성을 유지하기 위해 점진적인 정보 공개를 사용합니다. Claude는 작업 시 먼저 Skill 메타데이터(설명 및 요약)를 스캔하여 관련 일치 항목을 식별합니다. Skill이 일치하면, Claude가 전체 지침을 로드합니다. 마지막으로, Skill에 실행 코드나 참조 파일이 포함되어 있으면, 필요할 때만 로드합니다.

이 아키텍처는 Claude의 컨텍스트 창에 부담을 주지 않으면서도 많은 Skills를 사용할 수 있음을 의미합니다. Claude는 필요한 순간에, 정확한 정보만 가져옵니다.

Skills vs. 서브 에이전트: 언제 무엇을 사용해야 하는가

Skills 사용: 모든 Claude 인스턴스에서 로드해 사용할 수 있는 기능이 필요할 때 사용합니다. Skills는 훈련 자료와 같습니다. 모든 대화에서 Claude가 특정 업무를 더 잘 수행하도록 돕습니다.

서브 에이전트 사용: 특정 목적을 위해 설계된, 워크플로우를 독립적으로 처리하는 완전히 자립적인 에이전트가 필요할 때 사용합니다. 서브 에이전트는 고유한 컨텍스트와 도구 권한이 있는 전문 직원과 같습니다.‍

두 가지 기능을 함께 사용: 전문성을 갖춘 서브 에이전트를 만들고 싶을 때 사용합니다. 예를 들어, 코드 리뷰 서브 에이전트가 언어별 모범 사례에 Skills를 활용하면, 서브 에이전트의 독립성과 Skills의 재사용 가능한 전문 지식을 결합할 수 있습니다.

Skills vs. 프롬프트: 언제 무엇을 사용해야 하는가

프롬프트 사용: 일회성 지침이나 즉각적인 상황 설명, 또는 대화형 상호작용이 필요할 때 적합합니다. 프롬프트는 반응적이고 일시적입니다.

Skills 사용: 반복적으로 필요한 절차나 전문 지식이 있을 때 사용합니다. Skills는 Claude가 적용 시점을 스스로 판단하는 선제적 기능이며, 대화가 바뀌어도 지속됩니다.

두 가지 기능을 함께 사용: 프롬프트와 Skills는 서로를 자연스럽게 보완합니다. 기본적인 전문성은 Skills로 제공하고, 각 작업에 필요한 구체적인 맥락과 세부 조정은 프롬프트로 보완하세요.

Skills vs. 프로젝트: 언제 무엇을 사용해야 하는가

프로젝트 사용: 특정 이니셔티브와 관련된 모든 대화에 정보를 제공하는 배경 지식과 맥락이 필요합니다. 프로젝트는 항상 로드되는 정적 참조 자료를 제공합니다.‍

Skills 사용: 필요한 경우에만 실행되는 실행 코드와 절차 지식이 필요할 때 사용합니다. Skills는 온디맨드로 로드되는 동적 전문 지식을 제공하여, 컨텍스트 창을 유지합니다.

두 가지 기능을 함께 사용: 지속적인 맥락과 전문화된 기능이 모두 필요할 때 사용합니다. 예를 들어, 제품 스펙과 사용자 리서치를 포함하는 '제품 개발' 프로젝트는 기술 문서를 생성하고 사용자 피드백 데이터를 분석하는 데 Skills와 결합되었습니다.

주요 차이점: 프로젝트는 "알아야 할 정보."를 제공하고, Skills는 "어떻게 수행할지"를 제공합니다. 프로젝트는 업무를 수행하는 데 필요한 지식 기반을 제공하고, Skills는 모든 대화, 프로젝트에서 활용할 수 있는 역량을 제공합니다.

서브 에이전트가 Skills를 사용할 수 있나요?

네, Claude Code와 Agent SDK에서 서브 에이전트는 메인 에이전트처럼 Skills에 액세스하고 사용할 수 있습니다. 이를 통해 전문 서브 에이전트가 재사용 가능한 강력한 조합을 만들어 냅니다.

예를 들어, python-developer 서브 에이전트는 pandas analysis Skills를 활용해 팀의 컨벤션에 따라 데이터 변환을 수행하고, 문서 작성자 서브 에이전트는 기술 작성 기술을 활용해 API 문서의 형식을 일관되게 유지하고 있습니다.

시작하기

Skills를 시작할 되셨나요? 시작하는 방법은 다음과 같습니다.

Claude.ai 사용자:

• 설정 → 기능에서 Skills를 활성화합니다.
• Claude.ai/projects에서 첫 번째 프로젝트를 생성합니다.
• 다음 분석 작업을 위해 프로젝트 지식과 Skills를 결합합니다.

API 개발자:

• 문서에서 Skills 엔드포인트를 살펴봅니다.
• Skills cookbook을 확인합니다.

Claude Code 사용자:

• 플러그인 마켓플레이스를 통해 Skills를 설치합니다.
• Skills cookbook을 확인합니다.