Plugin Directory
├── .claude-plugin/
│   └── plugin.json        (Manifest: name, version, component paths)
├── skills/skill-name/
│   └── SKILL.md           (Skill instructions + frontmatter)
├── agents/
│   └── agent-name.md      (Agent system prompt + frontmatter)
├── hooks/
│   └── hooks.json         (Event handlers: PreToolUse, PostToolUse, ...)
├── .mcp.json              (MCP server definitions)
├── .lsp.json              (LSP server configs)
└── scripts/               (Helper scripts for hooks/MCP)

# 安装到用户作用域（默认，适用于所有项目）
claude plugin install plugin-name

# 安装到项目作用域（写入.claude/settings.json，可提交版本库）
claude plugin install plugin-name --scope project

# 安装到本地作用域（写入.claude/settings.local.json，不提交版本库）
claude plugin install plugin-name --scope local

# 从指定市场安装
claude plugin install formatter@my-marketplace

# 卸载插件
claude plugin uninstall plugin-name

# 禁用插件（保留配置，下次可快速启用）
claude plugin disable plugin-name

# 重新启用插件
claude plugin enable plugin-name

# 更新插件到最新版本
claude plugin update plugin-name

# 加载单个插件
claude --plugin-dir ./my-plugin

# 同时加载多个插件
claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # 插件清单（可选，不存在时自动探索）
├── skills/                  # Skills组件
│   └── greet/
│       └── SKILL.md
├── agents/                  # Agents组件
│   └── reviewer.md
├── hooks/                   # Hooks组件
│   └── hooks.json
├── .mcp.json                # MCP服务器定义
├── .lsp.json                # LSP服务器配置
├── scripts/                 # Hook和MCP使用的辅助脚本
│   └── format.sh
└── settings.json            # 插件默认设置

{
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "A sample plugin demonstrating core features",
  "author": {
    "name": "Your Name",
    "email": "you@example.com",
    "url": "https://github.com/you"
  },
  "homepage": "https://github.com/you/my-plugin",
  "repository": "https://github.com/you/my-plugin",
  "license": "MIT",
  "keywords": ["development", "automation"]
}

{
  "hooks": {
    "PostToolUse": [{
      "hooks": [{
        "type": "command",
        "command": "${CLAUDE_PLUGIN_ROOT}/scripts/format.sh"
      }]
    }]
  }
}

code-review-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── review/
│       └── SKILL.md
└── hooks/
    └── hooks.json

{
  "name": "code-review",
  "version": "1.0.0",
  "description": "Code review skill with automated test hook",
  "author": { "name": "Dev Team" }
}

---
name: review
description: Performs comprehensive code review. Use when reviewing code changes, PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code clarity and readability
2. Error handling completeness
3. Potential security vulnerabilities
4. Test coverage gaps
5. Performance concerns

Provide feedback in a structured format with severity levels: CRITICAL, WARNING, SUGGESTION.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs -I{} sh -c 'echo {} | grep -q \\.js$ && npx eslint {} --fix || true'"
          }
        ]
      }
    ]
  }
}

ts-quality-plugin/
├── .claude-plugin/
│   └── plugin.json
├── hooks/
│   └── hooks.json
└── scripts/
    └── check.sh

#!/bin/bash
# Receive hook context from stdin
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')

if [[ "$FILE_PATH" == *.ts || "$FILE_PATH" == *.tsx ]]; then
  echo "Running type check on $FILE_PATH..."
  npx tsc --noEmit 2>&1 | head -20
fi

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/check.sh"
          }
        ]
      }
    ]
  }
}

chmod +x ts-quality-plugin/scripts/check.sh

claude plugin install ts-quality@team-marketplace --scope project

db-tools-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── query/
│       └── SKILL.md
├── .mcp.json
└── servers/
    └── db-server        # 编译好的MCP服务器二进制

{
  "mcpServers": {
    "db-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_PATH": "${CLAUDE_PLUGIN_ROOT}/data"
      }
    }
  }
}

---
name: query
description: Execute database queries and explain results. Use when user needs to query the database or analyze data.
---

Use the db-tools MCP server to execute database queries.
Always explain the query logic and result interpretation in plain language.
Warn the user before executing any write operations (INSERT, UPDATE, DELETE).

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

{
  "name": "go-lsp",
  "version": "1.0.0",
  "description": "Go language server for real-time diagnostics and code intelligence",
  "lspServers": "./.lsp.json"
}

claude --debug --plugin-dir ./my-plugin

{
  "name": "my-plugin",
  "version": "2.1.0"
}