11. 스킬과 플러그인 생태계¶

매번 같은 요청을 반복하고 있다면, 그건 스킬로 만들 수 있다는 신호예요. 스킬과 플러그인을 쓰면 반복 작업을 명령 하나로 줄일 수 있습니다.

스킬이란?¶

스킬은 Claude Code에서 재사용할 수 있는 전문 기능 묶음입니다.

[스킬 없이]
매번: "한국어 문법 검사해줘. 띄어쓰기, 맞춤법, 조사 사용..."
     → 긴 설명 반복

[스킬 사용]
/grammar-checker
     → 전문화된 규칙이 자동 적용

스킬 2.0 변경: 기존 커스텀 커맨드(.claude/commands/)가 스킬로 통합됐어요. 기존 파일은 그대로 작동하고, 스킬은 지원 파일·모델 지정·서브에이전트 실행 같은 기능이 추가된 상위 호환입니다.

번들 스킬 (기본 제공)¶

Claude Code에 기본으로 내장된 스킬이에요. 설치 없이 바로 쓸 수 있습니다.

/simplify          → 최근 변경 코드를 3개 에이전트가 병렬 리뷰 후 개선
/batch <지시>       → 코드베이스 전체에 대규모 변경을 병렬 처리
/debug [설명]       → 현재 세션 디버그 로그 분석

/simplify: 기능 구현 후 실행하면 재사용성, 품질, 효율성을 검토해 정리해줍니다.
/batch: "src/ 전체를 React에서 Vue로 마이그레이션"처럼 큰 작업을 자동으로 5~30개 단위로 분해 후 병렬 실행.
/debug: 세션이 이상하게 동작할 때 로그를 직접 분석해줍니다.

커뮤니티 스킬 활용¶

humanizer: AI 글을 자연스럽게¶

한국어로 글 쓸 때 AI 특유의 딱딱한 느낌이 남을 때가 있죠. humanizer 스킬은 언어학 연구 기반(KatFishNet 논문, 94.88% AUC)으로 AI 냄새를 없애줍니다.

/humanizer

감지하는 24가지 패턴

쉼표 과다 사용
띄어쓰기 경직성
AI 특유 어휘 과용 ("활용", "다양한", "효과적인")
구조적 단조로움 (모든 문단이 비슷한 길이)
대명사/복수형 과다

사용 시점: 문서 작성, README, 블로그 글, 사내 공지 등 사람이 읽을 글을 쓸 때

grammar-checker: 한국어 문법 검사¶

/grammar-checker

표준 한국어 규칙에 기반한 검사를 합니다.

맞춤법 오류 (되/돼, -ㄴ지/-는지)
띄어쓰기 오류 (의존명사, 보조용언)
문법 오류 (조사 사용, 시제)
구두점 문제

style-guide: 스타일 일관성¶

/style-guide

프로젝트 전체에서 일관된 작성 스타일을 유지합니다.

어조 (경어체/반말) 불일치 감지
용어 통일 (사용자/유저, 삭제/제거)
숫자/날짜 형식 일관성

스킬 찾기와 설치¶

Agent Skills 개방형 표준¶

스킬 생태계가 하나의 공개 표준으로 통합됐어요. agentskills.io가 그 중심입니다.

Claude Code뿐 아니라 Cursor, Copilot, Codex, Gemini CLI, JetBrains Junie, Roo Code 등 30+ 도구가 같은 SKILL.md 포맷을 씁니다. 한 번 만들면 어디서든 쓸 수 있어요.

1. Anthropic 공식 스킬 (추천)¶

Anthropic이 직접 만든 공식 스킬 저장소예요. 가장 안전하고 검증된 스킬입니다.

github.com/anthropics/skills

카테고리	스킬 예시	설명
Document	DOCX, PDF, PPTX, XLSX	문서 생성/편집
Creative	아트, 디자인	창작 작업
Development	웹 테스팅, MCP 서버 생성	기술 자동화
Enterprise	브랜드 가이드, 워크플로우	조직 업무

