Claude 플러그인과 스킬의 차이 정리

개념 한 줄 정의

Claude 스킬은 "특정 상황에서 Claude가 자동으로 불러와 쓰는 지식·절차 단위"이고,
Claude 플러그인은 "스킬·명령·서브에이전트 등을 하나로 묶어 다른 사람과 공유·배포하는 패키지"에 가깝다.¹

같은 Claude Code 생태계 안에서 스킬은 기능 단위, 플러그인은 그 기능들을 묶은 배포 단위라고 이해하면 편하다.¹

Claude 스킬이란 무엇인가

스킬은 SKILL.md 파일로 정의하는 "확장 가능한 능력 단위"다.³
Claude는 이 파일의 설명(description)과 내용을 보고, 대화 맥락에 필요하다고 판단되면 자동으로 불러와서 사용하거나, 사용자가 직접 /skill-name 으로 호출할 수 있다.³

스킬의 핵심 특징은 다음과 같다.

스킬은 기본적으로 "자동 호출 가능한 컨텍스트 제공자" 역할을 한다.¹ 특정 프로젝트의 도메인 지식, 개인 작업 스타일, 코드베이스 규칙, 배포 절차 같은 것을 스킬로 만들어 두면, 관련 대화를 할 때 Claude가 알아서 그 내용을 자신의 "도구 상자"에 추가해 활용한다.¹³

스킬은 위치에 따라 적용 범위가 달라진다.
~/.claude/skills/<skill>/SKILL.md 에 두면 내 모든 프로젝트에서,
각 프로젝트의 .claude/skills/<skill>/SKILL.md 에 두면 그 프로젝트 안에서만 쓰인다.³
플러그인 안의 <plugin>/skills/<skill>/SKILL.md 에 포함시키면, 해당 플러그인이 활성화된 범위에서만 동작한다.³

스킬은 단순한 지식 참조용일 수도 있고, /deploy, /fix-issue 123 같은 작업형 워크플로우일 수도 있다.³
작업형일 때는 disable-model-invocation: true 를 설정해 "Claude가 임의로 실행하지 못하게 하고, 사용자 slash 명령으로만 실행되도록" 제어할 수 있다.³

또한 스킬은 Agent Skills 표준을 따르기 때문에, 이 형식을 지원하는 다른 AI 도구에서도 재사용 가능한 "포터블한 능력 정의"라는 의미도 갖는다.³

실무 감각으로 보면, 스킬은 "잘 구조화된 장문의 시스템 프롬프트를 파일로 쪼개 두고, 필요할 때만 자동으로 꺼내 쓰는 구조"라고 이해하면 된다.⁴

Claude 플러그인이란 무엇인가

플러그인은 Claude Code에서 여러 요소를 하나로 묶어 "설치 가능한 확장 패키지"에 해당한다.¹²

한 플러그인 안에는 스킬, slash 명령(커맨드), 서브에이전트, 훅, 설정 파일 등이 함께 들어갈 수 있다.¹
다시 말해, 플러그인은 "실제 업무 환경에서 쓰는 전체 세트(워크플로우 + 지식 + 자동화)를 포장해서 다른 사람에게 배포할 수 있는 단위"다.¹

예를 들어, 특정 팀의 제품 리서치 워크플로우를 생각해 보면,
경쟁사 리서치 slash 명령, 리서치 결과를 정리하는 스킬, 데이터를 정제하는 서브에이전트, 공통 스타일 가이드가 모두 하나의 플러그인으로 묶여서 팀 내에 배포될 수 있다.¹²

이런 구조 덕분에, 플러그인은 "내가 세팅한 Claude 환경을 그대로 다른 사람에게 넘길 수 있는 공유·재사용 수단"이 된다.
스킬이 Claude의 "개별 능력"이라면, 플러그인은 "그 능력들을 조합한 하나의 제품 또는 키트"에 가깝다.

플러그인 vs 스킬: 역할과 책임의 차이

관점별로 정리하면 차이가 명확해진다.

기능 범위 관점에서, 스킬은 하나의 명확한 목적을 가진 능력 또는 지식 단위다. 예를 들어 "이 코드베이스의 API 규칙", "내 개인 업무 스타일", "이 레포에서 배포하는 절차" 같은 것에 해당한다.¹³
플러그인은 이러한 여러 스킬과 명령, 서브에이전트, 훅을 조합해 하나의 완성된 워크플로우 패키지를 구성한다.¹

