정의

Claude Code 플러그인의 진입 파일 — .claude-plugin/plugin.json. Skills·Subagents·Hooks·MCP·LSP·monitors 를 하나의 배포 단위 로 묶는 메타데이터.

핵심 필드

{
  "name": "my-plugin",          // 식별자 + skill 네임스페이스 (예: /my-plugin:hello)
  "description": "...",         // 마켓플레이스 표시
  "version": "1.0.0",           // 변경 시 사용자 업데이트. 생략 + git → 커밋 SHA
  "author": { "name": "..." },
  "homepage": "...",
  "repository": "...",
  "license": "MIT"
}

★ 일반적 실수 주의

commands/, agents/, skills/, hooks/ 를 .claude-plugin/ 내에 넣지 말기. .claude-plugin/ 내에는 plugin.json 만. 다른 디렉토리는 플러그인 루트 수준.

★ 네임스페이싱

플러그인 skills 는 항상 네임스페이스 지정 — /plugin-name:skill-name.

• 여러 플러그인이 동일 이름 skills → 충돌 방지
• 네임스페이스 접두사 변경 → plugin.json 의 name 필드

디렉토리 표준

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/<name>/SKILL.md
├── commands/<name>.md            # 구 형식 (새 = skills/)
├── agents/<name>.md
├── hooks/hooks.json
├── .mcp.json
├── .lsp.json
├── monitors/monitors.json
├── bin/                          # 실행 파일 → 활성 시 Bash PATH
├── settings.json                 # 활성 시 기본 설정
└── README.md

★ claude-md-management 의 구현

→ lesson/anthropic-claudemd-management 의 작동 원리.

강의 활용

• Ch8 §8.1 — 공식 플러그인 구조 설명 (마켓플레이스 설치 명령 직전 단계)
• Ch6 §6.4 — Plugins = 4 층 인프라의 배포 단위 차원