# Claude Code에서 공식 스킬 설치
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

2. Context7 스킬 디렉토리¶

context7.com/skills에서 커뮤니티 스킬을 검색할 수 있습니다.

# Context7 CLI로 스킬 설치
npx ctx7 skills install <owner/repo>

3. agentskill.sh (가장 큰 디렉토리)¶

110,000+ 스킬, 보안 점수까지 제공하는 최대 규모 마켓플레이스예요.

agentskill.sh
카테고리: Development(82k+), Operations(12k+), Data(10k+), Product(6k+) 등
스킬마다 보안 점수(Security Score) 제공

# Claude Code에서 바로 설치
/learn @owner/skill-name

4. skillsdirectory.com¶

36,000+ 스킬, 보안 스캔이 기본 적용돼 있어요.

skillsdirectory.com
전체 스킬의 36%에서 보안 결함 탐지 → 검증된 스킬만 추천

npm install -g openskills

5. LobeHub Marketplace¶

100,000+ 스킬, 웹에서 미리보기 가능합니다.

lobehub.com/skills

주요 메트릭¶

지표	의미	확인 포인트
Trust Score	스킬의 신뢰도 점수	높을수록 안전
Weekly Installs	주간 설치 수	많을수록 검증됨
Source	스킬 출처	신뢰할 수 있는 출처인지 확인

커뮤니티 스킬 보안 주의사항¶

커뮤니티 스킬은 누구나 올릴 수 있습니다. 반드시 주의하세요.

⚠️ 설치 전 체크리스트:

1. Trust Score 확인 → 낮은 점수는 경계
2. Weekly Installs 확인 → 설치 수 0~극소수는 검증 안 됨
3. Source 코드 직접 확인 → SKILL.md 내용 읽어보기
4. 의심스러운 코드 실행 여부 → 시스템 명령어, 네트워크 요청 주의
5. 알려진 제작자인지 확인 → GitHub 프로필, 활동 이력

안전한 순서: Anthropic 공식 → Trust Score 높은 커뮤니티 → 직접 만들기

6. OMC 스킬 관리¶

# 설치된 스킬 목록
/oh-my-claudecode:skill list

# 새 스킬 추가
/oh-my-claudecode:skill add [스킬 경로]

# 스킬 검색
/oh-my-claudecode:skill search [키워드]

기존 스킬 찾아서 개선하기¶

처음부터 만들지 마세요. 비슷한 스킬이 이미 있을 가능성이 높아요.

워크플로우: 검색 → 평가 → 포크 → 커스터마이즈 → 테스트 → 공유

# 1. 필요한 스킬 검색
agentskill.sh에서 "code review" 검색
또는 Claude에게 직접 물어보기:
> 코드 리뷰 관련 스킬 있어?

# 2. 보안 점수와 설치 수 확인
Security Score 80+ 이면 안전
Weekly Installs 높을수록 검증됨

# 3. 설치 후 커스터마이즈
/learn @anthropics/skill-creator
→ SKILL.md를 내 프로젝트에 맞게 수정

# 4. 팀 저장소에 공유
.claude/skills/ 에 저장 → git push

Anthropic 공식 skill-creator 스킬을 쓰면 스킬을 만들고, 수정하고, 품질까지 평가해줘요. 스킬을 위한 메타 스킬입니다.

스킬 품질 평가 기준¶

기준	좋은 스킬	나쁜 스킬
Security Score	80+	50 미만
description	구체적, 트리거 조건 명확	모호, 너무 넓음
크기	SKILL.md 500줄 이하	거대한 단일 파일
도구 제한	allowed-tools 명시	제한 없음

직접 스킬 만들기¶

반복되는 작업이 있으면 스킬로 만들어서 다음부터 다시 쓰세요.

스킬 저장 위치¶

