지난 세 편에서 Claude Code의 기본 기능부터 중급 활용, 숨겨진 키워드들까지 다뤘습니다.

이번 글에서는 Claude Code의 가장 큰 변화 중 하나인 Skills와 Plugins를 다루려고 합니다. 2편에서 다뤘던 커스텀 명령어, 서브에이전트, Hooks, MCP 같은 것들이 이제 어떻게 하나의 패키지로 묶이고 공유되는지 살펴보겠습니다.

Skills가 뭔가요?

먼저 Skills부터 이야기해 보겠습니다.

Skills는 Claude가 특정 작업을 수행하는 방법을 가르치는 재사용 가능한 지침 패키지입니다. 쉽게 말하면, "이런 작업을 할 때는 이렇게 해"라는 플레이북을 Claude에게 미리 준비해 두는 거죠.

2편에서 다뤘던 커스텀 슬래시 명령어를 기억하시나요? .claude/commands/ 폴더에 마크다운 파일을 만들어서 /review, /commit 같은 명령어를 만드는 것 말이에요. Skills는 그것의 발전된 형태라고 생각하시면 됩니다.

Custom Commands와 Skills의 관계

사실 Anthropic이 공식적으로 이렇게 말했습니다.

Custom commands have been merged into skills.

즉 커스텀 명령어는 Skills로 통합됐습니다. 2편에서 다룬 .claude/commands/deploy.md 방식은 여전히 작동합니다. 하지만 이제 같은 기능을 .claude/skills/deploy/SKILL.md로 만들 수 있고, 두 방식 모두 /deploy 명령을 생성합니다.

그러면 왜 Skills로 바꿔야 할까요? Skills는 커스텀 명령어가 할 수 없는 몇 가지 기능을 추가로 제공합니다.

기능 Custom Commands Skills
슬래시 명령 실행 ✅ ✅
지원 파일 포함 (스크립트, 템플릿 등) ❌ ✅
Claude의 자동 호출 ❌ ✅
Frontmatter로 동작 제어 ❌ ✅
점진적 컨텍스트 로딩 ❌ ✅

특히 자동 호출이 큰 차이입니다. 커스텀 명령어는 사용자가 /deploy라고 명시적으로 입력해야 실행되는데, Skills는 description을 보고 Claude가 필요하다고 판단하면 알아서 호출합니다. 예를 들어 "이 코드 리뷰 좀 해줘"라고 말하면, Claude가 알아서 code-review 스킬을 호출하는 거죠.

Skills의 구조

Skills는 폴더입니다. 단순한 파일이 아니라 관련 리소스를 모두 담을 수 있는 디렉토리 구조를 가지고 있어요.

skill-name/
├── SKILL.md          # 필수 - 메인 지침서
├── scripts/          # 선택 - 실행 가능한 스크립트
├── references/       # 선택 - 참고 문서
└── assets/           # 선택 - 출력에 사용될 파일 (템플릿, 폰트 등)

각 폴더의 용도는 명확합니다.

  • scripts/: Python이나 Shell 스크립트 같은 실행 코드. 반복적이고 결정적인 작업에 사용
  • references/: Claude가 필요할 때 참조할 추가 문서들
  • assets/: 출력물에 사용할 템플릿, 폰트, 아이콘 같은 파일들

이렇게 디렉토리로 묶을 수 있기 때문에 "브랜드 가이드라인 적용"같이 관련 파일이 여러 개인 작업을 깔끔하게 패키징할 수 있습니다.

Skills 위치

Skills는 두 가지 위치에 설치할 수 있습니다.

위치 경로 범위
Personal ~/.claude/skills/ 전체 프로젝트에서 사용 가능
Project .claude/skills/ 해당 프로젝트에서만 사용 가능

Personal은 자주 쓰는 범용 스킬에, Project는 프로젝트별 규칙이나 워크플로우에 쓰면 됩니다. Project 스킬은 Git에 커밋해서 팀과 공유할 수 있어요.

SKILL.md 작성법

SKILL.md 파일은 두 부분으로 구성됩니다. YAML frontmatter와 마크다운 본문이죠.

