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

스킬을 도입한 이후, Claude의 에이전트 에코시스템의 다양한 구성 요소가 어떻게 상호 작용하는지 이해하려는 관심이 많았습니다.

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

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

에이전트 구성 요소 이해

스킬이란 무엇인가요?

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

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

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

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

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

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

프롬프트란 무엇인가요?

프롬프트는 대화 중에 자연스러운 언어로 Claude에 지침을 제시하는 것입니다. 일시적이고, 대화형이며, 반응형입니다. 그 순간의 맥락과 방향을 제시합니다.

프롬프트 사용 시기: 다음 용도로 프롬프트 사용:

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

예: 

이 코드에 대한 종합적인 보안 검토를 해주세요. 찾고 있는 것:

1. 일반적인 취약점은 다음과 같습니다.

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

2. 각 이슈에 대해 다음 정보를 제공해 주세요.

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

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

4. 추가 고려 사항:

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

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

프롬프트는 Claude와 소통하는 주요 수단이지만, 대화 전반에서 지속적으로 이어지지는 않습니다. 반복적인 워크플로우나 전문 지식의 경우, 프롬프트를 스킬이나 프로젝트 지침으로 캡처하는 것을 고려하세요.

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

프롬프트 라이브러리, 모범 사례를 확인하거나 스마트 프롬프트 메이커를 시작하세요.

프로젝트란 무엇인가요?

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

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

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

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

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

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

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

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

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

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

서브 에이전트 사용 시기: 서브 에이전트 사용

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

예:

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

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

MCP란 무엇인가요?

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

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

MCP 사용 시기: Claude가 다음을 수행해야 할 때 MCP 선택

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

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

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

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

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

진정한 힘은 이 두 가지 요소를 결합할 때 나옵니다. 각각은 서로 다른 목적을 위해, 이 둘을 함께 사용하면 정교한 에이전트 워크플로우가 만들어집니다.

비교: 올바른 도구 선택

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

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

1단계: 프로젝트 설정

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

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

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

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

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

MCP 서버 활성화:

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

3단계: 전문 스킬 생성

'경쟁 분석' 스킬을 개발하세요:

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

특수 서브 에이전트 생성:

시장 조사 하위 에이전트:

기술 분석가 서브 에이전트:

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

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

무슨 일이 일어날까요?

1. 프로젝트 컨텍스트 부하: Claude는 업로드된 리서치 문서에 액세스하고 프로젝트 지침을 따릅니다
2. MCP 연결 활성화: Claude가 Google Drive에서 최근 경쟁사 브리핑을 검색하고, GitHub 데이터를 가져옵니다
3. 스킬 참여: 경쟁사 분석 기술이 분석 프레임워크를 제공합니다
4. 서브 에이전트 실행(Claude Code에서): 시장 조사관은 업계 데이터를 수집하고, 기술 분석가는 기술 구현을 검토합니다
5. 프롬프트를 다듬습니다: "특히 헬스케어 분야의 기업 고객에게 집중하세요"

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

일반적인 질문

Skills는 어떻게 작동하나요?

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

이 아키텍처는 Claude의 컨텍스트 창에 부담을 주지 않으면서도 많은 Skills를 사용할 수 있음을 의미합니다. Claude는 필요한 정보에 정확히 액세스하고 있습니다.

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

Skills는 어떤 Claude 인스턴스나 로드하고 사용할 수 있는 기능을 원할 때 사용하세요. 스킬은 훈련 자료와 같습니다. 모든 대화에서 Claude가 특정 업무를 더 잘 수행하도록 돕습니다.

서브 에이전트는 워크플로우를 독립적으로 처리하는 완전하고 독립적인 에이전트가 필요할 때 사용하세요. 서브 에이전트는 고유한 컨텍스트와 도구 권한이 있는 전문 직원과 같습니다.

전문 지식을 가진 서브 에이전트가 필요할 때는 두 가지 기능을 함께 사용하세요. 예를 들어, 코드 검토 하위 에이전트는 언어별 모범 사례에 Skills를 활용할 수 있으며, 서브 에이전트의 독립성과 Skills의 재사용 가능한 전문 지식을 결합할 수 있습니다.

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

프롬프트 사용: 일회성 지침을 제공하거나, 즉각적인 상황을 제공하거나, 대화를 다시 시작할 때 프롬프트는 반응적이고 일시적입니다.

스킬을 활용할 때: 반복적으로 필요한 절차나 전문 지식을 보유하고 있을 때. 스킬은 사전 예방적이며, 언제 적용해야 할지 알고 있으며, 대화 전반에서 꾸준히 진행됩니다.

함께 활용하세요. 프롬프트와 스킬은 서로를 자연스럽게 보완합니다. Skills를 활용해 기초 전문 지식을 습득하고, 각 작업에 대한 구체적인 컨텍스트와 구체적인 정보를 제공할 수 있습니다.

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

프로젝트 활용: 특정 프로젝트를 위한 모든 대화에 정보를 제공하는 배경 지식과 맥락이 필요합니다. 프로젝트는 항상 로드되는 정적 참조 자료를 제공합니다.

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

지속적인 컨텍스트와 전문 역량을 모두 필요로 하는 경우 함께 사용하세요. 예를 들어, 제품 스펙과 사용자 리서치를 포함하는 '제품 개발' 프로젝트는 기술 문서를 생성하고 사용자 피드백 데이터를 분석하는 데 Skills와 결합되었습니다.

주요 차이점: 프로젝트는 "알아두셔야 할 사항은 다음과 같습니다."라고 말합니다. 스킬은 "이제 어떻게 해야할까요?"라고 말합니다. 프로젝트는 업무를 수행하는 데 필요한 지식 기반을 제공합니다. 스킬은 모든 대화, 프로젝트와 같은 모든 분야에서 활용할 수 있는 역량을 제공합니다.

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

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

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

시작하기

Skills를 활용해 만들어볼 준비가 되셨나요? 시작하는 방법은 다음과 같습니다.

Claude.ai 사용자:

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

API 개발자:

• 문서에서 Skills 엔드포인트 살펴보기
• 스킬 요리책을 확인하세요

Claude Code 사용자:

• 플러그인 마켓플레이스를 통해 Skills 설치
• 스킬 요리책
  을 확인하세요