클로드 코드(Claude Code) 스킬과 플러그인 차이 총정리 | 개념부터 설치·사용법까지

클로드 코드를 쓰다 보면 /plugin install이라는 명령도 보이고, '스킬'이라는 말도 자주 나옵니다. 둘 다 "클로드에게 새 능력을 준다"는 점이 같아서 처음엔 헷갈리기 쉽습니다. 이 글에서는 두 개념의 차이를 그림과 실제 예시로 정리해 봤습니다.

한 줄 요약: 스킬은 레시피, 플러그인은 밀키트 박스

• 스킬(Skill)은 클로드가 특정 일을 잘하게 만드는 레시피 한 장입니다. "이런 일이 오면 이 순서로, 이 도구를 써서 해라"라고 적어 둔 작업 설명서입니다.
• 플러그인(Plugin)은 레시피 여러 장에 재료와 도구까지 담아 한 번에 설치하게 만든 밀키트 박스입니다. 스킬뿐 아니라 에이전트, 훅, MCP 서버도 함께 들어갈 수 있습니다.

즉 스킬은 내용물이고, 플러그인은 그것을 담아 나눠 주는 포장과 배송 수단입니다.

스킬이란: 폴더 하나와 SKILL.md 파일 하나

스킬의 실체는 생각보다 단순합니다. SKILL.md라는 마크다운 파일이 든 폴더 하나입니다. 파일 맨 위에는 이름과 설명을 적고, 아래에는 클로드가 따라야 할 지침을 씁니다.

---
name: blog-post
description: 블로그 글을 쓸 때 사용. 제목, 도입, 본문, 마무리 구조로 작성한다.
---

# 블로그 글 쓰기

1. 독자가 누구인지 먼저 정한다.
2. 첫 문단에 결론을 쓴다.
3. 예시는 실제 명령어로 보여 준다.

• 저장 위치: 나만 쓰는 스킬은 ~/.claude/skills/스킬이름/, 팀원과 같이 쓰는 스킬은 프로젝트 안의 .claude/skills/스킬이름/에 둡니다.
• 부록 파일: 필요하면 같은 폴더에 스크립트, 템플릿, 참고 문서를 함께 넣을 수 있습니다.
• 필요할 때만 읽힘: 클로드는 평소에 이름과 설명만 알고 있다가, 지금 하는 일이 설명과 맞을 때 본문을 불러옵니다. 그래서 스킬을 많이 깔아도 대화가 무거워지지 않습니다.
• 호출 방법 두 가지: 클로드가 상황을 보고 알아서 꺼내 쓰거나, 내가 /blog-post처럼 슬래시 명령으로 직접 부릅니다.

따로 설치 과정도 없습니다. 폴더를 만들어 넣으면 그걸로 끝입니다.

플러그인이란: 여러 기능을 묶어 배포하는 패키지

플러그인은 스킬, 에이전트, 훅, MCP 서버 같은 확장 기능을 하나로 묶어 다른 사람에게 나눠 주기 위한 포장 단위입니다. 폴더 안에 .claude-plugin/plugin.json이라는 명세 파일(이름, 버전, 설명)이 있고, 그 옆에 담을 기능들이 폴더별로 들어갑니다.

• 스킬(skills/): 위에서 본 SKILL.md 폴더들이 여러 개 들어갑니다.
• 에이전트(agents/): 특정 역할만 맡는 보조 클로드(서브에이전트) 설정입니다.
• 훅(hooks/): "파일을 고친 뒤엔 항상 포매터를 돌려라"처럼 특정 시점에 자동 실행되는 규칙입니다.
• MCP 서버(.mcp.json): 브라우저, 웹 검색, 사내 시스템 같은 외부 도구를 클로드에 연결합니다.

설치는 마켓플레이스에서 명령 한 줄로 합니다. 플러그인에 든 스킬은 다른 스킬과 이름이 겹치지 않도록 플러그인이름:스킬이름 형태로 불립니다.

/plugin install firecrawl@claude-plugins-official

한눈에 비교

구분	스킬	플러그인
정체	작업 지침서 (SKILL.md)	여러 기능을 담은 배포 패키지
담는 것	지침 + 선택적 스크립트·템플릿	스킬, 에이전트, 훅, MCP 서버
설치	폴더를 복사해 넣으면 끝	/plugin install 이름@마켓플레이스
공유	프로젝트 저장소에 커밋	마켓플레이스로 배포, 버전 관리
호출 이름	/blog-post	/firecrawl:firecrawl-scrape

실제 예시: 플러그인을 깔면 스킬이 따라온다

저는 이번에 클로드 코드에 플러그인 두 개를 설치했습니다.

/plugin install firecrawl@claude-plugins-official
/plugin install chrome-devtools-mcp@claude-plugins-official

명령은 두 줄이지만, 설치 후 사용할 수 있는 스킬 목록에는 훨씬 많은 항목이 생겼습니다.

• firecrawl 플러그인 → firecrawl:firecrawl-search(웹 검색), firecrawl:firecrawl-scrape(페이지 읽기), firecrawl:firecrawl-crawl(사이트 통째로 수집) 등 10개가 넘는 스킬
• chrome-devtools-mcp 플러그인 → 크롬 개발자 도구를 다루는 MCP 서버와 함께 chrome-devtools-mcp:debug-optimize-lcp(페이지 로딩 속도 진단), chrome-devtools-mcp:a11y-debugging(접근성 점검) 같은 스킬

여기서 차이가 잘 보입니다. 플러그인은 박스이고, 실제로 일을 하는 건 박스에서 나온 스킬과 MCP 서버입니다. 특히 chrome-devtools-mcp처럼 "도구(MCP 서버) + 그 도구를 잘 쓰는 방법(스킬)"을 한 번에 배달할 수 있다는 게 플러그인의 장점입니다.

언제 무엇을 쓸까

• 스킬을 직접 만들 때: 나 혼자, 혹은 우리 프로젝트에서 반복하는 작업 방식이 있을 때입니다. "우리 회사 보고서 양식대로 써 줘", "배포 전 체크리스트를 따라 줘" 같은 것은 SKILL.md 한 장이면 충분합니다.
• 플러그인으로 묶을 때: 스킬 여러 개에 MCP 서버나 훅까지 함께 줘야 하거나, 여러 사람·여러 프로젝트에 같은 구성을 배포하고 업데이트해야 할 때입니다.
• 그냥 쓰기만 할 때: 대부분은 이미 만들어진 플러그인을 /plugin으로 찾아 설치하는 것만으로 충분합니다.

마무리

정리하면 스킬은 클로드가 일하는 방법을 적은 레시피이고, 플러그인은 그 레시피와 도구를 묶어 배달하는 밀키트 박스입니다. 처음이라면 자주 하는 작업 하나를 골라 ~/.claude/skills/에 SKILL.md를 하나 만들어 보세요. 스킬이 여러 개로 늘고 남에게도 주고 싶어질 때, 그때 플러그인으로 묶으면 됩니다.