---
name: explain-code
description: 코드를 시각적 다이어그램과 비유를 통해 설명합니다. 사용자가 "이게 어떻게 동작해?"라고 묻거나, 코드베이스 학습, 코드 동작 설명이 필요할 때 사용하세요.
---

# Explain Code

코드를 설명할 때 항상 다음 요소를 포함해야 합니다:

1. **비유로 시작**: 일상적인 것과 비교해서 설명
2. **다이어그램 그리기**: ASCII 아트로 흐름/구조/관계를 표현
3. **단계별 설명**: 무슨 일이 일어나는지 차근차근 설명
4. **함정 지적**: 흔한 실수나 오해는 무엇인지

설명은 대화체로 유지하세요. 복잡한 개념은 여러 비유를 사용하세요.

Frontmatter의 핵심 필드

필드 설명
name 스킬 이름. 폴더명과 일치해야 하고, /스킬명으로 호출 가능
description Claude가 이 스킬을 언제 사용해야 할지 판단하는 기준 (200자 이내)

description이 가장 중요합니다

description은 Claude가 "이 스킬을 써야 하나?"를 결정하는 유일한 근거입니다. Anthropic의 공식 skill-creator 문서에도 명시되어 있는데, 흥미로운 조언이 있어요.

Claude는 스킬을 과소 호출(undertrigger) 하는 경향이 있습니다.
이를 방지하려면 description을 조금 "pushy"하게 작성하세요.

예를 들면 이런 식입니다.

❌ 안 좋은 예시

description: 내부 데이터를 표시하는 간단한 대시보드 만들기

✅ 좋은 예시

description: 내부 데이터를 표시하는 간단한 대시보드 만들기. 사용자가 대시보드, 데이터 시각화, 내부 지표, 회사 데이터 표시를 언급할 때 반드시 이 스킬을 사용하세요. "dashboard"라는 단어를 명시하지 않아도 해당됩니다.

차이가 느껴지시죠? 트리거가 될 만한 키워드들을 명시적으로 나열하고, "반드시 사용하라"는 식으로 강한 표현을 쓰는 게 핵심입니다.

/create-skill - AI가 스킬을 만들어 줍니다

Skills를 직접 작성하는 게 부담스럽다면, Claude에게 맡기면 됩니다.

/create-skill

이 명령어를 실행하면 Claude가 대화식으로 스킬을 만들어 줍니다. "통합 테스트를 실행하고 디버깅하는 스킬이 필요해" 같이 설명만 해주면, 명확히 하기 위한 질문을 몇 개 던지고, 완성된 SKILL.md 파일과 디렉토리 구조를 자동으로 생성합니다.

더 재밌는 활용법도 있습니다. 복잡한 디버깅 세션을 마친 후에 "방금 우리가 디버깅한 과정을 스킬로 만들어줘"라고 하면, 그 다단계 절차를 재사용 가능한 스킬로 뽑아낼 수 있어요. 한 번 해결한 문제를 다시 만났을 때 쓸 수 있는 거죠.

Plugins - Skills를 하나로 묶는 단위

자, 이제 Plugins 이야기입니다.

여기까지 오면 한 가지 문제가 보입니다. Skills, 서브에이전트, Hooks, MCP 서버, 슬래시 명령어... 각자 따로 관리하고 공유하기가 은근히 귀찮거든요. 팀원에게 "이것저것 다 설치하고 설정해 줘"라고 말하기도 그렇고요.

Plugins는 이걸 해결합니다. Skills, Commands, Subagents, Hooks, MCP 서버를 하나로 묶어서 한 번에 설치하고 공유할 수 있는 패키지입니다.

my-plugin/
├── .claude-plugin/
│   └── plugin.json      # 플러그인 매니페스트 (필수)
├── skills/              # Skills
│   └── my-skill/
│       └── SKILL.md
├── agents/              # 서브에이전트
│   └── specialist.md
├── hooks/               # Hooks
│   └── hooks.json
└── .mcp.json            # MCP 서버 정의

2편에서 다룬 거의 모든 커스터마이징 요소를 하나의 플러그인 안에 담을 수 있습니다. 그리고 이 플러그인을 한 번의 명령으로 설치하거나 제거할 수 있죠.

Plugin Marketplace

플러그인을 배포하고 발견할 수 있는 마켓플레이스도 있습니다. 이게 진짜 강력한 부분이에요.