위치	경로	적용 범위
개인	`~/.claude/skills/<skill-name>/`	모든 프로젝트
프로젝트	`.claude/skills/<skill-name>/`	이 프로젝트만
플러그인	`<plugin>/skills/<skill-name>/`	플러그인 설치된 곳

스킬 구조¶

.claude/skills/
└── my-skill/
    ├── SKILL.md        ← 스킬 정의 파일 (필수)
    ├── references/     ← 참조 문서 (필요할 때 로드)
    └── scripts/        ← 실행 스크립트

SKILL.md 작성법¶

---
name: api-response-formatter
description: API 응답을 팀 표준 형식으로 변환. API 핸들러 작성 시 자동 적용.
allowed-tools: Read, Grep
---

# API Response Formatter

## 목적
모든 API 응답을 다음 형식으로 통일합니다.

## 표준 응답 형식
\```json
{
  "success": true,
  "data": {},
  "error": null,
  "meta": {
    "timestamp": "ISO-8601",
    "requestId": "uuid"
  }
}
\```

## 규칙
1. 성공 응답: success=true, data에 결과, error=null
2. 실패 응답: success=false, data=null, error에 상세
3. 모든 응답에 meta.timestamp 필수

SKILL.md 프론트매터 전체 필드¶

필드	설명
`name`	슬래시 커맨드 이름. 생략하면 디렉토리명 사용
`description`	Claude가 스킬을 자동 활성화할 시기를 결정하는 설명 (권장)
`argument-hint`	자동완성 힌트 (예: `[issue-number]`)
`disable-model-invocation`	`true`면 Claude가 자동 실행 불가, `/name`으로만 호출
`user-invocable`	`false`면 `/` 메뉴에서 숨김 (Claude만 호출 가능)
`allowed-tools`	이 스킬 활성화 시 허용할 도구 목록
`model`	이 스킬 실행 시 사용할 모델
`context`	`fork`로 설정하면 격리된 서브에이전트에서 실행
`agent`	`context: fork` 시 사용할 서브에이전트 유형
`hooks`	스킬 라이프사이클에 연결할 훅

모델 지정하기¶

스킬마다 다른 모델을 쓸 수 있어요. 복잡한 분석엔 Opus, 빠른 포맷팅엔 Haiku.

---
name: deep-reviewer
description: 보안·아키텍처 관점의 심층 코드 리뷰
model: claude-opus-4-6
---

보안 취약점, 아키텍처 설계, 성능 병목을 깊이 분석합니다...

---
name: quick-formatter
description: 코드 빠른 포맷팅
model: claude-haiku-4-5
---

주어진 코드를 팀 스타일 가이드에 맞게 포맷합니다...

자동 호출 vs 수동 호출 제어¶

# 수동 호출만 허용 (배포, 커밋처럼 타이밍이 중요한 작업)
---
name: deploy
description: 프로덕션 배포
disable-model-invocation: true
---

# Claude만 내부 참조용으로 사용 (사용자 메뉴에서 숨김)
---
name: legacy-context
description: 레거시 시스템 동작 방식. 레거시 관련 코드 작업 시 참조.
user-invocable: false
---

서브에이전트에서 실행하기¶

context: fork를 쓰면 격리된 서브에이전트가 스킬을 실행하고 결과를 반환해요. 메인 세션 컨텍스트를 오염시키지 않아서 대규모 탐색에 유용합니다.

---
name: deep-research
description: 특정 주제를 코드베이스에서 철저히 조사
context: fork
agent: Explore
---

$ARGUMENTS 주제를 철저히 조사합니다:

1. Glob, Grep으로 관련 파일 탐색
2. 코드 읽고 분석
3. 파일 참조 포함한 결과 요약

agent 옵션: Explore (읽기 전용 탐색), Plan (계획 수립), general-purpose (기본).

learner로 자동 생성¶

직접 안 써도 됩니다. learner 스킬이 대화 패턴에서 알아서 뽑아줘요.

# 대화 중 반복 패턴이 보이면
/oh-my-claudecode:learner

# Claude가 분석 후 스킬 제안
Claude: "다음 패턴을 스킬로 등록할 수 있습니다:
- API 응답 형식 통일
- 에러 핸들링 패턴
등록할까요?"

> 응

# .claude/skills/ 에 자동 저장

직접 플러그인 만들기¶

💡 실전 사례: spot-orbit-plugin은 Boston Dynamics Spot/Orbit API 개발을 위해 만든 Claude Code 플러그인이에요. MCP 서버로 API에 직접 접근하고, PreToolUse Hook으로 안전 가드레일을 설정하고, 32개 참조 문서로 도메인 지식을 제공합니다. 이런 수준의 플러그인을 직접 만들고 싶다면 직접 만들기 가이드를 참고하세요.

스킬보다 더 복잡한 게 필요하면 플러그인을 만들 수도 있어요.

플러그인 vs 스킬¶

	스킬	플러그인
복잡도	단일 SKILL.md	여러 파일 + 설정
범위	특정 작업	시스템 확장
배포	로컬 또는 공유	마켓플레이스
만드는 시간	5분	수 시간~

시작하기¶

# Claude에게 직접 요청
> 우리 팀에서 쓸 플러그인 만들어줘.
> 기능: PR 생성 시 자동으로 Jira 이슈 상태 변경
> 트리거: /commit-push-pr 실행 후

서브에이전트 활용¶

.claude/agents/ 디렉토리¶

프로젝트 전용 에이전트를 만들 수 있습니다.

.claude/agents/
├── code-reviewer.md      ← 코드 리뷰 전문가
├── planner.md            ← 계획 수립 전문가
└── security-checker.md   ← 보안 검사 전문가

에이전트 정의 예시¶

---
name: api-designer
description: REST API 설계 전문가. API 엔드포인트 설계 시 사용.
model: claude-opus-4-6
---

## 규칙
1. RESTful 원칙 준수
2. OpenAPI 3.0 스펙 기반
3. 버전 관리: /api/v1/ 형식
4. 에러 응답: RFC 7807 Problem Details

실전: 스킬 개발 워크플로우¶

1단계: 반복 패턴 발견¶

"매번 이거 똑같이 요청하네..."
"이 형식으로 계속 변환하는데..."

2단계: learner로 추출하거나 직접 작성¶

# 자동 추출
/oh-my-claudecode:learner

# 또는 직접 작성
> .claude/skills/my-formatter/ 에 SKILL.md 만들어줘

3단계: 테스트¶

> 방금 만든 스킬 테스트해볼게.
> [테스트 입력 제공]

4단계: 팀 공유¶

# git으로 공유
git add .claude/skills/
git commit -m "feat: API 응답 포맷터 스킬 추가"
git push

실천 체크리스트¶

/simplify 로 최근 변경 코드 리뷰 실행
/humanizer 로 한국어 글 다듬기 시도
/grammar-checker 로 문법 검사 실행
/oh-my-claudecode:learner 로 대화 패턴 스킬화 시도
.claude/skills/ 에 간단한 스킬 하나 직접 만들기
스킬 프론트매터에 model 필드로 모델 지정해보기

다음 단계¶

스킬과 플러그인 생태계를 이해했다면 12. AI와 함께 일하는 방법에서 AI를 활용하는 근본적인 철학을 알아보세요.

참고 자료:

Claude Code 공식 스킬 문서 - 스킬 2.0 전체 레퍼런스
Anthropic 공식 스킬 - 검증된 공식 스킬 저장소
Context7 스킬 디렉토리 - 커뮤니티 스킬 검색 (Trust Score 확인 필수)
Agent Skills 표준 - 개방형 스킬 표준 스펙
agentskill.sh - 110,000+ 스킬 디렉토리
skillsdirectory.com - 보안 검증 스킬 디렉토리
LobeHub Marketplace - 100,000+ 스킬 마켓
humanizer 스킬 - AI 글 자연화
oh-my-claudecode 스킬 가이드