호출 방식 관점에서, 스킬은 Claude가 자체적으로 "언제 쓸지" 판단해 자동으로 로드하거나, 사용자가 /skill-name 으로 직접 호출하는 단위다.¹³
플러그인은 사용자가 "이 플러그인을 프로젝트/환경에 추가"하는 것으로 활성화되고, 그 안의 스킬과 명령들이 이후에 사용 가능해진다. 즉 플러그인 자체가 직접 호출 대상이라기보다, 여러 호출 가능한 요소를 묶는 컨테이너 역할에 가깝다.¹²

재사용/공유 관점에서, 스킬은 기본적으로 로컬(개인 또는 프로젝트)에 두고 쓰는 것이 기본이고, 필요하면 플러그인 안에 넣어 간접적으로 공유한다.³
플러그인은 처음부터 "공유·배포"를 전제로 만들어진 구조다. 팀 단위, 조직 단위, 혹은 마켓플레이스를 통해 다른 사용자와 구성을 주고받는 수단이 된다.¹

구현 관점에서, 스킬은 SKILL.md와 그 주변 파일 구조, YAML 프런트매터로 정의되는 "파일 기반 능력 정의"다.³
플러그인은 파일·디렉터리 구조 전체(스킬 디렉터리, commands 디렉터리, 설정 파일 등)를 포함하는 더 상위 레벨의 패키지다.¹

이렇게 보면, 스킬은 "Claude가 무엇을 어떻게 할지"에 대한 정의이고,
플러그인은 "어떤 스킬·명령·에이전트들을 하나의 도구 세트로 묶어, 어디에서 사용 가능하게 할지"를 정의한다고 볼 수 있다.

언제 스킬을 쓰고, 언제 플러그인을 쓸까

사용자 관점에서 의사결정을 단순화하면 다음과 같다.¹²³

Claude가 특정 지식이나 규칙을 자동으로 기억하고 적용했으면 좋겠다면 스킬을 만든다. 예를 들어 "내 이메일 톤과 글쓰기 스타일", "이 프로젝트의 코드 스타일 가이드", "이 팀의 기획 문서 템플릿"처럼, 대화 맥락만 맞으면 항상 끼워 넣고 싶은 내용은 스킬이 적합하다.¹³

특정 작업 절차를 한 번에 자동화하고 싶다면, slash 명령과 스킬, 서브에이전트를 조합한다. 예를 들어 "/deploy", "/fix-issue 123", "/competitive-research" 같은 건 절차형 스킬 또는 slash 명령으로 구현하는 것이 자연스럽다.²³

이렇게 만든 환경을 팀원 전체와 공유하고 싶거나, 여러 프로젝트에서 재사용 가능한 세트로 배포하고 싶다면 플러그인으로 묶는다. 다른 사람도 같은 스킬과 명령, 서브에이전트 구성을 그대로 쓸 수 있게 하는 것이 플러그인의 주요 목적이다.¹²

정리하면, 개인이나 특정 프로젝트 안에서 "Claude의 능력을 세분화해서 구조화"하는 단계에서는 스킬이 중심이고,
그 구조화된 능력을 "여러 사람·여러 환경에서 통째로 재사용"하는 단계에서는 플러그인이 중심이 된다.

한 문단 요약

Claude 스킬은 SKILL.md 기반의 "자동·수동 호출 가능한 능력/지식 단위"이고,
Claude 플러그인은 이런 스킬과 명령, 서브에이전트들을 모아 "설치·공유 가능한 확장 패키지"로 만든 것이다.¹³

스킬로는 Claude의 똑똑한 '기억'과 작업 절차를 잘게 정의하고,
플러그인으로는 그 정의들을 팀과 조직, 마켓플레이스 수준으로 확장·배포한다고 이해하면 된다.¹²

참고

¹Understanding Claude Code: Skills vs Commands vs Subagents vs Plugins | #95

²How to Use Claude Code: A Guide to Slash Commands, Agents, Skills, and Plug-Ins

³Extend Claude with skills - Claude Code Docs

⁴Claude Skills | Hacker News