공식 마켓플레이스 - claude-plugins-official

Anthropic이 직접 운영하는 공식 마켓플레이스가 있습니다. Claude Code를 설치하면 자동으로 사전 설정되어 있어서 별도 추가 없이 바로 사용할 수 있어요.

2026년 기준으로 101개의 플러그인이 등록되어 있습니다.

  • Anthropic 제작 33개: 언어 서버(12개), 개발 워크플로우(10개), 셋업 도구(5개) 등
  • 파트너 플러그인 68개: GitHub, Playwright, Supabase, Figma, Vercel, Linear, Sentry, Stripe, Firebase 등

전체 목록은 claude.com/plugins에서 볼 수 있습니다.

마켓플레이스 사용법

/plugin 명령으로 플러그인 매니저 UI를 열 수 있습니다.

/plugin

탭이 네 개 있어요.

탭 내용
Discover 마켓플레이스에서 사용 가능한 플러그인 탐색
Installed 현재 설치된 플러그인 관리
Marketplaces 등록된 마켓플레이스 목록
Errors 플러그인 로딩 에러 확인

Discover 탭에서 원하는 플러그인을 찾아서 설치하면 됩니다. 설치 범위는 세 가지 중에 선택할 수 있어요.

  • User scope: 모든 프로젝트에서 사용 가능 (내 계정 전역)
  • Project scope: 현재 프로젝트에서만 사용 (Git에 커밋되어 팀원과 공유)
  • Local scope: 현재 저장소에서만 나만 사용

명령줄에서 직접 설치할 수도 있습니다.

/plugin install <plugin-name>@claude-plugins-official

예를 들어 Git 워크플로우 명령을 추가하는 commit-commands 플러그인은 이렇게 설치합니다.

/plugin install commit-commands@claude-plugins-official

추천 공식 플러그인

제가 직접 써보고 유용하다고 느낀 것들을 정리했습니다.

feature-dev - 기능 개발 워크플로우

복잡한 기능 개발을 위한 종합 워크플로우입니다. 코드베이스 탐색, 아키텍처 설계, 품질 검토를 담당하는 여러 전문 에이전트가 포함되어 있어요. 큰 기능 하나 만들 때 쓰기 좋습니다.

/plugin install feature-dev@claude-plugins-official

code-review - 자동 PR 리뷰

여러 전문 에이전트가 PR을 리뷰하고, 신뢰도 기반 스코어링으로 오탐을 걸러냅니다. 2편에서 직접 code-reviewer 서브에이전트를 만들었던 것보다 훨씬 정교합니다.

commit-commands - Git 워크플로우

Git 관련 반복 작업을 자동화합니다. 커밋 메시지 자동 생성, 변경사항 분석, PR 생성 같은 기능이 포함되어 있어요. 보리스 체르니의 /commit-push-pr 같은 명령어가 여기서 제공됩니다.

security-guidance - 보안 체크

코드의 보안 취약점을 자동으로 검사합니다. 민감한 정보 하드코딩, 권한 체크 누락 같은 것들을 잡아줍니다.

frontend-design - 프론트엔드 디자인

Claude의 기본 UI가 좀 "AI 스러운" 느낌이 있잖아요. 밋밋한 파란색과 흰색 템플릿에서 벗어나서, 독특하고 완성도 높은 프로덕션급 인터페이스를 만들도록 유도합니다.

context7 - 최신 라이브러리 문서

2편에서도 MCP 서버로 다뤘던 Context7이 이제는 플러그인 형태로도 제공됩니다. 최신 라이브러리 문서를 참조해서 구버전 API를 사용하는 실수를 방지합니다.

Next.js 15 App Router로 서버 컴포넌트 만들어줘. use context7

"use context7"을 붙이면 Claude가 자동으로 최신 문서를 찾아서 참고합니다.

커뮤니티 마켓플레이스

Anthropic 공식 마켓플레이스 외에도 커뮤니티에서 만든 마켓플레이스들이 많이 있습니다. 2026년 기준으로 2,500개 이상의 커뮤니티 마켓플레이스가 있고, 총 9,000개 이상의 플러그인이 존재합니다.

커뮤니티 마켓플레이스 추가

/plugin marketplace add <owner>/<repo>

GitHub 저장소의 owner/repo 형식만 넣으면 됩니다. 예를 들어 Anthropic이 운영하는 데모 마켓플레이스를 추가하려면

/plugin marketplace add anthropics/claude-code

유명한 커뮤니티 마켓플레이스

주의: 커뮤니티 마켓플레이스는 Anthropic의 검증을 받지 않습니다. 설치 전에 내용을 꼭 확인하세요. 특히 Hooks나 스크립트를 포함한 플러그인은 시스템 명령을 자동으로 실행할 수 있기 때문에 신뢰할 수 있는 소스에서만 설치하는 게 안전합니다.

Plugins의 진짜 가치

여기까지 읽고 나면 "그래서 이게 뭐가 좋은데?"라는 생각이 들 수 있습니다. 제가 느끼기에 Plugins의 진짜 가치는 세 가지입니다.

  1. 팀 공유가 쉬워집니다. 2편에서는 팀원에게 ".claude/commands/에 이 파일 복사하고, .claude/agents/에 저 파일 복사하고, .claude/settings.json에 이 설정 추가하고..."라고 설명해야 했습니다. 이제는 "/plugin install feature-dev@claude-plugins-official 치세요"로 끝납니다.
  2. 검증된 것들을 바로 쓸 수 있습니다. 처음부터 code-reviewer 서브에이전트나 Git 워크플로우 Hook을 만들 필요 없이, 이미 잘 만들어진 것들을 설치해서 쓰면 됩니다. 저도 처음에는 직접 만드는 재미가 있다고 생각했는데, 공식 플러그인들이 확실히 더 정교합니다.
  3. 생태계의 시작입니다. Plugins는 단순히 편의 기능이 아니라 Claude Code 생태계의 시작점입니다. VS Code가 Extension으로 생태계를 만들었던 것처럼, Plugins가 Claude Code의 생태계를 만들고 있어요. 앞으로 더 많은 플러그인이 나올 것이고, 좋은 플러그인 몇 개만 조합해도 엄청나게 생산성이 올라갈 겁니다.

마무리

이번 글에서 다룬 내용을 정리하면

  1. Skills: 커스텀 명령어의 발전된 형태. 자동 호출, 지원 파일 포함, 점진적 로딩 지원
  2. SKILL.md 작성법: frontmatter의 description이 핵심. 조금 "pushy"하게 작성할 것
  3. Skills 구조: scripts/, references/, assets/로 관련 리소스 패키징
  4. /create-skill: AI가 대화식으로 스킬을 만들어 줌
  5. Plugins: Skills, Commands, Subagents, Hooks, MCP를 하나로 묶는 패키지
  6. 공식 마켓플레이스: claude-plugins-official (자동사전 설정)
  7. 커뮤니티 마켓플레이스: 2,500개 이상, 총 9,000개 이상의 플러그인
  8. 추천 플러그인: feature-dev, code-review, commit-commands, security-guidance, frontend-design, context7

1편과 2편에서 다룬 "직접 만들어 쓰는" 시대에서 "설치해서 쓰는" 시대로 넘어왔다고 할 수 있습니다. 그리고 이게 끝이 아닙니다. Plugins 생태계는 계속 확장되고 있어요.

다음 글에서는 자동화와 자율 에이전트 — /loop, Scheduled Tasks, Auto Mode, Background Agents + Worktree, Remote Control, Computer Use 같은 기능들을 다룰 예정입니다. Claude Code가 점점 더 자율적으로 일하게 되는 과정을 살펴보겠습니다.

참고

저작자표시 (새창열림)

'Tech & Development > AI' 카테고리의 다른 글

Claude Managed Agents 출시 - 직접 살펴본 첫인상  (0) 2026.04.12
Claude Code 완벽 가이드 (5) - 자동화와 자율 에이전트  (0) 2026.04.10
Claude Code 완벽 가이드 (3) - 숨겨진 키워드와 Ultraplan, 그리고 미공개 기능들  (0) 2026.04.08
Harness Engineering: AI 에이전트를 제대로 부리는 법  (0) 2026.04.05
NVIDIA Isaac Lab on AWS: Physical AI 로봇 강화학습 워크샵 따라해보기  (0) 2026.04.03

티스토리툴바